创建对话补全

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

返回

错误

相关页面