Hunyuan Chat Completions

Вызывайте Hunyuan HY4 Preview и HY3 через единый метод OpenAI Chat Completions с ключом BeatAPI.

• Все актуальные модели Hunyuan доступны через POST /v1/chat/completions. Для переключения меняйте model.
• Потоковая передача и вызовы функций. У hy3 есть ежедневный период повышенных тарифов; см. раздел о тарифах в зависимости от времени суток ниже.
• Совместимо с 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": "hy4-preview",
  "max_tokens": 2000,
  "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. Совместимость формата запроса не означает, что каждая модель поддерживает все параметры. Проверяйте параметры, от которых зависит ваше приложение.

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

hy4-preview оплачивается по одному тарифу в любое время суток и день недели.

У hy3 есть ежедневный пиковый период. Все тарифы умножаются на 1.6x с 08:00 до 24:00 по пекинскому времени (GMT+8), каждый день недели: на вход, кэшированный вход и выход. С 00:00 до 08:00 действует непиковый тариф из таблицы моделей выше и таблицы цен.

Ответ

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

{
  "id": "chatcmpl-example",
  "object": "chat.completion",
  "created": 1791993600,
  "model": "hy4-preview",
  "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. См. ошибки.

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

Примечания

• Модели Hunyuan также доступны через OpenAI Responses и Anthropic Messages.
• Храните ключ только на доверенном сервере и записывайте ID запроса из ответа. Повторяйте запросы только при ошибках 429, 500 и 503.