Doubao
Doubao 文本、代码与角色对话模型聚合说明
Doubao 文本能力统一使用 OpenAI Chat Completions 兼容接口。本页按聊天、代码生成和角色对话等用途说明常用模型与参数。
接口路径
| 方法 | 路径 | 用途 |
|---|---|---|
| POST | /v1/chat/completions | 创建 Doubao 文本、代码或角色对话请求 |
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 | 能力类型 | 适用场景 |
|---|---|---|
doubao-seed-1-8-251228 | 聊天补全 | 通用文本对话 |
doubao-seed-2-0-lite-260215 | 聊天补全 | 轻量文本对话 |
doubao-seed-2-0-mini-260215 | 聊天补全 | 轻量文本对话 |
doubao-seed-2-0-pro-260215 | 聊天补全 | 更复杂的文本对话 |
doubao-seed-2-0-code-preview-260215 | 代码生成 | 代码相关任务 |
doubao-seed-code-preview-251028 | 代码生成 | 代码相关任务 |
doubao-seed-character-251128 | 角色对话 | 角色扮演或人格化对话 |
通用参数
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
model | string | 是 | Doubao 模型 ID。 |
messages | array | 是 | OpenAI 风格对话消息列表。 |
temperature | number | 否 | 采样温度，范围以接口说明或后台配置为准。 |
top_p | number | 否 | 核采样参数。 |
max_tokens | integer | 否 | 最大输出 Token 数。 |
stream | boolean | 否 | 是否启用流式输出。 |
tools | array | 否 | 工具定义列表。 |
response_format | object | 否 | 结构化输出约束。 |
user | string | 否 | 终端用户标识。 |
模型差异参数
| 字段 | 适用模型 | 差异说明 |
|---|---|---|
model | 全部 Doubao 文本模型 | 请求体中通过 model 区分具体模型。 |
代码任务提示词 | doubao-seed-2-0-code-preview-260215、doubao-seed-code-preview-251028 | 用途为代码生成，但接口和参数仍为 Chat Completions。 |
角色对话提示词 | doubao-seed-character-251128 | 用途为角色对话，但接口和参数仍为 Chat Completions。 |
其他专属参数 | 全部 | 未统一列出模型专属字段；以接口返回或页面实际展示为准。 |
示例代码
curl https://api.routescope.ai/v1/chat/completions \
-H "Authorization: Bearer $ROUTESCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seed-2-0-pro-260215",
"messages": [
{ "role": "user", "content": "给我一个 API 网关的中文一句话介绍。" }
]
}'响应结构
Doubao 文本页使用 OpenAI Chat Completions 风格响应，包含 choices 和 usage 等字段。
最后更新于