Text API

BeatAPI は、公開テキストモデルを同期型のトークン課金 API として提供します。1 つの BeatAPI キーを使い、アプリケーションに合う通信形式を選んでください。

形式	エンドポイント	適した用途
OpenAI Responses	`POST /v1/responses`	推論、ツール、構造化出力、新規連携
OpenAI Chat Completions	`POST /v1/chat/completions`	既存の OpenAI チャット連携
Anthropic Messages	`POST /v1/messages`	既存の Messages SDK 連携
Gemini 互換	`POST /v1beta/models/{model}:{action}`	既存の Gemini SDK 連携

GET /v1/models で、利用環境で有効なモデルを取得できます。テキスト呼び出しは JSON を直接返すか、Server-Sent Events でストリーミングします。非同期の BeatAPI Task は作成しません。

GPT-6.1 Sol

1.05M コンテキストのコーディングとエージェントワークフロー。Responses API の例を掲載しています。

GPT-5.6

Sol、Terra、Luna を選び、互換形式のリクエストを利用します。

GPT-6 Astra

入力トークンが 272K を超えると単価が上がる GPT-6 Astra。

Claude Sonnet 5.5

1M コンテキスト、最大 128K 出力。コンテキスト全体で標準のトークン単価を適用します。

Claude Fable 5.1

claude-fable-5-1 を 4 つの互換エンドポイントで利用します。Claude Haiku 5.5 と 2 段階の料金も説明しています。

Gemini

同じ 4 つのエンドポイントで Flash と Pro を利用します。

Grok

同じ 4 つのエンドポイントで Grok 4.5 と 4.6 を利用します。

DeepSeek

V4 Pro、V4.1 Flash、V4 Flash は終日同じ単価です。2 つの高キャッシュ（HC）モデルは平日のピーク時間帯に 2 倍になります。

Kimi

K3。1M トークンのコンテキストを単一の料金で利用できます。

GLM

GLM 5.3 と低価格の 5.3 Flash。

MiniMax

非常に長いコンテキストに対応する M3。

Qwen

Qwen 3.8 Max と 3.8 Flash。

MiMo

MiMo V2.6 Flash と V2.5。

Hunyuan

HY3 と HY4。HY3 には毎日の独自のピーク時間帯があります。

長期利用する BeatAPI API キーは信頼できるサーバーに保存してください。認証ヘッダーの違いは SDK 互換性のためであり、すべて同じ BeatAPI アカウントと米ドル残高を識別します。

エラー

テキストエンドポイントは SDK 本来のエラー形式を維持するため、OpenAI と Anthropic の SDK は通常の例外を送出します。/v1/chat/completions、/v1/responses、GET /v1/models は {"error":{"message","type","code"}} 形式です。コードは error.code、error.type は beatapi_error で、メッセージ末尾にリクエスト ID が付きます。/v1/messages は {"type":"error","error":{"type","message"}} 形式で、コードは error.type に入ります。retryable と request_id フィールドはありません。ステータス、コード、英語のメッセージは、ほかの BeatAPI エンドポイントと共通です。

HTTP	コード	対処
`400`	`bad_request`	指摘された項目を修正。変更せず再送しない
`400`	`content_policy_violation`	審査で拒否された入力を変更
`401`	`missing_api_key` / `invalid_api_key`	キーを送信、または不正、期限切れ、無効、上限到達のキーを交換
`402`	`insufficient_credits`	残高不足。チャージする
`403`	`forbidden` / `access_denied`	`forbidden` は無料クレジットのみの場合など、キーやアカウントがモデルを利用できない。`access_denied` は IP 許可リスト対象外、またはキーのモデルグループ対象外
`404`	`not_found`	不明なモデル、または料金未設定のモデル。`GET /v1/models` で有効なモデルを取得
`413`	`read_request_body_failed`	本文が大きすぎる。小さくする
`429`	`rate_limit_exceeded`	上限到達、またはモデルの処理容量超過（“This model is receiving too many requests”）。`Retry-After` 秒待って再試行
`500`	`internal_error`	バックオフして 1 回再試行
`503`	`processing_unavailable` / `processing_timeout` / `processing_failed`	バックオフして再試行、または別モデルを使う。課金なし

再試行は 429、500、503 に限定してください。BeatAPI は 502 と 504 を返しません。コード一覧と再試行方針はエラーに掲載しています。