GPT Responses

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

• Для моделей GPT используйте POST /v1/responses. Для переключения меняйте model.
• Рекомендуемый формат для новых интеграций с рассуждениями и вызовами инструментов.
• Текст и изображения на входе, текст на выходе, потоковая передача, вызовы функций, структурированный вывод и настраиваемая интенсивность рассуждений.
• Совместимо с OpenAI SDK: измените базовый URL и используйте ключ BeatAPI. Для существующей интеграции Chat Completions см. Chat Completions.

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

Модели

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

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

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

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

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

У моделей GPT-5.6 интенсивность рассуждений принимает none, low, medium, high, xhigh и max; у gpt-6.1-sol — от low до max. Начните с medium как сбалансированного варианта, затем на своих задачах сравните уровень выше и ниже. Сам по себе HTTP 200 не означает, что ответ решает вашу задачу: проверяйте результат в приложении.

curl --request POST \
  --url https://direct.beatapi.io/v1/responses \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-6.1-sol",
  "input": "Design a resilient webhook retry strategy for a payments API.",
  "reasoning": {
    "effort": "medium"
  }
}'

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

POST https://direct.beatapi.io/v1/responses

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

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

{ "effort": "medium" }

Ответ

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

{
  "id": "resp_example",
  "object": "response",
  "model": "gpt-6.1-sol",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Retry with exponential backoff and jitter, and make every handler idempotent."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 19,
    "output_tokens": 16,
    "total_tokens": 35
  }
}

Поля ответа

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

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

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

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"Retry"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":" with backoff"}
event: response.completed
data: {"type":"response.completed","response":{"id":"resp_example","status":"completed"}}

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

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

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

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

Примечания

• Модели Claude не обслуживаются через /v1/responses (400 bad_request); используйте Anthropic Messages.
• При входе свыше 272K токенов gpt-6.1-terra, gpt-6.1-sol и gpt-6-astra применяют повышенный тариф ко всему запросу. Перед оценкой стоимости задач с длинным контекстом проверьте таблицу цен.
• Храните ключи на доверенных серверах, записывайте ID запроса из ответа и повторяйте запросы только при ошибках 429, 500 и 503.