Выбор моделей

Для кода выбирайте model ID через GET /v1/models и держите значение model настраиваемым. Используйте /models для просмотра живого каталога, а /pricing — когда вопрос упирается в биллинг, а не в выбор модели.

Выберите актуальный model ID

Сначала получите актуальный ID модели из GET /v1/models:

curl https://api.gonkagate.com/v1/models \
  -H "Authorization: Bearer gp-your-api-key"

{
  "data": [
    {
      "id": "qwen/qwen3-235b-a22b-instruct-2507-fp8"
    }
  ]
}

Возьмите одно значение data[].id и используйте его как model в следующем запросе.

Используйте ID в запросе

curl https://api.gonkagate.com/v1/chat/completions \
  -H "Authorization: Bearer gp-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen3-235b-a22b-instruct-2507-fp8",
    "messages": [
      { "role": "user", "content": "Сделай краткое резюме документа." }
    ]
  }'

Используйте любой актуальный data[].id из GET /v1/models. Держите model настраиваемым, чтобы обновлять ID без правок в коде приложения.

Что проверить перед выбором модели по умолчанию

• API-ключ, который может вызвать GET /v1/models
• Один или два реальных промпта из вашей нагрузки
• Конфиг или переменная окружения для значения model
• Понимание, зависит ли ваш сценарий от tools, vision, structured outputs или streaming

Частые проблемы с model ID

• 404 model_not_found означает, что ID больше не подходит для того запроса, который вы отправили. Обновите его через GET /v1/models.
• GET /v1/models может временно вернуть 503, если каталог ещё не готов. Повторите запрос с ограниченным backoff. Не скрейпьте /models и не угадывайте ID вручную.
• :online не является каноническим model ID из GET /v1/models. Сначала возьмите базовый data[].id. :online добавляйте только как request-time shorthand для web search в конкретном запросе. Для новых интеграций GonkaGate предпочтительнее plugins: [{ "id": "web" }].
• /models — это человекочитаемый каталог. Он удобен для просмотра, но для кода источником истины остаётся GET /v1/models.
• Поля цен в GET /v1/models помогают сравнить варианты, но правила биллинга и трактовка комиссии живут на /pricing.
• Если ваш сценарий зависит от tools, vision или structured outputs, проверьте эту возможность на выбранной модели до выкладки.
• Модель по умолчанию не является постоянным контрактом. Перепроверяйте её перед релизами, миграциями и изменениями fallback-логики.

См. также

• Быстрый старт: первый запрос, чтобы отправить рабочий запрос с выбранным здесь ID модели.
• GET /v1/models — Получить список моделей для точной схемы ответа.
• Живой каталог моделей, если хотите сначала посмотреть текущие модели перед копированием ID.
• Pricing, если выбор модели у вас упирается не в API-совместимость, а в правила биллинга.