OpenAI
OpenAI 风格 Chat Completions、推理和代码模型聚合说明
OpenAI 系列统一使用 OpenAI Chat Completions 兼容接口。本页按调用协议说明 GPT、Codex 和 o 系列模型的共性参数与差异点。
接口路径
| 方法 | 路径 | 用途 |
|---|---|---|
| POST | /v1/chat/completions | 创建聊天补全、推理或代码生成请求 |
| GET | /v1/models | 查询当前令牌可用模型列表 |
| GET | /v1/models/{model} | 查询单个模型详情 |
请求结构
通用请求体使用 model 和 messages：
{
"model": "gpt-5.4",
"messages": [
{
"role": "user",
"content": "请用一句话介绍 Routescope API。"
}
],
"temperature": 0.7
}curl -X POST "https://api.routescope.ai/v1/chat/completions" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o-mini", "messages": [ { "role": "user", "content": "你好，请用一句话介绍自己。" } ] }'{
"id": "task_01JZ8M9Q4R7V2K8N9P0Q",
"object": "string",
"created": 1,
"model": "gpt-4o-mini",
"choices": [],
"usage": {
"prompt_tokens": 1,
"completion_tokens": 1,
"total_tokens": 1,
"input_tokens": 1,
"output_tokens": 1
}
}{
"error": null,
"message": "success"
}Authorization
BearerAuth
模型 relay 接口鉴权。请求头：Authorization: Bearer 。
In: header
Request Body
application/json
要调用的模型名称。
对话消息列表。 对话消息列表。范围：至少 1 条消息。
采样温度，值越大越发散。 采样温度。范围：0 到 2；值越大输出越随机。
0 <= value <= 2核采样参数。 核采样参数。范围：0 到 1；通常不要和 temperature 同时大幅调整。
0 <= value <= 1最大输出 Token 数。 最大输出 Token 数。范围：1 到模型上下文上限。
1 <= value是否启用 SSE 流式输出。 是否启用流式输出。范围：true 或 false。
流式扩展选项。不同上游支持情况不同。
是否开启深度思考模式。千问（Qwen）/阿里云百炼 OpenAI 兼容接口扩展参数：true 开启思考，false 关闭思考；部分仅思考模型始终开启且不支持关闭。Python OpenAI SDK 可通过 extra_body 传入。
可供模型调用的工具定义。 工具定义列表。范围：数组长度和 schema 复杂度以上游限制为准。
工具调用策略，例如 auto、none 或显式指定函数。 工具调用策略。范围：auto、none、required 或显式工具对象。
结构化输出约束，例如 JSON Schema。
终端用户标识，用于审计和风控。
Response Body
application/json
application/json
模型选择表
| 模型 ID | 能力类型 | 适用场景 |
|---|---|---|
gpt-5、gpt-5-2025-08-07 | 聊天补全 | 通用文本生成、多轮对话 |
gpt-5.1、gpt-5.1-2025-11-13、gpt-5.1-chat-latest | 聊天补全 | 通用对话、稳定版本或 latest 入口 |
gpt-5.2-2025-12-11、gpt-5.2-chat-latest | 聊天补全 | 通用对话、稳定版本或 latest 入口 |
gpt-5.3-chat-latest | 聊天补全 | latest 入口 |
gpt-5.4、gpt-5.4-2026-03-05、gpt-5.4-mini、gpt-5.4-mini-2026-03-17、gpt-5.4-nano、gpt-5.4-pro、gpt-5.4-pro-2026-03-05 | 聊天补全 | 通用、mini、nano、pro 不同档位 |
gpt-5-pro、gpt-5-pro-2025-10-06 | 聊天补全 | 高阶文本任务 |
gpt-5.1-codex-mini、gpt-5.1-codex、gpt-5.1-codex-max、gpt-5.2-codex、gpt-5.3-codex | 代码生成 | Codex / 代码任务 |
o3、o3-2025-04-16 | 推理 | 推理类任务 |
通用参数
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
model | string | 是 | 要调用的模型 ID。 |
messages | array | 是 | 对话消息列表，消息角色包括 system、user、assistant、tool。 |
temperature | number | 否 | 采样温度，OpenAPI schema 标注范围 0 到 2。 |
top_p | number | 否 | 核采样参数，OpenAPI schema 标注范围 0 到 1。 |
max_tokens | integer | 否 | 最大输出 Token 数，范围以模型上下文上限为准。 |
stream | boolean | 否 | 是否启用 SSE 流式输出。 |
tools | array | 否 | 工具定义列表。 |
tool_choice | string/object | 否 | 工具调用策略。 |
response_format | object | 否 | 结构化输出约束，例如 JSON Schema。 |
user | string | 否 | 终端用户标识，用于审计和风控。 |
模型差异参数
| 字段 | 适用模型 | 差异说明 |
|---|---|---|
model | 全部 | 从模型选择表或 /v1/models 复制当前令牌可用的模型 ID。 |
stream_options | 支持流式的 OpenAI 兼容模型 | OpenAPI schema 标注为流式扩展选项，不同上游支持情况不同。 |
enable_thinking | Qwen / 阿里云百炼 OpenAI 兼容扩展参数 | OpenAPI schema 中存在该字段，但不是 OpenAI GPT 系列通用字段；本页不放入 GPT 示例。 |
推理/代码模型能力 | o3、Codex 系列 | 没有统一的额外专属字段；以接口返回或页面实际展示为准。 |
响应结构
OpenAI 风格响应包含 id、object、created、model、choices 和 usage。如果 stream=true，实际会以 SSE 分块推送。
最后更新于