Chat Completions

接口：

POST /v1/chat/completions

SDK：

client.chat.completions.create(...)

请求字段

字段	类型	必填	说明
model	string	是	使用 /v1/models 返回的模型 ID
messages	array	是	OpenAI Chat messages
max_tokens	number	否	最大输出 token 数
temperature	number	否	采样温度
top_p	number	否	核采样参数
stream	boolean	否	true 时返回 SSE
stream_options.include_usage	boolean	否	流式输出结束时包含 usage
tools	array	否	OpenAI function tools
tool_choice	string/object	否	支持常见 OpenAI tool choice
enable_thinking	boolean	否	兼容 Qwen 官方字段，显式控制 thinking/reasoning；OpenAI SDK 可放在 extra_body
llmgw_thinking	boolean	否	网关扩展字段，显式开启或关闭 thinking/reasoning
response_format	object	否	如 {"type":"json_object"} / JSON schema，控制输出格式
stop	string/array	否	停止序列
seed	integer	否	采样种子（上游支持时生效）
reasoning_effort	string	否	推理强度，如 low/medium/high（上游支持时生效）

多模态输入

图片输入使用 OpenAI 标准 content parts：

{
  "role": "user",
  "content": [
    {"type": "text", "text": "这张图里有什么？"},
    {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
  ]
}

也支持 data:image/...;base64,...。请先用 /v1/model-catalog/{model} 判断模型是否包含 modalities.input: ["image"]。

响应字段

非流式返回 OpenAI chat.completion 对象：

字段	说明
id	请求 ID
object	chat.completion
model	实际响应模型
choices[].message.content	文本输出；仅返回 tool_calls 时为 null
choices[].message.tool_calls	工具调用数组（{id,type:"function",function:{name,arguments}}），无工具调用时不返回
choices[].message.reasoning_content	仅流式响应返回上游思考内容；非流式响应不返回该字段
choices[].finish_reason	停止原因：stop、length、tool_calls 等
usage	token 用量

流式返回 chat.completion.chunk SSE，最后一帧为：

data: [DONE]

边界

边界	说明
模型能力	文本模型不能传图片
thinking	网关扩展 llmgw_thinking / OpenAI enable_thinking（bool）按模型转换：qwen3.*→enable_thinking；deepseek-v4-*→/think 或 /no_think 指令；glm-*→thinking 对象；其他模型（kimi/minimax 等）该 bool 无效，需用模型原生 thinking 对象控制
reasoning	只有上游返回 reasoning 字段时才会出现
流式超时	客户端应设置较长 read timeout

示例

curl -N https://llm.xiaoyue9527.xyz/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk-gtw-REPLACE_ME' \
  --data-raw '{
    "model": "qwen3.6-plus",
    "messages": [{"role": "user", "content": "解释什么是 RESTful API"}],
    "max_tokens": 2048,
    "stream": true,
    "stream_options": {"include_usage": true}
  }'