ByteDance Doubao

先分清直连与本站网关

火山方舟直连的数据面 Base URL 是 https://ark.cn-beijing.volces.com/api/v3，使用方舟项目内 API Key；控制面则使用 ark.cn-beijing.volcengineapi.com，不能当成模型推理地址。本站网关使用本站 Base URL 与本站 Bearer 令牌，本页当前只声明 /v1/chat/completions。官方文档推荐新项目评估 Responses，但这不代表本站已暴露同名入口。

Model ID、Endpoint ID 与本站模型名

控制台展示名称用于阅读，预置模型调用通常填写 Model ID，例如官方首调示例中的 doubao-seed-2-1-pro-260628；自定义推理部署才涉及 Endpoint ID。本站客户端应填写本站模型列表中实际启用的名称，因为管理员可能把它映射到官方 Model ID 或 Endpoint ID。不要把三者互相盲拷。

认证、项目与协议边界

方舟 API Key 属于具体项目，可限制模型、自定义 Endpoint 和来源 IP，不能跨项目使用。官方 OpenAI 兼容扩展参数常通过 extra_body 传递；向量化等能力不一定支持 OpenAI 兼容协议。媒体生成还有独立任务流程，不能因为同属豆包品牌就套用 Chat 请求。

流式、工具与错误

官方 Chat 与 Responses 的 SSE 事件结构不同，Responses 不能按 Chat delta 解析。联网搜索、知识库、MCP 和函数工具还取决于模型与协议；应用需校验函数参数并控制副作用。流中也可能返回业务错误，此时 HTTP 可能已是 200，应继续读取事件中的 error.type 和请求 ID。

费用安全与上线检查

Coding Plan 使用独立 Base URL，误用按量地址可能产生套餐外费用。设置最大输出、并发、超时、有限重试和账户告警，并核对工具、缓存及媒体计费。上线前确认地域、项目、Key 权限、模型或 Endpoint 标识、协议支持、内容审核和当前价格。