DeepSeek Responses

Вызывайте DeepSeek V4.1 Flash, V4 Pro и их версии с повышенным кэшированием через OpenAI Responses API с ключом BeatAPI.

• Все актуальные модели DeepSeek доступны через POST /v1/responses. Для переключения меняйте model.
• Текст на входе и выходе, потоковая передача, вызовы функций и контекст на 1M токенов у моделей из таблицы ниже.
• Совместимо с 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": "deepseek-v4.1-flash",
  "max_output_tokens": 2000,
  "input": "Design a resilient webhook retry strategy for a payments API."
}'

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

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

deepseek-v4.1-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": "deepseek-v4.1-flash-free",
  "input": "Say hello in one sentence."
}'

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

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

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

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

Модели с повышенным кэшированием (HC)

deepseek-v4-pro-0813-hc и deepseek-v4.1-flash-hc — те же две модели, но с повышенным кэшированием. Если запросы используют общий префикс, например длинный системный промпт, список инструментов или постепенно растущую историю диалога, повторяющаяся часть оплачивается по тарифу кэшированного входа. В обычных версиях цена за токен ниже, но попадание в кэш не гарантируется.

Выбирайте HC, если большую часть каждого промпта составляет многократно отправляемый префикс. Если повторений мало, обычная модель дешевле. Формат запроса тот же: меняется только ID модели. Проверяйте число кэшированных входных токенов в usage, а не предполагайте попадание в кэш.

Тарифы в зависимости от времени суток

Обычные модели deepseek-v4.1-flash и deepseek-v4-pro-0813 оплачиваются по одному тарифу в любое время суток и день недели.

У двух моделей HC есть пиковые периоды. Все тарифы удваиваются по будням в периоды 09:00–12:00 и 14:00–18:00 по пекинскому времени (GMT+8): на вход, кэшированный вход и выход. В остальное время, а также весь день в субботу и воскресенье действуют непиковые тарифы, указанные в таблице моделей выше и в таблице цен.

Ответ

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

{
  "id": "resp_example",
  "object": "response",
  "model": "deepseek-v4.1-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. См. ошибки.

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

Примечания

• Модели DeepSeek также доступны через Chat Completions и Anthropic Messages.
• Эти модели рассуждают перед ответом. Токены рассуждений входят в выходные токены и оплачиваются как вывод, поэтому оставляйте в max_output_tokens запас и для рассуждений, и для ответа.
• Вход только текстовый: эти модели не принимают изображения.
• Храните ключи на доверенных серверах, записывайте ID запроса из ответа и повторяйте запросы только при ошибках 429, 500 и 503.