byteplus/seed-2-0-pro-260328 的 API 参考,由 Comfy Router 从 BytePlus 提供。
快速开始
在你的 Comfy 工作区中创建一个密钥,并将其导出为COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk);cURL 代码片段是通过原生 HTTP 发起的同一调用。
模型 ID: byteplus/seed-2-0-pro-260328
端点: POST https://api.comfy.org/v2/models/byteplus/seed-2-0-pro-260328
- Wait for the result
- Queue and collect later
Schema
输入
object
上下文缓存配置。
boolean
默认值:"false"
当为是时,仅创建公共前缀缓存;模型不会作出响应。
string
可选值:
enabled、disabledobject
上下文管理策略(
clear_thinking、clear_tool_uses),用于保持上下文窗口可控。object[]
单个上下文编辑策略,由
type 区分。integer
存储的响应与缓存的过期时间,Unix 时间戳(秒,UTC)。范围 (creation_time, creation_time + 604800]。默认:creation_time + 259200(3 天)。
string[]
需要额外包含的输出字段。当前支持:
reasoning.encrypted_content(加密并压缩的推理内容,供手动多轮复用)。string | object[]
必填
提供给模型的文本内容或输入项列表。
string
作为第一条指令前置的系统/开发者消息。与
caching 不兼容:如果 caching.type 为 enabled,设置 instructions 会返回错误。integer
最大输出 token 数(响应 + 思维链)。
integer
范围:
1 到 10string
模型 ID 或 Endpoint ID。模型列表见 https://docs.byteplus.com/en/docs/ModelArk/1330310,Endpoint ID 见 https://docs.byteplus.com/en/docs/ModelArk/1099522。直接对 POST /proxy/byteplus/api/v3/responses 发起 v1 调用时,必须提供该字段:代理会拒绝不在其自身允许列表中的任何值,缺省时则返回 400。它不在 Comfy Router 输入 schema 的
required 列表中,因为 Router 会从 /v2/models/byteplus/{model} 的 {model} 路径段填充该字段,因此 Router 调用方会省略它。string
上一个响应的 ID,用于继续多轮对话。请求之间插入约 100ms 的间隔可避免失败。
object
限制深度思考的工作量。
string
minimal 会完全禁用思考。当 thinking.type = disabled 时,仅允许使用 minimal。可选值:minimal、low、medium、highboolean
默认值:"true"
当为是时,响应会被持久化,并可通过 ID 检索以用于多轮对话。
number
默认值:"1"
范围:
0 到 2格式:floatobject
输出格式配置。
object
由
type 区分的文本输出格式。text 返回自然语言,json_object 返回自由形式的 JSON 对象,json_schema 将输出约束为调用方提供的 JSON Schema。object
控制深度思考模式。
string
enabled:始终先推理再响应。
disabled:不作额外推理直接响应。
auto:由模型按查询自行决定。可选值:enabled、disabled、auto`none`, `auto`, `required` | object
工具选择模式。仅 seed-1-6 模型支持该字段。
object[]
模型可以调用的工具。目前仅支持
function。string
string
必填
object
必填
描述函数参数的 JSON Schema。
string
默认值:"\"function\""
必填
可选值:
functionnumber
默认值:"0.7"
范围:
0 到 1格式:floatGET /v2/models/byteplus/seed-2-0-pro-260328/openapi.json 提供的 schema 生成,即请求到达提供商之前用于校验调用的同一份文档。
输出
object
boolean
string
可能的值:
enabled、disabledobject
本次响应中实际应用的上下文管理策略。与请求侧的
BytePlusResponseContextManagement(用于配置策略)不同,此处回显的是服务器实际调用的策略,并附上被清理内容的数量。object[]
一条已应用的上下文编辑,通过
type 区分。integer
必填
响应创建时的 Unix 时间戳(秒)。
object
错误详情。响应成功时为 null。
string
必填
string
必填
integer
所存储响应过期时的 Unix 时间戳(秒)。
string
必填
响应的唯一 ID。可作为
previous_response_id 用于继续对话。object
当
status 为 incomplete 时填充。string
例如
max_output_tokens、content_filter。string
请求中
instructions 字段的回显。integer
integer
object
string
必填
生成该响应的模型 ID。
string
默认值:"\"response\""
必填
可能的值:
responseobject[]
必填
模型按顺序产生的输出项。
string
object
string
可能的值:
minimal、low、medium、highstring
TPM 保障包的使用情况。
default 表示未使用。可能的值:defaultstring
必填
可能的值:
in_progress、completed、incomplete、failed、cancelledboolean
boolean
number
格式:
floatobject
请求中
text 字段的回显。object
通过
type 区分的文本输出格式。text 返回自然语言,json_object 返回自由形式的 JSON 对象,json_schema 将输出约束为调用方提供的 JSON Schema。object
string
可能的值:
enabled、disabled、auto`none`, `auto`, `required` | object
object[]
模型可调用的工具。目前仅支持
function。string
string
必填
object
必填
描述该函数参数的 JSON Schema。
string
默认值:"\"function\""
必填
可能的值:
functionnumber
格式:
floatobject
用于计费和可观测性的 token 用量明细。
integer
必填
请求中的 token 总数。
object
输入 token 的明细(缓存命中数等)。
integer
由上下文缓存提供的 token 数。
integer
必填
模型生成的 token 总数。
object
输出 token 的明细(推理等)。
integer
思维链消耗的 token 数。
object
各工具的调用次数。
integer
图像处理工具的调用次数。
integer
MCP 工具的调用次数。
integer
web 搜索工具的调用次数。
object
各工具下子工具调用次数的明细。
object
例如
{"zoom":1,"point":1,"grounding":1}。object
例如
{"mcp_server_tos":1,"mcp_server_tls":1}。object
例如
{"toutiao":1,"moji":1,"search_engine":1}。integer
必填
input_tokens + output_tokens。
示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、校验错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。