チャット補完を作成
OpenAI 互換の Chat Completions:GPT、Gemini、GLM、Qwen、DeepSeek、Grok、Claude などのチャットモデルが共通で使うエンドポイントです。
/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 · 課金を参照してください。
ヘッダー
Bearer sk-…:コンソールの「API キー」で作成したキー。キーのグループにリクエストするモデルが含まれている必要があります
リクエストボディJSON
現在のキーのグループに含まれるモデル ID。GET /v1/models の返り値が基準です。グループにそのモデルがない場合は 404 model_not_found、gpt-image-* などの画像モデルでこのエンドポイントを呼ぶと 400 image models do not support Chat Completions, please use the Images API を返します
会話メッセージ。欠落時は 400 missing messages field、空配列の場合は 400 messages must not be an empty array を返します
個数≥ 1 個
system / user / assistant / tool(OpenAI 形式)
文字列、またはコンテンツパーツの配列。パーツは {"type": "text", "text": …}。画像読み取り対応モデルは {"type": "image_url", "image_url": {"url": …}} も受け付けます。画像の要件はモデルごとに異なり、上のモデル選択で確認できます
text または image_url
type が text のときのテキスト
type が image_url のときの画像
HTTP(S) リンクまたは data: URI。対応形式はモデルによって異なります
assistant のみ:前のターンでモデルが返したツール呼び出し。そのまま送り返します
tool のみ:前のターンの tool_calls[].id と一致させる必要があります
出力上限。ゲートウェイは切り詰めも書き換えもしません。上限はモデルの公式仕様に従い、超えた場合はモデルがエラーを返します
max_tokens と同じ。OpenAI の新しいフィールド名です
true で SSE を返します。イベント形式はストリーミングイベントを参照
デフォルトfalse
ストリーミングオプション
ストリーミング時に true を指定した場合のみ、usage だけを含む最後のイベント(choices は空)を受け取れます。指定しなければ送られませんが、課金には影響しません
デフォルトfalse
関数ツール。OpenAI の function tools 形式で、そのまま転送されます。
function 固定
関数名
関数の用途。モデルはこれをもとに呼び出すかどうかを判断します
パラメータの JSON Schema
auto / none / required または特定の関数。そのまま転送されます
サンプリング温度。そのまま転送され、範囲はモデルの公式仕様に従います
nucleus サンプリング。そのまま転送され、範囲はモデルの公式仕様に従います
推論レベル。値はモデルによって異なるため、上でモデルファミリーを選んで確認してください
priority / flex のみ保持します。その他の値は削除してから転送し、エラーにはなりません。priority は対応しているグループでのみ有効で Fast 料金で課金され、非対応のグループでは標準ティアで処理され標準料金で課金されます。「GPT 公式ダイレクト(Azure)」グループは priority に対応していません
取りうる値priorityflex
現在のキーのグループに含まれるモデル ID。GET /v1/models の返り値が基準です。グループにそのモデルがない場合は 404 model_not_found、gpt-image-* などの画像モデルでこのエンドポイントを呼ぶと 400 image models do not support Chat Completions, please use the Images API を返します
取りうる値codex-auto-reviewgpt-4.1gpt-4.1-minigpt-4.1-nanogpt-4ogpt-4o-minigpt-5gpt-5-minigpt-5-nanogpt-5.1gpt-5.2gpt-5.3-codex-sparkgpt-5.4gpt-5.4-minigpt-5.4-nanogpt-5.4-progpt-5.5gpt-5.6-lunagpt-5.6-solgpt-5.6-terragpt-6-astragpt-6-lunagpt-6-solgpt-6.1-solgpt-6.1-terragpt-6.2-astragpt-6.2-sol
会話メッセージ。欠落時は 400 missing messages field、空配列の場合は 400 messages must not be an empty array を返します
個数≥ 1 個
system / user / assistant / tool(OpenAI 形式)
文字列、またはコンテンツパーツの配列。パーツは {"type": "text", "text": …}。画像読み取り対応モデルは {"type": "image_url", "image_url": {"url": …}} も受け付けます。画像の要件はモデルごとに異なり、上のモデル選択で確認できます
text または image_url
type が text のときのテキスト
type が image_url のときの画像
HTTP(S) リンクまたは data: URI。対応形式はモデルによって異なります
assistant のみ:前のターンでモデルが返したツール呼び出し。そのまま送り返します
tool のみ:前のターンの tool_calls[].id と一致させる必要があります
出力上限。ゲートウェイは切り詰めも書き換えもしません。上限はモデルの公式仕様に従い、超えた場合はモデルがエラーを返します
max_tokens と同じ。OpenAI の新しいフィールド名です
true で SSE を返します。イベント形式はストリーミングイベントを参照
デフォルトfalse
ストリーミングオプション
ストリーミング時に true を指定した場合のみ、usage だけを含む最後のイベント(choices は空)を受け取れます。指定しなければ送られませんが、課金には影響しません
デフォルトfalse
関数ツール。OpenAI の function tools 形式で、そのまま転送されます。
function 固定
関数名
関数の用途。モデルはこれをもとに呼び出すかどうかを判断します
パラメータの JSON Schema
auto / none / required または特定の関数。そのまま転送されます
サンプリング温度。そのまま転送され、範囲はモデルの公式仕様に従います
nucleus サンプリング。そのまま転送され、範囲はモデルの公式仕様に従います
推論レベル。値はモデルによって異なるため、上でモデルファミリーを選んで確認してください
priority / flex のみ保持します。その他の値は削除してから転送し、エラーにはなりません。priority は対応しているグループでのみ有効で Fast 料金で課金され、非対応のグループでは標準ティアで処理され標準料金で課金されます。「GPT 公式ダイレクト(Azure)」グループは priority に対応していません
取りうる値priorityflex
現在のキーのグループに含まれるモデル ID。GET /v1/models の返り値が基準です。グループにそのモデルがない場合は 404 model_not_found、gpt-image-* などの画像モデルでこのエンドポイントを呼ぶと 400 image models do not support Chat Completions, please use the Images API を返します
取りうる値gemini-2.5-flashgemini-2.5-flash-litegemini-2.5-progemini-3-flash-previewgemini-3.1-flash-litegemini-3.1-flash-lite-previewgemini-3.1-pro-previewgemini-3.1-pro-preview-customtoolsgemini-3.5-flashgemini-3.5-flash-litegemini-3.6-flashgemini-3.7-flashgemini-3.8-flashgemini-4-argongemini-4-carbongemini-4-hydrogengemini-4-neon
対応するコンテンツパーツは text、image_url、input_audio、file、refusal です。それ以外の種類(video_url など)は 400 を返します。image_url は base64 の data URL のみ受け付けます(公開 URL は 400 image_url only supports data URLs (base64-embedded images))。file の file_data は data URL が必須で、file_id には対応していません。role: "tool" は関数の実行結果としてモデルに渡されます。使える内容がない場合は 400 を返します
個数≥ 1 個
system / user / assistant / tool(OpenAI 形式)
文字列、またはコンテンツパーツの配列。パーツは {"type": "text", "text": …}。画像読み取り対応モデルは {"type": "image_url", "image_url": {"url": …}} も受け付けます。画像の要件はモデルごとに異なり、上のモデル選択で確認できます
text または image_url
type が text のときのテキスト
type が image_url のときの画像
HTTP(S) リンクまたは data: URI。対応形式はモデルによって異なります
assistant のみ:前のターンでモデルが返したツール呼び出し。そのまま送り返します
tool のみ:前のターンの tool_calls[].id と一致させる必要があります
max_completion_tokens も同時に指定した場合は max_tokens が優先されます。思考トークンもこの上限に含まれるため、4096 以上を推奨します
max_tokens と同じ。OpenAI の新しいフィールド名です
true で SSE を返します。イベント形式はストリーミングイベントを参照
デフォルトfalse
ストリーミングオプション
ストリーミング時に true を指定した場合のみ、usage だけを含む最後のイベント(choices は空)を受け取れます。指定しなければ送られませんが、課金には影響しません
デフォルトfalse
関数ツール。OpenAI の function tools 形式で、そのまま転送されます。
function 固定
関数名
関数の用途。モデルはこれをもとに呼び出すかどうかを判断します
パラメータの JSON Schema
auto / none / required、特定の関数、または allowed_tools。並列呼び出しとマルチターンに対応し、parallel_tool_calls: false のときは最初の呼び出しだけを残します
サンプリング温度。そのまま転送され、範囲はモデルの公式仕様に従います
nucleus サンプリング。そのまま転送され、範囲はモデルの公式仕様に従います
none / minimal → 思考予算 0、medium → 8192、high → 24576。low やその他の値はモデルの既定値のままです
取りうる値noneminimallowmediumhigh
priority / flex のみ保持します。その他の値は削除してから転送し、エラーにはなりません。priority は対応しているグループでのみ有効で Fast 料金で課金され、非対応のグループでは標準ティアで処理され標準料金で課金されます。「GPT 公式ダイレクト(Azure)」グループは priority に対応していません
取りうる値priorityflex
現在のキーのグループに含まれるモデル ID。GET /v1/models の返り値が基準です。グループにそのモデルがない場合は 404 model_not_found、gpt-image-* などの画像モデルでこのエンドポイントを呼ぶと 400 image models do not support Chat Completions, please use the Images API を返します
取りうる値glm-5.3
空でない配列、テキストのみ。画像を含めると 400。コンテキスト 1M
個数≥ 1 個
system / user / assistant / tool(OpenAI 形式)
文字列、またはコンテンツパーツの配列。パーツは {"type": "text", "text": …}。画像読み取り対応モデルは {"type": "image_url", "image_url": {"url": …}} も受け付けます。画像の要件はモデルごとに異なり、上のモデル選択で確認できます
text または image_url
type が text のときのテキスト
type が image_url のときの画像
HTTP(S) リンクまたは data: URI。対応形式はモデルによって異なります
assistant のみ:前のターンでモデルが返したツール呼び出し。そのまま送り返します
tool のみ:前のターンの tool_calls[].id と一致させる必要があります
思考と本文で共用。超えると 400(max_tokens の許容範囲は [1, 131072])を返します
範囲1–131072
max_tokens と同じ。OpenAI の新しいフィールド名です
true で SSE を返します。イベント形式はストリーミングイベントを参照
デフォルトfalse
ストリーミングオプション
ストリーミング時に true を指定した場合のみ、usage だけを含む最後のイベント(choices は空)を受け取れます。指定しなければ送られませんが、課金には影響しません
デフォルトfalse
関数ツール。OpenAI の function tools 形式で、そのまま転送されます。
function 固定
関数名
関数の用途。モデルはこれをもとに呼び出すかどうかを判断します
パラメータの JSON Schema
OpenAI と同じ。返す tool の結果は前のターンの呼び出し ID に対応させる必要があり、そうでなければ 400 No tool call found for function call output を返します
デフォルト"auto"
サンプリング温度。そのまま転送され、範囲はモデルの公式仕様に従います
nucleus サンプリング。そのまま転送され、範囲はモデルの公式仕様に従います
常に思考します。none など思考をオフにする値を指定すると 400 を返します
取りうる値lowhighmax
priority / flex のみ保持します。その他の値は削除してから転送し、エラーにはなりません。priority は対応しているグループでのみ有効で Fast 料金で課金され、非対応のグループでは標準ティアで処理され標準料金で課金されます。「GPT 公式ダイレクト(Azure)」グループは priority に対応していません
取りうる値priorityflex
現在のキーのグループに含まれるモデル ID。GET /v1/models の返り値が基準です。グループにそのモデルがない場合は 404 model_not_found、gpt-image-* などの画像モデルでこのエンドポイントを呼ぶと 400 image models do not support Chat Completions, please use the Images API を返します
取りうる値glm-5.3-flash
空でない配列。テキスト、画像、動画、ファイルを含められます。コンテキスト 1M
個数≥ 1 個
system / user / assistant / tool(OpenAI 形式)
文字列、またはコンテンツパーツの配列。パーツは {"type": "text", "text": …}。画像読み取り対応モデルは {"type": "image_url", "image_url": {"url": …}} も受け付けます。画像の要件はモデルごとに異なり、上のモデル選択で確認できます
text または image_url
type が text のときのテキスト
type が image_url のときの画像
HTTP(S) リンクまたは data: URI。対応形式はモデルによって異なります
assistant のみ:前のターンでモデルが返したツール呼び出し。そのまま送り返します
tool のみ:前のターンの tool_calls[].id と一致させる必要があります
最大 128K(公式上限)。思考と回答で共用
max_tokens と同じ。OpenAI の新しいフィールド名です
true で SSE を返します。イベント形式はストリーミングイベントを参照
デフォルトfalse
ストリーミングオプション
ストリーミング時に true を指定した場合のみ、usage だけを含む最後のイベント(choices は空)を受け取れます。指定しなければ送られませんが、課金には影響しません
デフォルトfalse
関数ツール。OpenAI の function tools 形式で、そのまま転送されます。
function 固定
関数名
関数の用途。モデルはこれをもとに呼び出すかどうかを判断します
パラメータの JSON Schema
auto / none / required または特定の関数。そのまま転送されます
ゲートウェイでは範囲を設けていません。推奨は 1
ゲートウェイでは範囲を設けていません。推奨は 0.95
推奨は max。思考は有効化のみで、無効にはできません
取りうる値lowhighmax
priority / flex のみ保持します。その他の値は削除してから転送し、エラーにはなりません。priority は対応しているグループでのみ有効で Fast 料金で課金され、非対応のグループでは標準ティアで処理され標準料金で課金されます。「GPT 公式ダイレクト(Azure)」グループは priority に対応していません
取りうる値priorityflex
tools を伴うストリーミングでは true を推奨。ツール引数が逐次ストリーミングされます
デフォルトfalse
現在のキーのグループに含まれるモデル ID。GET /v1/models の返り値が基準です。グループにそのモデルがない場合は 404 model_not_found、gpt-image-* などの画像モデルでこのエンドポイントを呼ぶと 400 image models do not support Chat Completions, please use the Images API を返します
取りうる値qwen3.7-maxqwen3.7-plusqwen3.8-flashqwen3.8-maxqwen4-max
空でない配列。qwen3.7-max はテキストのみ、その他のモデルは画像・動画に対応。画像の幅・高さは 10 ピクセルより大きい必要があります。qwen3.8-max の実測入力上限は 991,808 トークンで、超えると 400 Range of input length should be [1, 991808] を返します
個数≥ 1 個
system / user / assistant / tool(OpenAI 形式)
文字列、またはコンテンツパーツの配列。パーツは {"type": "text", "text": …}。画像読み取り対応モデルは {"type": "image_url", "image_url": {"url": …}} も受け付けます。画像の要件はモデルごとに異なり、上のモデル選択で確認できます
text または image_url
type が text のときのテキスト
type が image_url のときの画像
HTTP(S) リンクまたは data: URI。対応形式はモデルによって異なります
assistant のみ:前のターンでモデルが返したツール呼び出し。そのまま送り返します
tool のみ:前のターンの tool_calls[].id と一致させる必要があります
上限 131,072(公式上限)
範囲≤ 131072
max_tokens と同じ。OpenAI の新しいフィールド名です
true で SSE を返します。イベント形式はストリーミングイベントを参照
デフォルトfalse
ストリーミングオプション
ストリーミング時に true を指定した場合のみ、usage だけを含む最後のイベント(choices は空)を受け取れます。指定しなければ送られませんが、課金には影響しません
デフォルトfalse
関数ツール。OpenAI の function tools 形式で、そのまま転送されます。
function 固定
関数名
関数の用途。モデルはこれをもとに呼び出すかどうかを判断します
パラメータの JSON Schema
OpenAI と同じ。思考モードでは required や特定の関数を指定できず、400 を返します
デフォルト"auto"
サンプリング温度。そのまま転送され、範囲はモデルの公式仕様に従います
nucleus サンプリング。そのまま転送され、範囲はモデルの公式仕様に従います
実測で使える値
取りうる値lowhighmax
priority / flex のみ保持します。その他の値は削除してから転送し、エラーにはなりません。priority は対応しているグループでのみ有効で Fast 料金で課金され、非対応のグループでは標準ティアで処理され標準料金で課金されます。「GPT 公式ダイレクト(Azure)」グループは priority に対応していません
取りうる値priorityflex
Qwen 固有。そのまま転送されます
reasoning_effort と同時に指定すると 400 を返します
Qwen 固有。そのまま転送されます
JSON モード。挙動は公式 API と同じです
現在のキーのグループに含まれるモデル ID。GET /v1/models の返り値が基準です。グループにそのモデルがない場合は 404 model_not_found、gpt-image-* などの画像モデルでこのエンドポイントを呼ぶと 400 image models do not support Chat Completions, please use the Images API を返します
取りうる値deepseek-v4-flash-202605deepseek-v4-pro-202606deepseek-v4.1-flashdeepseek-v4.1-flash-1017deepseek-v4.1-flash-1017-sg
空でない配列。role は system / user / assistant / tool / developer。画像読み取りは deepseek-v4.1-flash と deepseek-v4.1-flash-1017 のみで、image_url.url には data: URI または https:// リンクを指定できます
個数≥ 1 個
system / user / assistant / tool(OpenAI 形式)
文字列、またはコンテンツパーツの配列。パーツは {"type": "text", "text": …}。画像読み取り対応モデルは {"type": "image_url", "image_url": {"url": …}} も受け付けます。画像の要件はモデルごとに異なり、上のモデル選択で確認できます
text または image_url
type が text のときのテキスト
type が image_url のときの画像
HTTP(S) リンクまたは data: URI。対応形式はモデルによって異なります
assistant のみ:前のターンでモデルが返したツール呼び出し。そのまま送り返します
tool のみ:前のターンの tool_calls[].id と一致させる必要があります
非負整数。出力上限は V4.1 Flash・V4 Flash が 384,000、V4 Pro が 393,216。思考と本文で共用します。負数は 400、上限を超えてもエラーにはならず、出力が黙って切り詰められます
範囲≥ 0
max_tokens と同じ。OpenAI の新しいフィールド名です
true で SSE を返します。イベント形式はストリーミングイベントを参照
デフォルトfalse
ストリーミングオプション
ストリーミング時に true を指定した場合のみ、usage だけを含む最後のイベント(choices は空)を受け取れます。指定しなければ送られませんが、課金には影響しません
デフォルトfalse
関数ツール。OpenAI の function tools 形式で、そのまま転送されます。
function 固定
関数名
関数の用途。モデルはこれをもとに呼び出すかどうかを判断します
パラメータの JSON Schema
auto / none / required / 特定の関数
デフォルト"auto"
2 を超えると 400 expected a value <= 2
範囲0–2
nucleus サンプリング。そのまま転送され、範囲はモデルの公式仕様に従います
実測で使える値
取りうる値lowmediumhigh
priority / flex のみ保持します。その他の値は削除してから転送し、エラーにはなりません。priority は対応しているグループでのみ有効で Fast 料金で課金され、非対応のグループでは標準ティアで処理され標準料金で課金されます。「GPT 公式ダイレクト(Azure)」グループは priority に対応していません
取りうる値priorityflex
{"type": …}。その他の値(auto など)は 400 を返します。V4.1 Flash は既定で有効
取りうる値enableddisabledadaptive
プレフィックス続き書き:最後の assistant メッセージにのみ付けられます
デフォルトfalse
現在のキーのグループに含まれるモデル ID。GET /v1/models の返り値が基準です。グループにそのモデルがない場合は 404 model_not_found、gpt-image-* などの画像モデルでこのエンドポイントを呼ぶと 400 image models do not support Chat Completions, please use the Images API を返します
取りうる値doubao-seed-2-0-mini-260428doubao-seed-2-1-lite-260915doubao-seed-2-1-pro-260628doubao-seed-2-1-pro-260915doubao-seed-2-1-turbo-260628doubao-seed-character-260628doubao-seed-evolving
空でない配列。7 モデルとも画像に対応:image_url.url は公開ダウンロード可能なリンクか data: URI(base64)
個数≥ 1 個
system / user / assistant / tool(OpenAI 形式)
文字列、またはコンテンツパーツの配列。パーツは {"type": "text", "text": …}。画像読み取り対応モデルは {"type": "image_url", "image_url": {"url": …}} も受け付けます。画像の要件はモデルごとに異なり、上のモデル選択で確認できます
text または image_url
type が text のときのテキスト
type が image_url のときの画像
HTTP(S) リンクまたは data: URI。対応形式はモデルによって異なります
assistant のみ:前のターンでモデルが返したツール呼び出し。そのまま送り返します
tool のみ:前のターンの tool_calls[].id と一致させる必要があります
doubao-seed-2-1-pro-260915、doubao-seed-2-1-lite-260915 は最大 256K。doubao-seed-character-260628 は最大 32K。その他は最大 128K
max_tokens と同じ。OpenAI の新しいフィールド名です
true で SSE を返します。イベント形式はストリーミングイベントを参照
デフォルトfalse
ストリーミングオプション
ストリーミング時に true を指定した場合のみ、usage だけを含む最後のイベント(choices は空)を受け取れます。指定しなければ送られませんが、課金には影響しません
デフォルトfalse
関数ツール。OpenAI の function tools 形式で、そのまま転送されます。
function 固定
関数名
関数の用途。モデルはこれをもとに呼び出すかどうかを判断します
パラメータの JSON Schema
doubao-seed-evolving と doubao-seed-2-1-pro-260915 は従いません。none や特定の関数を指定しても自分でツールを選びます。ツール呼び出しを強制・禁止したい場合は doubao-seed-2-1-pro-260628 か doubao-seed-2-1-lite-260915 を使ってください
デフォルト"auto"
サンプリング温度。そのまま転送され、範囲はモデルの公式仕様に従います
nucleus サンプリング。そのまま転送され、範囲はモデルの公式仕様に従います
推論レベル。値はモデルによって異なるため、上でモデルファミリーを選んで確認してください
priority / flex のみ保持します。その他の値は削除してから転送し、エラーにはなりません。priority は対応しているグループでのみ有効で Fast 料金で課金され、非対応のグループでは標準ティアで処理され標準料金で課金されます。「GPT 公式ダイレクト(Azure)」グループは priority に対応していません
取りうる値priorityflex
現在のキーのグループに含まれるモデル ID。GET /v1/models の返り値が基準です。グループにそのモデルがない場合は 404 model_not_found、gpt-image-* などの画像モデルでこのエンドポイントを呼ぶと 400 image models do not support Chat Completions, please use the Images API を返します
取りうる値deepseek-v4-flash-usdeepseek-v4-pro-usdeepseek-v4.1-flash-usglm-5.2-usglm-5.3-us
空でない配列。画像読み取りは deepseek-v4.1-flash-us のみで、ほかのモデルには画像が見えません。コンテキスト 1M
個数≥ 1 個
system / user / assistant / tool(OpenAI 形式)
文字列、またはコンテンツパーツの配列。パーツは {"type": "text", "text": …}。画像読み取り対応モデルは {"type": "image_url", "image_url": {"url": …}} も受け付けます。画像の要件はモデルごとに異なり、上のモデル選択で確認できます
text または image_url
type が text のときのテキスト
type が image_url のときの画像
HTTP(S) リンクまたは data: URI。対応形式はモデルによって異なります
assistant のみ:前のターンでモデルが返したツール呼び出し。そのまま送り返します
tool のみ:前のターンの tool_calls[].id と一致させる必要があります
思考と本文で共有します。GLM の上限は 131,072 で、超えると 400 Range of max_tokens should be [1, 131072] を返します。DeepSeek の上限は 393,216 で、超えても拒否されません
範囲≥ 1
max_tokens と同じ。OpenAI の新しいフィールド名です
true で SSE を返します。イベント形式はストリーミングイベントを参照
デフォルトfalse
ストリーミングオプション
ストリーミング時に true を指定した場合のみ、usage だけを含む最後のイベント(choices は空)を受け取れます。指定しなければ送られませんが、課金には影響しません
デフォルトfalse
関数ツール。OpenAI の function tools 形式で、そのまま転送されます。
function 固定
関数名
関数の用途。モデルはこれをもとに呼び出すかどうかを判断します
パラメータの JSON Schema
OpenAI と同じ。GLM は強制指定(required や特定の関数)を無視し、テキストで回答することがあります
デフォルト"auto"
GLM は 2.0 未満が必要で、それ以外は 400 Temperature should be in [0.0, 2.0) を返します
範囲0–2
nucleus サンプリング。そのまま転送され、範囲はモデルの公式仕様に従います
推論レベル。値はモデルによって異なるため、上でモデルファミリーを選んで確認してください
priority / flex のみ保持します。その他の値は削除してから転送し、エラーにはなりません。priority は対応しているグループでのみ有効で Fast 料金で課金され、非対応のグループでは標準ティアで処理され標準料金で課金されます。「GPT 公式ダイレクト(Azure)」グループは priority に対応していません
取りうる値priorityflex
DeepSeek は 1 のみ受け付け、それ以外は 400 を返します
範囲≥ 1
glm-5.3-us では true のみで、false を渡すと 400 を返します
現在のキーのグループに含まれるモデル ID。GET /v1/models の返り値が基準です。グループにそのモデルがない場合は 404 model_not_found、gpt-image-* などの画像モデルでこのエンドポイントを呼ぶと 400 image models do not support Chat Completions, please use the Images API を返します
取りうる値grok-4.20-0309-reasoninggrok-4.20-multi-agent-0309grok-4.3grok-4.5grok-4.6grok-4.7
会話メッセージ。欠落時は 400 missing messages field、空配列の場合は 400 messages must not be an empty array を返します
個数≥ 1 個
system / user / assistant / tool(OpenAI 形式)
文字列、またはコンテンツパーツの配列。パーツは {"type": "text", "text": …}。画像読み取り対応モデルは {"type": "image_url", "image_url": {"url": …}} も受け付けます。画像の要件はモデルごとに異なり、上のモデル選択で確認できます
text または image_url
type が text のときのテキスト
type が image_url のときの画像
HTTP(S) リンクまたは data: URI。対応形式はモデルによって異なります
assistant のみ:前のターンでモデルが返したツール呼び出し。そのまま送り返します
tool のみ:前のターンの tool_calls[].id と一致させる必要があります
ゲートウェイでは上限を設けず、コンテキストウィンドウに依存します。公式の定義では推論トークンを含みます
max_tokens と同じ。OpenAI の新しいフィールド名です
true で SSE を返します。イベント形式はストリーミングイベントを参照
デフォルトfalse
ストリーミングオプション
ストリーミング時に true を指定した場合のみ、usage だけを含む最後のイベント(choices は空)を受け取れます。指定しなければ送られませんが、課金には影響しません
デフォルトfalse
関数ツールとサーバー側ツール。サーバー側ツールは呼び出し回数で課金されます
auto / none / required または特定の関数。そのまま転送されます
0–2(公式)
範囲0–2
0–1(公式)。公式は temperature とどちらか一方の使用を推奨しています
範囲0–1
grok-4.7 / grok-4.6:low / medium / high / xhigh、grok-4.5:low / medium / high(公式)。公式ではこの 3 モデルのみに開放されており、推論は無効にできません
取りうる値lowmediumhighxhigh
デフォルト"high"
priority / flex のみ保持します。その他の値は削除してから転送し、エラーにはなりません。priority は対応しているグループでのみ有効で Fast 料金で課金され、非対応のグループでは標準ティアで処理され標準料金で課金されます。「GPT 公式ダイレクト(Azure)」グループは priority に対応していません
取りうる値priorityflex
非対応(公式):推論モデルは受け付けず、指定するとエラーになります
非対応(公式)
非対応(公式)
レスポンス
200成功。非ストリーミングでは chat.completion JSON、stream: true のときは SSE(text/event-stream)
レスポンスヘッダー
このリクエストの課金額の人民元額(X-HopBase-Cost-USD と同じ課金額)で、小数点以下最大 6 桁(例: 0.0816)。課金が発生したときだけ返します。ストリーミング(SSE)では返しません。画像生成が約 40 秒を超えるとレスポンスヘッダーは先に送信済みのため、レスポンスボディの usage.cost を参照してください
このリクエストで残高から実際に差し引かれた米ドル額。利用履歴の該当レコードと同じ金額で、小数点以下最大 8 桁(例: 0.012)。X-HopBase-Cost と一緒にのみ返します
X-HopBase-Cost の通貨。常に CNY
この補完の ID
chat.completion 固定
Unix 秒
実際に使われたモデル ID
候補の応答。ほとんどのモデルは 1 件のみ返します
インデックス
モデルの応答
assistant 固定
応答テキスト。ツール呼び出しのみの場合は null
思考過程(DeepSeek などのモデルが返します)
モデルが呼び出しを求めた関数。実行後、結果を role: "tool" メッセージで送り返します
呼び出し ID。結果を返すときに tool_call_id に入れます
関数名
JSON 文字列形式の引数
stop / length / tool_calls など。length は出力上限に達したことを示します
トークン使用量
入力トークン
出力トークン。推論トークンを含むかどうかはモデルにより異なります(各モデルページを参照)
合計
推論トークン(一部のモデルで個別に表示)
ゲートウェイが付加:このリクエストの課金額の人民元額(cost_usd と同じ課金額)。レスポンスヘッダー X-HopBase-Cost と同じ。ストリーミングでは返しません
ゲートウェイが付加:残高から実際に差し引かれた米ドル額。レスポンスヘッダー X-HopBase-Cost-USD および利用履歴と同じ。ストリーミングでは返しません
ゲートウェイが付加:cost の通貨。常に CNY
エラー
messages がないなどmissing_api_key / invalid_api_key / api_key_expired)insufficient_quota)model_not_found)、またはパスがそのグループに属さない(route_not_found)request_too_large)user_concurrency_limit / apikey_concurrency_limit)。Retry-After 付き