Skip to main content
POST
  • 统一的对话接口,支持平台上所有文本模型,包括 GPT、Claude、Gemini、DeepSeek 等,通过 model 参数切换。
  • 与 OpenAI Chat Completions 协议兼容,可以直接使用 OpenAI 官方 SDK。
  • 设置 "stream": true 后以 Server-Sent Events 流式返回;不设置时默认非流式,见 对话补全(非流式)。

鉴权

string
必填
Bearer <API Key>。在 API 密钥 页面创建。

请求参数

string
必填
模型 ID,例如 gpt-6、claude-sonnet-4-6、gemini-3.1-pro-preview。可用模型以 模型广场 和 模型列表接口 为准。
array
必填
对话消息列表,按时间顺序排列。
boolean
默认值:"false"
是否流式返回。设为 true 时以 text/event-stream 返回,每个事件以 data: 开头,最后以 data: [DONE] 结束。
object
流式选项,仅 stream 为 true 时生效。
number
采样温度,取值 0 到 2。值越高输出越随机,值越低越确定。不建议与 top_p 同时调整。
number
核采样阈值,取值 0 到 1。例如 0.1 表示只从累计概率前 10% 的 token 中采样。
integer
生成内容的最大 token 数。推理模型建议改用 max_completion_tokens。
integer
生成内容(含推理 token)的最大 token 数。
string
推理强度,适用于支持推理的模型。常用取值:low、medium、high。
string | string[]
停止序列,最多 4 个。生成内容遇到其中任意一个时停止。
integer
默认值:"1"
为每条输入生成的候选回复数量。部分模型只支持 1。
number
存在惩罚,取值 -2.0 到 2.0。正值鼓励模型谈论新话题。
number
频率惩罚,取值 -2.0 到 2.0。正值降低逐字重复的概率。
integer
随机种子。相同种子和参数下,模型会尽量返回相同结果。
array
模型可以调用的工具列表,目前支持 function 类型。用法见 对话补全(非流式) 中的工具调用示例。
string | object
工具调用策略:none 不调用、auto 由模型决定、required 必须调用,或通过 {"type": "function", "function": {"name": "..."}} 指定函数。
boolean
是否允许模型在一次回复中并行发起多个工具调用。
object
输出格式。{"type": "json_object"} 输出合法 JSON;{"type": "json_schema", "json_schema": {...}} 按给定 Schema 输出。
string
终端用户标识,用于上游的滥用监控。

流式响应

每个 SSE 事件的 data 是一个 chat.completion.chunk 对象。
string
本次补全的唯一 ID,同一次请求的所有数据块相同。
string
固定为 chat.completion.chunk。
integer
创建时间,Unix 时间戳(秒)。
string
实际使用的模型。
array
增量内容列表。
object | null
token 用量,只在开启 stream_options.include_usage 后的最后一个数据块中出现。字段含义见 对话补全(非流式)。
鉴权失败、余额不足、参数错误等问题在流开始前就会被发现,此时返回普通的 JSON 错误体和对应的 HTTP 状态码,而不是 SSE 流。