建立對話補全
OpenAI 相容的 Chat Completions:GPT、Gemini、GLM、千問、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 或指定函式,原樣轉發
取樣溫度,原樣轉發,範圍按模型官方規格
核取樣,原樣轉發,範圍按模型官方規格
推理檔位。取值因模型而異,請在上方選擇模型種類檢視
只保留 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 或指定函式,原樣轉發
取樣溫度,原樣轉發,範圍按模型官方規格
核取樣,原樣轉發,範圍按模型官方規格
推理檔位。取值因模型而異,請在上方選擇模型種類檢視
只保留 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(公開網路連結回傳 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 為準。思考 token 計入此上限,建議不低於 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 時只保留第一個調用
取樣溫度,原樣轉發,範圍按模型官方規格
核取樣,原樣轉發,範圍按模型官方規格
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"
取樣溫度,原樣轉發,範圍按模型官方規格
核取樣,原樣轉發,範圍按模型官方規格
始終思考:設為 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 Token,超出回傳 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"
取樣溫度,原樣轉發,範圍按模型官方規格
核取樣,原樣轉發,範圍按模型官方規格
實測可用取值
可選值lowhighmax
只保留 priority / flex;其他取值會被移除後再轉發,不報錯。priority 僅在所用分組支援時生效並按 Fast 價計費,不支援時按標準檔處理、按標準價計費;「GPT 官方直連(Azure)」分組不支援 priority
可選值priorityflex
千問特有,透傳
不能與 reasoning_effort 同時設定,否則回傳 400
千問特有,透傳
JSON 模式,行為與官方介面一致
目前密鑰分組內的模型 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
核取樣,原樣轉發,範圍按模型官方規格
實測可用取值
可選值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
非空陣列;七個型號都支援圖片: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"
取樣溫度,原樣轉發,範圍按模型官方規格
核取樣,原樣轉發,範圍按模型官方規格
推理檔位。取值因模型而異,請在上方選擇模型種類檢視
只保留 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
核取樣,原樣轉發,範圍按模型官方規格
推理檔位。取值因模型而異,請在上方選擇模型種類檢視
只保留 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 一致
網關不設上限,受上下文視窗約束;官方口徑含推理 Token
同 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(官方)。官方只對這三個型號開放,推理無法關閉
可選值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 表示撞到輸出上限
Token 用量
輸入 Token
輸出 Token;推理 Token 是否包含因模型而異,見各模型頁
合計
推理 Token(部分模型單列)
閘道附加:本次扣費的人民幣金額(與 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