Hunyuan Chat Completions

1 つの BeatAPI キーで、同じ OpenAI Chat Completions エンドポイントから Hunyuan の HY4 Preview と HY3 を呼び出せます。

• 1 つのエンドポイント POST /v1/chat/completions で、現行の Hunyuan モデルすべてを呼び出せます。model を変えるだけで切り替わります。
• ストリーミングと関数呼び出しに対応します。hy3 には毎日ピーク料金の時間帯があります。下の時間帯別の料金を参照してください。
• OpenAI SDK で使えます。base URL を変え、BeatAPI のキーを使うだけです。
• 同じモデルは OpenAI Responses と Anthropic Messages でも呼び出せます。

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

モデル

次の ID のいずれかを model として送ります。それぞれ別のモデルで、互いのエイリアスではありません。

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

クイックスタート

サーバーに 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 には毎日のピーク時間帯があります。北京時間（GMT+8）の毎日 08:00〜24:00 は、すべての料金が 1.6 倍になります。週末も同じで、入力、キャッシュ入力、出力のいずれも対象です。00:00〜08:00 は非ピーク料金で、上のモデル表と料金表に表示されている価格です。

レスポンス

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

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

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

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

注意事項

• Hunyuan モデルは OpenAI Responses と Anthropic Messages でも呼び出せます。
• API キーは信頼できるサーバーにだけ置き、レスポンスのリクエスト ID を記録し、再試行は 429、500、503 に限ってください。