GPT
GPT-5.4 nano · 对话补全
文本 / GPT / GPT-5.4 nano / 对话补全
接口
POST /v1/chat/completions
Content-Type: application/json
Authorization: Bearer $API_KEY
OpenAI 兼容的对话补全接口,支持多轮对话与流式输出。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID,固定为 gpt-5.4-nano |
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-nano",
"messages": [
{ "role": "user", "content": "你好,介绍一下你自己" }
]
}'
流式
把 stream 设为 true,响应以 SSE 数据块逐条返回,最后以 data: [DONE] 结束。
响应
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"created": 1730000000,
"model": "gpt-5.4-nano",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "你好!很高兴见到你……" },
"finish_reason": "stop"
}
],
"usage": { "prompt_tokens": 12, "completion_tokens": 24, "total_tokens": 36 }
}

