GPT
GPT-5.4 · 对话补全
文本 / GPT / GPT-5.4 / 对话补全
接口
POST /v1/chat/completions
Content-Type: application/json
Authorization: Bearer $API_KEY
OpenAI 兼容的对话补全接口，支持多轮对话与流式输出。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID，固定为 gpt-5.4 |
messages | array | 是 | 对话消息列表，每条含 role（system / user / assistant）与 content |
stream | bool | 否 | 是否流式返回（SSE），默认 false |
temperature | number | 否 | 采样温度，越大越随机 |
top_p | number | 否 | 核采样，与 temperature 二选一。范围 0–1 |
max_tokens | int | 否 | 最大生成 token 数 |
n | int | 否 | 生成的候选回复数，默认 1 |
stop | array | 否 | 停止序列；命中任一即停止输出 |
presence_penalty | number | 否 | 对已出现过的 token 施加惩罚以提升新意。范围 -2–2 |
frequency_penalty | number | 否 | 按出现频率惩罚 token 以减少重复。范围 -2–2 |
logprobs | bool | 否 | 是否返回输出 token 的对数概率 |
top_logprobs | int | 否 | 每个位置返回最可能的 token 数（需配合 logprobs） |
seed | int | 否 | 采样随机种子，尽力保证可复现 |
reasoning_effort | string | 否 | 思考型模型的推理深度：low / medium / high |
tools | array | 否 | 工具 / 函数定义（function calling） |
tool_choice | string/object | 否 | 是否及调用哪个工具：auto / none / 指定工具 |
parallel_tool_calls | bool | 否 | 是否允许并行调用多个工具 |
response_format | object | 否 | 约束输出格式，例如强制输出 JSON 对象 |
user | string | 否 | 终端用户标识，用于滥用监控 |
以上为标准 OpenAI Chat Completions 字段。其他 OpenAI 兼容字段原样透传给上游模型。
示例
curl https://api.beerouter.ai/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"messages": [
{ "role": "user", "content": "你好，介绍一下你自己" }
]
}'
流式
把 stream 设为 true，响应以 SSE 数据块逐条返回，最后以 data: [DONE] 结束。
响应
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"created": 1730000000,
"model": "gpt-5.4",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "你好！很高兴见到你……" },
"finish_reason": "stop"
}
],
"usage": { "prompt_tokens": 12, "completion_tokens": 24, "total_tokens": 36 }
}