API Hop

Документация

Документация API Hop

Каталог моделей

Получите список моделей, доступных текущему ключу API, и их публичных протоколов.

GEThttps://api.apihop.ai/v1/models

GET https://api.apihop.ai/v1/models возвращает модели, доступные текущему ключу API. Доступность может меняться из-за конфигурации моделей, состояния сервиса и разрешений ключа; окончательным источником является текущий ответ API.

Claude Sonnet 4.6 (claude-sonnet-4-6) поддерживается вышестоящим поставщиком, но сейчас не опубликован на RequestBeam. Это не действующая модель интеграции по умолчанию. Перед вызовом любой модели подтвердите доступ своим ответом GET https://api.apihop.ai/v1/models.

text
GET https://api.apihop.ai/v1/models

Аутентификация

Все запросы требуют токена Bearer.

http
Authorization: Bearer YOUR_API_KEY

Пример запроса

bash
curl --request GET \
  --url https://api.apihop.ai/v1/models \
  --header 'Authorization: Bearer YOUR_API_KEY'

Ответ

uidstring

Публичный идентификатор модели. Для API, принимающих model, используйте это значение в поле model тела запроса.

namestring

Отображаемое имя.

versionstring | null

Поле версии. Текущие записи обычно возвращают null.

typestring

Тип модели, сейчас преимущественно text, image или video.

pricingobject | null

Текущая цена модели на платформе. Актуальные значения смотрите в живом API или консоли.

Пример успешного ответа

json
{
  "success": true,
  "data": [
    {
      "uid": "gpt-5.6-sol",
      "name": "ChatGPT-5.6 Sol",
      "version": null,
      "type": "text",
      "pricing": {
        "unit": "credits",
        "tokenTierBasis": "input_tokens",
        "tiers": []
      }
    },
    {
      "uid": "seedance-2.5",
      "name": "Seedance 2.5",
      "version": null,
      "type": "video",
      "pricing": {
        "unit": "credits",
        "tiers": []
      }
    }
  ],
  "requestId": "req_..."
}

Текущие текстовые модели

В таблице ниже перечислены текстовые модели, описанные сейчас в документации. Для каждого запроса используйте модели из собственного ответа GET https://api.apihop.ai/v1/models.

Семейство моделейID моделиChat CompletionsResponsesClaude Messages
OpenAIgpt-5.4ДаДа-
OpenAIgpt-5.5ДаДа-
OpenAIgpt-5.6-solДаДа-
OpenAIgpt-5.6-terraДаДа-
OpenAIgpt-6-astraДаДа-
Anthropicclaude-fable-5Да-Да
Anthropicclaude-fable-5-1Да-Да
Anthropicclaude-opus-4-6Да-Да
Anthropicclaude-opus-4-7Да-Да
Anthropicclaude-opus-4-8Да-Да
Anthropicclaude-opus-5Да-Да
Anthropicclaude-opus-5-5Да-Да
Anthropicclaude-sonnet-5Да-Да
Anthropicclaude-sonnet-5-5Да-Да
DeepSeekdeepseek-v4-flashДа--
DeepSeekdeepseek-v4-proДа--
DeepSeekdeepseek-v4.1-flashПосле развёртывания и включения--
Geminigemini-3.6-flashДа--
Geminigemini-3.7-flashДа--
Geminigemini-3.8-flashДа--
Geminigemini-3.5-flash-liteДа--
Geminigemini-4-argonДа (после включения)--
Kimikimi-k3Да--
MiniMaxminimax-m3Да--

Бюджет вывода Claude включает размышления и итоговый текст. Малое значение max_tokens, например 128, может исчерпаться до появления итогового текста. Используйте положительный целочисленный бюджет с запасом для обоих, как описано в разделе Сообщения Claude.

Руководства по семействам моделей

  • Модели DeepSeek: deepseek-v4-flash, deepseek-v4-pro, deepseek-v4.1-flash (отдельный ID, доступный только после развёртывания и включения; проверьте GET https://api.apihop.ai/v1/models)
  • Модели Gemini: gemini-3.6-flash, gemini-3.7-flash, gemini-3.8-flash, gemini-3.5-flash-lite, gemini-4-argon (после развёртывания и включения)
  • Модель Kimi: kimi-k3
  • Модель MiniMax: minimax-m3

Эти руководства описывают выбор моделей, примеры запросов, бюджет вывода и текущие границы публичных протоколов. Доступность определяется текущим ответом этого эндпоинта.

Текущие модели изображений и видео

Семейство моделейID моделиТипПубличный эндпоинт
OpenAIgpt-image-2ИзображениеPOST https://api.apihop.ai/openai/v1/images/generations
OpenAIgpt-image-2.5-flareИзображениеPOST https://api.apihop.ai/openai/v1/images/generations
OpenAIgpt-image-2.5-sunburstИзображениеPOST https://api.apihop.ai/openai/v1/images/generations
BytePlusseedance-2.0ВидеоPOST https://api.apihop.ai/v1/video/seedance
BytePlusseedance-2.5ВидеоPOST https://api.apihop.ai/v1/video/seedance

Другая запись API

twitterapi представляет API данных Twitter, а не модель чата. Используйте эндпоинты /v1/twitter/* вместо передачи twitterapi в Chat Completions.

Правила ID моделей

  • API Chat Completions, Responses, Claude Messages, изображений и видео Seedance используют model.
  • Канонические ID моделей Seedance — seedance-2.0 и seedance-2.5. Эндпоинт Seedance 2.0 также принимает прежний псевдоним seedance-2-0, но новые запросы и поиск в каталоге должны использовать канонический ID с точкой.
  • Используйте только ID моделей из GET https://api.apihop.ai/v1/models.
  • Недоступные модели не появляются в /v1/models и не должны использоваться для новых вызовов.
  • Ключ API с ограничениями моделей может получить только часть документированных моделей.

Ответ с ошибкой

Полный справочник кодов, различия протоколов и этапы диагностики приведены в разделе Коды ошибок и устранение неполадок.

json
{
  "success": false,
  "error": {
    "code": 20000,
    "message": "Invalid or missing API key"
  },
  "requestId": "req_..."
}