Gemini Responses

Вызывайте Gemini 4 Argon, Gemini 3.8 Flash и Gemini 3.1 Pro через OpenAI Responses API с ключом BeatAPI.

• Все актуальные модели Gemini доступны через POST /v1/responses. Для переключения меняйте model.
• Потоковая передача и вызовы функций. gemini-4-argon также понимает изображения и длинные видео.
• Совместимо с OpenAI SDK: измените базовый URL и используйте ключ BeatAPI. Для существующей интеграции Chat Completions см. Chat Completions.
• Состояние диалога не сохраняется на сервере: при каждом обращении передавайте всю историю в input.

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

Модели

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

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

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

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

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

Прочитайте ответ в output_text (или в частях output типа output_text), затем проверьте status и usage. Сам по себе HTTP 200 не означает, что ответ решает вашу задачу: проверяйте результат в приложении. Текстовые запросы возвращают ответ напрямую; опрашивать /v1/tasks для них не нужно.

curl --request POST \
  --url https://direct.beatapi.io/v1/responses \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gemini-3.8-flash",
  "max_output_tokens": 2000,
  "input": "Design a resilient webhook retry strategy for a payments API."
}'

Бесплатные версии

У этих моделей есть бесплатные версии. Они вызываются через тот же эндпоинт с отдельным ID, без платы за токены и с отдельными минутными лимитами. До первого пополнения баланса каждому аккаунту доступен один успешный запрос в минуту, после — до десяти. Стабильность не гарантируется: доступ может быть ограничен или прекращён в любой момент. См. бесплатные модели.

gemini-3.8-flash-free

curl --request POST \
  --url https://direct.beatapi.io/v1/responses \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gemini-3.8-flash-free",
  "input": "Say hello in one sentence."
}'

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

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

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

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

Ответ

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

{
  "id": "resp_example",
  "object": "response",
  "model": "gemini-3.8-flash",
  "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. Поток начинается с response.created, передаёт текст событиями response.output_text.delta и заканчивается response.completed.

• Тип ответа — text/event-stream; без потоковой передачи — application/json.
• Вызов функции поступает отдельным выходным элементом, а его аргументы передаются событиями response.function_call_arguments.delta.
• Ошибка до вызова модели возвращается обычным JSON-ответом с HTTP-кодом, а не событием потока.
• Явно задайте тайм-ауты и предусмотрите безопасное восстановление соединения при потоковой передаче.

event: response.created
data: {"type":"response.created","response":{"id":"resp_example","status":"in_progress"}}
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. См. ошибки.

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

Примечания

• Модели Gemini также доступны через Chat Completions, Anthropic Messages и нативный API Gemini.
• Модели Gemini рассуждают по умолчанию, а токены рассуждений оплачиваются как выходные. Оставляйте в max_output_tokens запас и для рассуждений, и для ответа.
• Кэшированный вход оплачивается дешевле: одна двадцатая цены входа у gemini-4-argon, одна десятая — у gemini-3.8-flash и gemini-3.1-pro-preview. Отдельной платы за хранение кэша нет. Проверяйте число кэшированных входных токенов в usage, а не предполагайте попадание в кэш. Если промпт gemini-3.1-pro-preview превышает 200 000 токенов, повышенный тариф применяется ко всему запросу; см. таблицу цен.
• Храните ключи на доверенных серверах, записывайте ID запроса из ответа и повторяйте запросы только при ошибках 429, 500 и 503.