跳转到主要内容
POST https://api.poixe.com/v1/chat/completions
这是 OpenAI 最早、最经典的对话协议,目前兼容性最好,几乎所有厂商与 SDK 都支持。 但它的能力相对有限,OpenAI 新推出的模型有许多新特性更倾向在 Responses 协议 中提供。如果只是轻量对话与基础流式输出,用它就足够。

鉴权与请求头

所有 API 请求都必须在 HTTP Header 中包含您的 API 密钥。
Authorization
string
必填
Bearer Token。格式为 Bearer YOUR_API_KEY
Content-Type
string
必填
必须设置为 application/json

请求参数

以下是构建对话请求时最常用的核心参数。
model
string
必填
请求的模型名称。例如:gpt-4o, gpt-4o-mini 等。
messages
object[]
必填
对话消息列表。
stream
boolean
默认值:"false"
是否流式输出。开启后,服务器将通过 SSE (Server-Sent Events) 逐字发送 Token。
temperature
number
默认值:"1"
采样温度(0~2)。较低的值(如 0.2)使输出更聚焦且确定;较高的值(如 0.8)使输出更具创意和随机性。
top_p
number
默认值:"1"
核采样(nucleus sampling)。通常与 temperature 二选一调整即可。
max_completion_tokens
integer
模型生成内容的最大 Token 限制(包含推理 Token)。建议用于替代已弃用的 max_tokens
n
integer
默认值:"1"
返回多少个候选回复(choices)。为降低成本建议保持 1
presence_penalty
number
默认值:"0"
话题惩罚(-2~2):鼓励生成新话题(更少重复)。
frequency_penalty
number
默认值:"0"
频率惩罚(-2~2):降低重复用词/句子的概率。
tools
object[]
工具列表(函数调用)。
tool_choice
string | object
工具调用策略:none / auto / required,或强制指定某个 tool。
response_format
object
输出格式控制。

响应结构

接口返回一个包含生成结果及消耗统计的对象。
id
string
本次请求的唯一标识符。
object
string
对象类型,通常为 chat.completion
created
integer
创建时间(Unix 秒级时间戳)。
model
string
实际处理请求的模型名称。
choices
object[]
生成结果列表(通常只有 1 条)。
usage
object
Token 用量统计(如有返回)。

官方文档:Create chat completion

查看 OpenAI 官方参数说明与示例。