Kimi Messages

Вызывайте Kimi K3.1 Pro и Kimi K3 в формате Anthropic Messages с ключом BeatAPI.

• Все актуальные модели Kimi доступны через POST /v1/messages. Для переключения меняйте model.
• Потоковая передача, вызовы инструментов и контекстное окно на 1M токенов.
• Совместимо с Anthropic SDK: измените базовый URL и используйте ключ BeatAPI. Передавайте заголовок anthropic-version с каждым запросом.
• tool_choice передаётся модели, но не каждая модель его соблюдает; thinking не влияет на результат. См. описание параметров ниже.

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

Модели

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

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

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

Установите пакет @anthropic-ai/sdk или anthropic на сервере и сохраните ключ в BEATAPI_API_KEY. Не помещайте ключ в код браузерного приложения. SDK сам отправляет заголовок anthropic-version. Ниже показаны примеры запросов, а не записанные ответы модели.

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

curl --request POST \
  --url https://direct.beatapi.io/v1/messages \
  --header "x-api-key: $BEATAPI_API_KEY" \
  --header 'anthropic-version: 2023-06-01' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kimi-k3",
  "max_tokens": 2000,
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}'

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

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

Передавайте заголовок anthropic-version (например, 2023-06-01) с каждым запросом; Anthropic SDK добавляет его автоматически. Для авторизации подходят и x-api-key, и Authorization: Bearer <BEATAPI_API_KEY>.

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

Запрос имеет формат Anthropic Messages. Ниже описано действие каждого поля; thinking принимается, но не меняет результат. Действие полей, не описанных на этой странице, не гарантируется.

Ответ

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

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "kimi-k3",
  "content": [
    {
      "type": "text",
      "text": "Retry with exponential backoff and jitter, and make every handler idempotent."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 19,
    "output_tokens": 16
  }
}

Поля ответа

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

Установите "stream": true. Поток начинается с message_start и заканчивается message_stop. Блоки между ними передаются событиями content_block_start, content_block_delta и content_block_stop; событие message_delta содержит stop_reason.

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

event: message_start
data: {"type":"message_start","message":{"id":"msg_example","type":"message","role":"assistant","content":[],"usage":{"input_tokens":19,"output_tokens":1}}}
event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Retry"}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":" with backoff"}}
event: content_block_stop
data: {"type":"content_block_stop","index":0}
event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":16}}
event: message_stop
data: {"type":"message_stop"}

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

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

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

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

Примечания

• Kimi также доступна через Chat Completions и OpenAI Responses.
• Kimi K3 рассуждает по умолчанию, а Kimi K3.1 Pro — всегда: её рассуждения нельзя отключить. Токены рассуждений входят в выходные токены и оплачиваются как вывод.
• Передавайте anthropic-version с каждым запросом. Не полагайтесь на thinking: этот параметр не влияет на результат.
• Храните ключи на доверенных серверах, записывайте ID запроса из ответа и повторяйте запросы только при ошибках 429, 500 и 503.