Dola Seed 2.0 Pro API

BytePlus Ark · ByteDance Seed 2.0 Pro (視覺多模態, 分檔計價 128K/256K)

POST /v1/chat/completions

dola-seed-2-0-pro:聊天完成,含必填項、巢狀響應和虛構示例。

基础调用

必填参数: model, messages

可用参数: model, messages, stream, max_tokens

请求参数

参数类型必填说明
modelstring是精确型号;仅使用本页名称,不用显示别名替代。 可选: dola-seed-2-0-pro
messagesarray是消息按对话顺序排列。
streamboolean否是否按 SSE 返回增量;不传时为非流式。
max_tokensinteger否可选输出长度限制;可见文本与思考用量不同,具体支持按本型号约定。
## 使用与响应约定 - 必填项与嵌套结构见参数表。未给出数值默认值的可选项,使用该型号当前默认配置。 - 不同型号的上下文、输出预算、素材数量与规格有差异;本页不把未核实的上限写成统一限制。 - 缺失字段与明确的0不同;读取实际返回的状态、内容与用量。 - 示例中的 `example.invalid` 地址必须换成自己有权使用、可被服务读取的素材。 - 生成文件请及时保存;不要假设结果链接永久有效。 ### 多轮与流式 基础示例是单次非流式调用。多轮调用需要保留本协议要求的历史消息;工具调用时应把调用标识与工具结果配对后再发下一轮。流式调用应按协议解析完整SSE事件,不能把任意一个网络分块当成完整JSON;检查最终事件或结束原因。可将已支持的stream选项设为true读取流式结果。 ## 参考 参数术语参考[OpenAI Chat Completions官方说明](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create);调用时使用本页平台域名和精确型号。文档核对日期:2026-11-07。 ## 完整嵌套字段说明 数组元素用[]表示;必填标记以所在对象或相应内容块成立为前提。响应字段可能按场景缺失或为null,不应补成虚构的0。 ### 请求头 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `Content-Type` | string | 是 | 请求体格式为application/json。 | ### 请求体 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `model` | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选值:dola-seed-2-0-pro | | `messages` | array[object] | 是 | 消息按对话顺序排列。 | | `messages[].role` | string | 是 | 消息角色。 可选值:system, user, assistant, tool | | `messages[].content` | string | 是 | 基础文本内容;多模态内容须使用该型号支持的内容块格式。 | | `messages[].tool_call_id` | string | 否 | 工具结果对应的调用标识,仅工具结果消息使用。 | | `stream` | boolean | 否 | 是否按 SSE 返回增量;不传时为非流式。 默认:false | | `max_tokens` | integer | 否 | 可选输出长度限制;可见文本与思考用量不同,具体支持按本型号约定。 最小值:1 | ### 响应 200 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `id` | string | 否 | 本次响应标识。 | | `object` | string | 否 | 响应对象类型。 | | `created` | integer | 否 | 创建时间,Unix 秒。 | | `model` | string | 否 | 响应中的型号名称。 | | `choices` | array[object] | 否 | 生成结果列表。 | | `choices[].index` | integer | 否 | 结果序号。 | | `choices[].message` | object | 否 | 生成的消息。 | | `choices[].message.role` | string | 否 | 响应消息角色。 | | `choices[].message.content` | string | 否 | 生成文本;工具或拒答场景可能为空。 | | `choices[].message.reasoning_content` | string | 否 | 模型提供时的思考内容,可能不返回。 | | `choices[].message.tool_calls` | array[object] | 否 | 模型发出的函数调用,仅适用型号返回。 | | `choices[].message.tool_calls[].id` | string | 否 | 调用标识。 | | `choices[].message.tool_calls[].type` | string | 否 | 调用类型。 | | `choices[].message.tool_calls[].function` | object | 否 | 函数调用内容。 | | `choices[].message.tool_calls[].function.name` | string | 否 | 函数名称。 | | `choices[].message.tool_calls[].function.arguments` | string | 否 | JSON 编码参数字符串。 | | `choices[].finish_reason` | string | 否 | 结束原因,如 stop、length、tool_calls;以实际返回为准。 | | `usage` | object | 否 | 本次请求返回的用量;未返回的分项不应自行补零。 | | `usage.prompt_tokens` | integer | 否 | 输入 Token 数。 | | `usage.completion_tokens` | integer | 否 | 输出 Token 数,可包含思考 Token。 | | `usage.total_tokens` | integer | 否 | 服务端报告的总 Token。 | | `usage.prompt_tokens_details` | object | 否 | 输入分项。 | | `usage.prompt_tokens_details.cached_tokens` | integer | 否 | 缓存命中 Token,属于输入分项。 | | `usage.completion_tokens_details` | object | 否 | 输出分项。 | | `usage.completion_tokens_details.reasoning_tokens` | integer | 否 | 思考 Token 分项,不要重复加到输出总数。 | ### 错误响应结构 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `error` | object | 否 | 错误详情;以本次返回为准。 | | `error.message` | string | 否 | 消息内容或可读错误说明,依所在对象区分。 | | `error.type` | string | 否 | 类型标识;依所在对象及枚举取值区分。 | | `error.code` | string | 否 | 错误码,可能为空。 |

请求示例

curl --request POST https://api.router.ai/v1/chat/completions \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "model": "dola-seed-2-0-pro",
  "messages": [
    {
      "role": "user",
      "content": "Describe a fictional blue paper boat in one sentence."
    }
  ],
  "stream": false
}'

接口通用说明: 建立對話請求 (OpenAI 相容)