GPT Chat Completions

Вызывайте GPT-6.1 Terra, GPT-6.1 Sol, GPT-6 Astra, GPT-6 Sol и GPT-6 Luna через единый метод OpenAI Chat Completions с ключом BeatAPI.

• Все актуальные модели GPT доступны через POST /v1/chat/completions. Для переключения меняйте model.
• Текст и изображения на входе, текст на выходе, потоковая передача, структурированный вывод и настраиваемая интенсивность рассуждений. Для вызовов инструментов GPT-6.1 Terra и Sol нужен Responses.
• Совместимо с OpenAI SDK: измените базовый URL и используйте ключ BeatAPI.
• Для новых интеграций с рассуждениями и вызовами инструментов рекомендуется формат OpenAI Responses.

Открывает эндпоинт в API Explorer. Если ввести ключ BeatAPI и отправить запрос, будет выполнен реальный вызов с оплатой из вашего баланса.

Модели

Передайте один из этих ID в model. Каждый ID обозначает отдельную модель; не считайте их псевдонимами друг друга.

• Указаны базовые цены со скидкой. Не включены тарифы для длинного контекста, кэшированного ввода и записи в кэш. См. страницу цен.
• — означает, что каталог не публикует это значение.

Старые ID этого семейства остаются доступны. См. старые модели.

Быстрый старт

Установите пакет openai на сервере и сохраните ключ в BEATAPI_API_KEY. Не помещайте ключ в код браузерного приложения. Ниже показаны примеры запросов, а не записанные ответы модели.

Прочитайте ответ в choices[0].message.content, затем проверьте finish_reason и usage. Сам по себе HTTP 200 не означает, что ответ решает вашу задачу: проверяйте результат в приложении. Текстовые запросы возвращают ответ напрямую; опрашивать /v1/tasks для них не нужно.

curl --request POST \
  --url https://direct.beatapi.io/v1/chat/completions \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-6-luna",
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}'

Эндпоинт и аутентификация

POST https://direct.beatapi.io/v1/chat/completions

Параметры запроса

Поддерживаются стандартные поля OpenAI Chat Completions. Совместимость формата запроса не означает поддержку всех параметров конкретного провайдера и инструментов. Проверьте возможности, от которых зависит ваше приложение.

Ответ

Без потоковой передачи запрос возвращает один JSON-объект. Ниже приведён сокращённый пример.

{
  "id": "chatcmpl-example",
  "object": "chat.completion",
  "created": 1791993600,
  "model": "gpt-6-luna",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Retry with exponential backoff and jitter, and make every handler idempotent."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 19,
    "completion_tokens": 16,
    "total_tokens": 35
  }
}

Поля ответа

Потоковая передача

Установите "stream": true. BeatAPI передаёт поток SSE без преобразования, поэтому объекты событий остаются совместимыми с OpenAI SDK.

• Тип ответа — text/event-stream; без потоковой передачи — application/json.
• Ошибка до вызова модели возвращается обычным JSON-ответом с HTTP-кодом, а не событием потока.
• Явно задайте тайм-ауты и предусмотрите безопасное восстановление соединения при потоковой передаче.

data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":"Retry"},"finish_reason":null}]}
data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":" with backoff"},"finish_reason":null}]}
data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}
data: [DONE]

Устранение ошибок

Обзор HTTP-ошибок

Ошибки аутентификации, маршрутизации, ограничения частоты и неизвестной модели возвращаются до вызова модели в формате BeatAPI с полями error.code, error.message, retryable и request_id. Остальные ошибки сохраняют формат OpenAI SDK {"error": {"message", "type", "code"}}. Код находится в error.code, ID запроса — в конце message. См. ошибки.

Все коды и правила повторных запросов: ошибки.

Примечания

• Модели GPT также доступны через OpenAI Responses.
• При входе свыше 272K токенов gpt-6.1-terra, gpt-6.1-sol и gpt-6-astra применяют повышенный тариф ко всему запросу. Перед оценкой стоимости задач с длинным контекстом проверьте таблицу цен.
• Храните ключи на доверенных серверах, записывайте ID запроса из ответа и повторяйте запросы только при ошибках 429, 500 и 503.