Chat Completions 基础接口
OpenAI Chat Completions 兼容入口。普通对话、流式输出、识图、读 PDF、函数调用、结构化输出、联网搜索都从这里提交。
请求格式
使用 application/json。必须包含 model 和 messages。messages 是对话数组，常见 role 包括 system、user、assistant、tool。
验证顺序
- 用
GET /v1/models查询当前 Key 可选的模型。 - 用
model+messages发送第一条请求。 - 边生成边显示时，加
stream: true。 - 识图、工具、JSON Schema 等功能，在同一接口继续加字段。
适用位置
- 聊天页。
- 流式输出界面。
- 图文问答。
- 工具调用和 Agent 编排。
- 从 OpenAI SDK 迁移过来的项目。
读取结果
非流式请求返回 JSON，结果通常在 choices[0].message.content。流式请求返回 text/event-stream，客户端按增量事件拼接内容。
错误定位
- 模型不存在：查询模型列表，确认模型 ID 完全一致。
- 流式没有增量：确认请求头和客户端按 SSE 处理。
- 工具调用没执行：模型只返回调用意图，需要由应用服务执行工具并回填结果。
Authorizations
在请求头中传入：Authorization: Bearer sk-...
Body
OpenAI Chat Completions 兼容请求。可承载普通对话、流式输出、图文理解、工具调用和结构化输出。
要调用的模型 ID。先用 GET /v1/models 获取当前 Key 可访问的模型。
对话消息数组。常见 role 包括 system、user、assistant、tool。图文输入时，content 由文本和 image_url 内容块组成。
是否开启流式返回。true 时响应为 text/event-stream，客户端按 SSE 逐段读取。
采样温度。低值输出更确定，高值输出更发散。
0 <= x <= 2本次生成 token 上限。部分新模型改用 max_completion_tokens。
新模型常用的输出 token 上限字段。是否与 max_tokens 同时提交，以模型说明为准。
工具定义数组。函数工具通常包含 type=function、function.name、function.description 和参数 schema。
工具选择策略。可填 auto、none、required，或指定某个函数工具。
输出格式控制。JSON 模式或 JSON Schema 结构化输出会读取该字段。
推理模型的推理强度，例如 low、medium、high。是否生效以模型说明为准。
模型扩展参数容器。部分图片聊天模型使用 Chat Completions 时，画幅和图片档位可放在模型约定的扩展字段中。
图片聊天模型的顶层兼容字段。若同时传 nested image_config，nested 值优先。
"16:9"
图片聊天模型的顶层兼容字段。若同时传 nested image_config，nested 值优先。
"2K"
图片聊天模型的顶层兼容字段。部分模型会将该字段作为 image_size 的别名处理；image_size 和 nested image_config 的优先级更高。
"4K"