Kimi Messages

1 つの BeatAPI キーで、Anthropic Messages 形式から Kimi K3 を呼び出せます。

• 1 つのエンドポイント POST /v1/messages で Kimi K3 を呼び出せます。
• ストリーミングとツール使用に対応し、100 万トークンのコンテキストウィンドウを備えています。
• Anthropic SDK で使えます。base URL を変え、BeatAPI のキーを使うだけです。すべてのリクエストに anthropic-version ヘッダーを付けてください。
• tool_choice はモデルに渡されますが、すべてのモデルが従うわけではありません。thinking は効きません。下のパラメーター一覧を参照してください。

このエンドポイントをテスト画面で開きます。BeatAPI の API キーを入力して送信してください。実際に呼び出され、ご自身の残高から課金されます。

モデル

次の ID を model として送ります。

• 価格は基本ティアで、割引適用後です。長文コンテキストのティア、キャッシュ入力価格、キャッシュ書き込み価格はこの表に含まれません。価格表を参照してください。
• — はカタログが数値を公開していないことを示します。

クイックスタート

サーバーに @anthropic-ai/sdk または anthropic パッケージをインストールし、キーは BEATAPI_API_KEY に置いてください。ブラウザのコードには書かないでください。SDK は anthropic-version ヘッダーを自動で付けます。以下はリクエスト例であり、実際のモデル出力の記録ではありません。

回答は content の text ブロックから読み取り、続けて 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 の形式です。以下のフィールドは有効です。最後の 2 つは SDK から送れますが、結果は変わりません。このページに載っていないフィールドは、効果があるとは限りません。

レスポンス

非ストリーミングの呼び出しは JSON オブジェクトを 1 つ返します。以下は省略した例です。

{
  "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_delta イベントで thinking ブロックを送ります。ツールの引数は input_json_delta イベントで届きます。
• モデルを呼び出す前に失敗した場合は、ストリームイベントではなく、HTTP ステータス付きの通常の JSON エラーが返ります。
• 明示的なタイムアウトを設定し、ストリーミングの再接続は安全に行ってください。

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、request id は message の末尾にあります。詳しくはエラーを参照してください。

全エラーコード表と再試行ポリシーはエラーを参照してください。

注意事項

• Kimi は Chat Completions と OpenAI Responses でも呼び出せます。
• Kimi K3 は既定で思考してから回答します。推論トークンは出力トークンに数えられ、出力として課金されます。
• すべてのリクエストに anthropic-version を付けてください。thinking には頼らないでください。効果がありません。
• API キーは信頼できるサーバーにだけ置き、レスポンスのリクエスト ID を記録し、再試行は 429、500、503 に限ってください。