OpenAI Chat Completions

适用于已使用 OpenAI Chat Completions SDK 的应用。该接口支持普通 JSON 同步响应，也支持 Server-Sent Events（SSE）流式响应。

请求鉴权

使用 OpenAI Bearer 认证：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

正式接口

POST /v1/chat/completions

完整地址：https://your-domain/v1/chat/completions。

请求参数

字段	类型	必填	说明
`model`	`string`	是	当前 API Key 可见的模型名称。本文档最小验证模型为 `gpt-5.4`。
`messages`	`array`	是	对话消息数组。最小文本请求使用 `role` 和字符串 `content`。
`temperature`	`number`	否	采样随机性。未设置时使用模型默认值。
`top_p`	`number`	否	核采样参数。通常与 `temperature` 二选一调整。
`max_tokens`	`integer`	否	最大生成 token 数。当前网关已验证该字段。
`stream`	`boolean`	否	是否使用 SSE 流式返回，默认 `false`。
`stream_options.include_usage`	`boolean`	否	仅流式调用使用。传 `true` 时，最终 SSE chunk 会附带 usage。

非流式调用

curl --request POST \
  --url https://your-domain/v1/chat/completions \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "只回复 OK"}],
    "max_tokens": 8,
    "stream": false
  }'

成功响应

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1770000000,
  "model": "gpt-5.4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "OK"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 1,
    "total_tokens": 9
  }
}

从 choices[0].message.content 读取生成文本。用量从 usage.prompt_tokens、usage.completion_tokens 和 usage.total_tokens 读取。

流式调用

将 stream 设为 true。如果需要在流结束时取得用量，同时传入 stream_options.include_usage: true：

curl --no-buffer --request POST \
  --url https://your-domain/v1/chat/completions \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "只回复 OK"}],
    "max_tokens": 8,
    "stream": true,
    "stream_options": {"include_usage": true}
  }'

SSE 返回以多条 data: 事件组成。消费 choices[].delta.content 中的增量文本；最后读取带 usage 的 chunk，并以 data: [DONE] 作为完成标志：

data: {"object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"OK"},"finish_reason":null}]}

data: {"object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{"prompt_tokens":8,"completion_tokens":1,"total_tokens":9}}

data: [DONE]

注意事项

同一请求只选择一个协议页的格式，不要把 Responses 的 input 或 Claude 的请求头混入本接口。
stream_options.include_usage 只在 stream: true 时使用；客户端应将最终 usage chunk 与文本增量分开处理。
本页只承诺纯文本 messages 调用，不承诺未经验证的工具调用、图像输入或其他扩展字段。

开始使用

文本系列

图像系列

视频系列

音频系列

OpenAI Chat Completions

OpenAI Chat Completions

请求鉴权

正式接口

请求参数

非流式调用

成功响应

流式调用

注意事项

​OpenAI Chat Completions

​请求鉴权

​正式接口

​请求参数

​非流式调用

​成功响应

​流式调用

​注意事项

OpenAI Chat Completions

请求鉴权

正式接口

请求参数

非流式调用

成功响应

流式调用

注意事项