DeepSeek Chat Completions

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

• Текущие модели DeepSeek используют единый эндпоинт POST /v1/chat/completions. Для переключения измените model.
• Модели в таблице поддерживают текстовый ввод и вывод, потоковую передачу, вызовы функций и контекст в миллион токенов.
• Используйте OpenAI SDK, заменив базовый URL и указав ключ BeatAPI.
• Те же модели доступны через OpenAI Responses и Anthropic Messages.

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

Модели

Передайте один из этих ID в model. Это отдельные модели, а не псевдонимы друг друга.

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

Старые 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": "deepseek-v4.1-flash",
  "max_tokens": 2000,
  "messages": [
    {
      "role": "user",
      "content": "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/chat/completions \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "deepseek-v4.1-flash-free",
  "messages": [
    {
      "role": "user",
      "content": "Say hello in one sentence."
    }
  ]
}'

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

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

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

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

Модели с усиленным кэшированием (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": "chatcmpl-example",
  "object": "chat.completion",
  "created": 1791993600,
  "model": "deepseek-v4.1-flash",
  "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. Ответ поступает событиями chat.completion.chunk и завершается строкой data: [DONE].

• Тип содержимого — text/event-stream, без потоковой передачи — application/json.
• Текст поступает в choices[0].delta.content. Модели рассуждений сначала передают рассуждения в delta.reasoning_content.
• Ошибки до вызова модели возвращаются как обычные 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. См. ошибки.

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

Примечания

• Модели DeepSeek также отвечают через OpenAI Responses и Anthropic Messages.
• Эти модели рассуждают перед ответом. Токены рассуждений входят в выходные токены и оплачиваются по тарифу вывода. Учитывайте в max_tokens и рассуждения, и ответ.
• Поддерживается только текстовый ввод. В этой интеграции модели не принимают изображения.
• Храните ключ только на доверенном сервере и записывайте ID запроса из ответа. Повторяйте запросы только при ошибках 429, 500 и 503.