Документация OpenAI-совместимого AI API

Подключайте несколько моделей ИИ через один шлюз с привычными SDK, Base URL и API Key.

Открыть руководство

Справочник API

После первого успешного запроса используйте этот раздел для просмотра параметров запросов и форматов ответов конкретных провайдеров.

30 API-эндпоинты моделей
POSTOpenAIOpenAI/chat/completions

Создание Chat Completion

Создает ответ модели по истории диалога с поддержкой потоковой передачи, инструментов и учета использования.

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

Используйте API-ключ с Authorization: Bearer sk-xxxx.

Authorization: Bearer sk-xxxx
Тип содержимого
application/json
Примеры моделей
gpt-4o, gpt-4.1, gpt-5, o3, o4-mini

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

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}

Пример ответа

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "created": 0,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello!"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 3,
    "total_tokens": 11
  }
}

Пример curl

curl -X POST 'https://costrouter.ai/v1/chat/completions' \
  -H 'Authorization: Bearer sk-xxxx'
  -H 'Content-Type: application/json'
  -d '{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}'
Параметры
НазваниеТипОбязательноОписание
modelstringДаID модели. CostRouter использует его для поиска совместимых и доступных маршрутов запроса.
messagesarray<object>ДаМассив сообщений диалога, обычно с ролями system, user, assistant или tool.
temperaturenumberНетТемпература выборки. Чем выше значение, тем менее предсказуем результат.
top_pnumberНетПараметр nucleus sampling; обычно настраивается вместо temperature.
streambooleanНетВозвращать ли ответ в потоковом режиме.
max_tokensintegerНетМаксимальное число выходных токенов.
toolsarray<object>НетОпределения инструментов или функций. Поддержка зависит от модели провайдера.
response_formatobjectНетФормат структурированного ответа. Поддержка зависит от модели провайдера.
Пример ответа
НазваниеТипОбязательноОписание
idstringНетID ответа, задачи или ресурса.
objectstringНетТип объекта ответа.
createdintegerНетВремя создания.
modelstringНет-
choicesarray<object>НетВарианты ответа модели.
usageobjectНетСтатистика использования токенов.

Частые ошибки и решения

Ошибки первого запроса чаще всего связаны с аутентификацией, ID модели, балансом или лимитом расходов либо с неверными параметрами запроса.

401

Ошибка аутентификации

Убедитесь, что заголовок Authorization содержит Bearer и ваш API Key CostRouter.

403

Проблема с доступом или балансом

Проверьте статус ключа, баланс, доступ к модели и настройки биллинга.

429

Ограничение частоты

Снизьте параллельность, повторите с backoff или проверьте лимиты аккаунта.

5xx

Ошибка маршрута или провайдера

Повторите попытку позже и проверьте статус запроса и маршрут модели в журналах использования.

Copyright 2026 CostRouter. Все права защищены.

CostRouter запрещен для пользователей, находящихся на материковой части Китая. При обнаружении использования из материкового Китая CostRouter может приостановить или закрыть аккаунт, а оплаченные суммы или оставшийся баланс не возвращаются.

Связаться с нами

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

Связаться
Документация OpenAI-совместимого API | CostRouter