建立對話補全

OpenAI 相容的 Chat Completions：GPT、Gemini、GLM、千問、DeepSeek、Grok 等對話模型共用此端點。

POST/v1/chat/completions

給定一組對話訊息，回傳模型的回覆。OpenAI SDK 只需把 Base URL 換成 https://api.hop-base.com/v1、換上對應分組的金鑰。

下表只列網關會檢查、改寫或拒絕的欄位，以及各模型頁寫明的取值；未列出的 OpenAI 欄位原樣轉發，取值範圍按模型官方規格。整個請求體上限 60 MB，超過回傳 413。

建立對話補全

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

200application/json

{
  "id": "chatcmpl-EXAMPLE",
  "object": "chat.completion",
  "created": 1790222400,
  "model": "gpt-5.6-sol",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！有什麼可以幫你？"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 9,
    "total_tokens": 17
  }
}

請求標頭

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

核取樣，原樣轉發，範圍按模型官方規格

reasoning_effort:選填string

推理檔位。取值因模型而異，請在上方選擇模型種類檢視

service_tier:選填string

只保留 priority / flex；其他取值會被移除後再轉發，不報錯

可選值priorityflex

model:必填string

可選值codex-auto-reviewgpt-5.3-codex-sparkgpt-5.4gpt-5.4-minigpt-5.5gpt-5.6-solgpt-5.6-terragpt-6-astragpt-6-lunagpt-6-sol

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

核取樣，原樣轉發，範圍按模型官方規格

reasoning_effort:選填string

推理檔位。取值因模型而異，請在上方選擇模型種類檢視

service_tier:選填string

只保留 priority / flex；其他取值會被移除後再轉發，不報錯

可選值priorityflex

model:必填string

可選值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-flash

messages:必填array of object

內容分片只讀 text 與 image_url。image_url 只接受 base64 data URL（公開網路連結回傳 400 image_url only supports data URLs (base64-embedded images)）；input_audio、file、video_url 靜默丟棄；role: "tool" 按使用者文字送出；沒有可用內容回傳 400

數量≥ 1 項

max_tokens:選填integer

同時傳 max_completion_tokens 時以 max_tokens 為準。思考 token 計入此上限，建議不低於 4096

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

核取樣，原樣轉發，範圍按模型官方規格

reasoning_effort:選填string

none / minimal → 思考預算 0；medium → 8192；high → 24576；low 及其他取值沿用模型預設

可選值noneminimallowmediumhigh

service_tier:選填string

只保留 priority / flex；其他取值會被移除後再轉發，不報錯

可選值priorityflex

model:必填string

可選值glm-5.3

messages:必填array of object

非空陣列，僅文字；帶圖片回傳 400。上下文 1M

數量≥ 1 項

max_tokens:選填integer

思考與正文共用。超出回傳 400 max_tokens参数非法：限制数值范围[1,131072]

範圍1–131072

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

同 OpenAI。回傳的 tool 結果須對應上一輪的呼叫 ID，否則回傳 400 No tool call found for function call output

預設"auto"

temperature:選填number

取樣溫度，原樣轉發，範圍按模型官方規格

top_p:選填number

核取樣，原樣轉發，範圍按模型官方規格

reasoning_effort:選填string

始終思考：設為 none 等關閉思考的取值回傳 400

可選值lowhighmax

service_tier:選填string

只保留 priority / flex；其他取值會被移除後再轉發，不報錯

可選值priorityflex

model:必填string

可選值glm-5.3-flash

messages:必填array of object

非空陣列；可含文字、圖像、影片、檔案。上下文 1M

數量≥ 1 項

max_tokens:選填integer

最大 128K（官方上限），思考與回答共用

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

網關不設範圍，推薦 1

top_p:選填number

網關不設範圍，推薦 0.95

reasoning_effort:選填string

推薦 max；思考只能開啟，無法關閉

可選值lowhighmax

service_tier:選填string

只保留 priority / flex；其他取值會被移除後再轉發，不報錯

可選值priorityflex

tool_stream:選填boolean

推薦帶 tools 串流時設 true，工具參數逐步流出

預設false

model:必填string

可選值qwen3.7-flashqwen3.7-maxqwen3.7-plusqwen3.8-flashqwen3.8-max

