本文へスキップ

チャット補完を作成

OpenAI 互換の Chat Completions:GPT、Gemini、GLM、Qwen、DeepSeek、Grok、Claude などのチャットモデルが共通で使うエンドポイントです。

POST/v1/chat/completions

会話メッセージの配列を受け取り、モデルの応答を返します。OpenAI SDK は Base URL を https://api.hop-base.com/v1 に変え、対応するグループのキーに差し替えるだけで使えます。

下表には、ゲートウェイが検査・書き換え・拒否するフィールドと、各モデルページに明記された値のみを載せています。記載のない OpenAI フィールドはそのまま転送され、値の範囲はモデルの公式仕様に従います。リクエストボディ全体の上限は 60 MB で、超えると 413 を返します。

Claude モデルもこのエンドポイントを利用できます(Claude グループのキーを使用)。課金は /v1/messages とまったく同じです。max_tokens を省略した場合の既定値は、非ストリーミングで 16000、ストリーミングで 64000 です(モデルの出力上限は超えません)。Claude モデルは temperature / top_p を使用しません。指定しても無視され、エラーにはなりません。n が 1 より大きい場合、旧式の functions / function_call、音声入力は 400 を返します。複数ターンのツール呼び出しの間で思考ブロックは引き継がれないため、クライアントが Anthropic プロトコルに対応している場合は /v1/messages を優先してください。/v1/responses は Claude モデルに対応しておらず、404 を返します。

課金が発生した非ストリーミングのレスポンスは、このリクエストの実際の課金額を返します。レスポンスヘッダー X-HopBase-Cost / X-HopBase-Cost-USD / X-HopBase-Currency と、レスポンスボディのルート usage 内の cost / cost_usd / currency です(usage の既存フィールドはそのまま)。cost_usd は残高から実際に差し引かれた米ドル額、cost は同じ課金額の人民元額で、currency は常に CNY です。ストリーミング(SSE)では返さないため、コンソールの「利用履歴」で確認してください。課金されないレスポンス(エラーなど)には付きません。詳しくはアカウント API · 課金を参照してください。

ヘッダー

Authorization:必須string

Bearer sk-…:コンソールの「API キー」で作成したキー。キーのグループにリクエストするモデルが含まれている必要があります

リクエストボディJSON

モデル
記載のないフィールドはそのまま転送されます。モデルファミリーを選ぶと、そのドキュメントに記載された値と制限を表示します。
model:必須string

現在のキーのグループに含まれるモデル ID。GET /v1/models の返り値が基準です。グループにそのモデルがない場合は 404 model_not_found、gpt-image-* などの画像モデルでこのエンドポイントを呼ぶと 400 image models do not support Chat Completions, please use the Images API を返します

messages:必須array of object

会話メッセージ。欠落時は 400 missing messages field、空配列の場合は 400 messages must not be an empty array を返します

個数≥ 1 個

max_tokens:任意integer

出力上限。ゲートウェイは切り詰めも書き換えもしません。上限はモデルの公式仕様に従い、超えた場合はモデルがエラーを返します

max_completion_tokens:任意integer

max_tokens と同じ。OpenAI の新しいフィールド名です

stream:任意boolean

true で SSE を返します。イベント形式はストリーミングイベントを参照

デフォルトfalse

stream_options:任意object

ストリーミングオプション

tools:任意array of object

関数ツール。OpenAI の function tools 形式で、そのまま転送されます。

tool_choice:任意string または object

auto / none / required または特定の関数。そのまま転送されます

temperature:任意number

サンプリング温度。そのまま転送され、範囲はモデルの公式仕様に従います

top_p:任意number

nucleus サンプリング。そのまま転送され、範囲はモデルの公式仕様に従います

reasoning_effort:任意string

推論レベル。値はモデルによって異なるため、上でモデルファミリーを選んで確認してください

service_tier:任意string

priority / flex のみ保持します。その他の値は削除してから転送し、エラーにはなりません。priority は対応しているグループでのみ有効で Fast 料金で課金され、非対応のグループでは標準ティアで処理され標準料金で課金されます。「GPT 公式ダイレクト(Azure)」グループは priority に対応していません

取りうる値priorityflex

レスポンス

200成功。非ストリーミングでは chat.completion JSON、stream: true のときは SSE(text/event-stream)

レスポンスヘッダー

X-HopBase-Cost:任意string

このリクエストの課金額の人民元額(X-HopBase-Cost-USD と同じ課金額)で、小数点以下最大 6 桁(例: 0.0816)。課金が発生したときだけ返します。ストリーミング(SSE)では返しません。画像生成が約 40 秒を超えるとレスポンスヘッダーは先に送信済みのため、レスポンスボディの usage.cost を参照してください

X-HopBase-Cost-USD:任意string

このリクエストで残高から実際に差し引かれた米ドル額。利用履歴の該当レコードと同じ金額で、小数点以下最大 8 桁(例: 0.012)。X-HopBase-Cost と一緒にのみ返します

X-HopBase-Currency:任意string

X-HopBase-Cost の通貨。常に CNY

id:任意string

この補完の ID

object:任意"chat.completion"

chat.completion 固定

created:任意integer

Unix 秒

model:任意string

実際に使われたモデル ID

choices:任意array of object

候補の応答。ほとんどのモデルは 1 件のみ返します

usage:任意object

トークン使用量

エラー

400リクエストボディが読み取れない、messages がないなど
401キー未指定、キーが無効または期限切れ(missing_api_key / invalid_api_key / api_key_expired)
402残高、またはキー・メンバー・部門のクォータを使い切った(insufficient_quota)
404モデルがこのキーのグループにない(model_not_found)、またはパスがそのグループに属さない(route_not_found)
413リクエストボディが 60 MB を超えた(request_too_large)
429アカウントまたはキーの同時実行数が上限に達した(user_concurrency_limit / apikey_concurrency_limit)。Retry-After 付き

関連ページ