messages:必填array of object

非空陣列；qwen3.7-max 僅文字，其餘型號支援圖片、影片；圖片寬高須大於 10 像素。qwen3.8-max 實測輸入上限 991,808 Token，超出回傳 400 Range of input length should be [1, 991808]

數量≥ 1 項

max_tokens:選填integer

上限 131,072（官方上限）

範圍≤ 131072

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

同 OpenAI。思考模式下不能設為 required 或指定函式，回傳 400

預設"auto"

temperature:選填number

取樣溫度，原樣轉發，範圍按模型官方規格

top_p:選填number

核取樣，原樣轉發，範圍按模型官方規格

reasoning_effort:選填string

實測可用取值

可選值lowhighmax

service_tier:選填string

只保留 priority / flex；其他取值會被移除後再轉發，不報錯

可選值priorityflex

enable_thinking:選填boolean

千問特有，透傳

thinking_budget:選填integer

不能與 reasoning_effort 同時設定，否則回傳 400

enable_search:選填boolean

千問特有，透傳

response_format:選填object

JSON 模式，行為與官方介面一致

model:必填string

可選值deepseek-v4-flash-202605deepseek-v4-pro-202606deepseek-v4.1-flash

messages:必填array of object

非空陣列；role 取 system / user / assistant / tool / developer。讀圖僅 deepseek-v4.1-flash：image_url.url 可為 data: URI 或 https:// 連結

數量≥ 1 項

max_tokens:選填integer

非負整數；輸出上限 V4.1 Flash、V4 Flash 384,000，V4 Pro 393,216。思考與正文共用；負數回傳 400；超過上限不報錯，輸出靜默截斷

範圍≥ 0

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 / 指定函式

預設"auto"

temperature:選填number

大於 2 回傳 400 expected a value <= 2

範圍0–2

top_p:選填number

核取樣，原樣轉發，範圍按模型官方規格

reasoning_effort:選填string

實測可用取值

可選值lowmediumhigh

service_tier:選填string

只保留 priority / flex；其他取值會被移除後再轉發，不報錯

可選值priorityflex

thinking:選填object

{"type": …}；其他取值（如 auto）回傳 400。V4.1 Flash 預設開啟

prefix:選填boolean

前綴續寫：只能加在最後一條 assistant 訊息上

預設false

model:必填string

可選值grok-4.20-0309-reasoninggrok-4.20-multi-agent-0309grok-4.3grok-4.5grok-4.6

messages:必填array of object

對話訊息。缺失回傳 400 missing messages field，空陣列回傳 400 messages must not be an empty array

數量≥ 1 項

max_tokens:選填integer

網關不設上限，受上下文視窗約束；官方口徑含推理 Token

max_completion_tokens:選填integer

同 max_tokens，OpenAI 新欄位名

stream:選填boolean

true 回傳 SSE，事件格式見串流事件

預設false

stream_options:選填object

串流選項

tools:選填array of object

函式工具與伺服器端工具；伺服器端工具按次計費

tool_choice:選填string 或 object

auto / none / required 或指定函式，原樣轉發

temperature:選填number

0–2（官方）

範圍0–2

top_p:選填number

0–1（官方）；官方建議與 temperature 二選一

範圍0–1

reasoning_effort:選填string

grok-4.6：low / medium / high / xhigh；grok-4.5：low / medium / high（官方）。官方只對這兩個型號開放，推理無法關閉

可選值lowmediumhighxhigh

預設"high"

service_tier:選填string

只保留 priority / flex；其他取值會被移除後再轉發，不報錯

可選值priorityflex

presence_penalty:不支援

不支援（官方）：推理模型不接受，傳了會報錯

frequency_penalty:不支援

不支援（官方）

stop:不支援

不支援（官方）

回傳

200成功。非串流為 chat.completion JSON；stream: true 時為 SSE（text/event-stream）

id:選填string

本次補全的 ID

object:選填"chat.completion"

固定為 chat.completion

created:選填integer

Unix 秒

model:選填string

實際使用的模型 ID

choices:選填array of object

候選回覆；多數模型只回傳 1 條

usage:選填object

Token 用量

錯誤

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

請求標頭

請求主體參數JSON

回傳

錯誤

相關頁面