Doubao 概览

本页面面向 普通 API 使用者（非管理员），帮助你快速搞清楚三件事：

1. Doubao / VolcArk 能做什么；
2. 你需要记住哪些模型名；
3. 想要实现某个能力，该去看哪一篇文档、调用哪个接口。

你可以把 Doubao / VolcArk 理解为：

• 由 火山引擎方舟（VolcArk） 提供的一组大模型与多模态能力；
• 在 kapon 中，通过统一的 OpenAI 风格 API 暴露出来（/v1/chat/completions、/v1/responses、/v1/images/generations、/v1/videos 等）；
• 包含豆包自研模型，以及通过方舟聚合的 DeepSeek / Kimi 等模型。

你只需要会用 kapon 的 API Key 和模型名，不需要管理渠道、密钥和控制台配置。

---

​

一、快速上手：Doubao 能力一览

在文档左侧的 “Doubao” Tab 下，你可以找到几类能力：

• 文本 & 多模态对话
  • 使用 /v1/chat/completions 或 /v1/responses；
  • 代表模型：
    • 豆包：doubao-seed-1.6、doubao-seed-1.6-lite、doubao-seed-1.6-flash、doubao-seed-1.6-thinking、doubao-seed-1.6-vision
    • DeepSeek：deepseek-v3.1、deepseek-v3、deepseek-r1-ark
    • Kimi：kimi-k2
  • 详见：doubao/chat
• 图片生成（文生图 / 图生图 / 组图）
  • 使用 /v1/images/generations；
  • 代表模型：doubao-seedream-4.0、doubao-seedream-3.0-t2i、doubao-seededit-3.0-i2i
  • 详见：doubao/image、doubao/image-seedream-4.0-n
• 视频生成（文生视频 / 图生视频）
  • 两种调用方式：
    • VolcArk 原生接口：/volcark/api/v3/contents/generations/tasks（更贴近官方文档）
    • OpenAI 风格接口：/v1/videos（与 OpenAI Sora/Veo 一致）
  • 代表模型：doubao-seedance-1-0-pro、doubao-seedance-1-0-pro-fast、doubao-seedance-1-0-lite-t2v、doubao-seedance-1-0-lite-i2v
  • 详见：doubao/video、doubao/video-openai
• 语音合成（TTS）
  • 使用 Volcengine OpenSpeech 接口透传：/volcark/openspeech/...
  • 支持 V1 / V3 HTTP 与 WebSocket；
  • 详见：doubao/volcark-tts

可以简单理解为：

• “对话 / Agent / 工具调用” → 看 doubao/chat；
• “画图 / 图生图 / 组图” → 看 doubao/image；
• “文生视频 / 图生视频” → 看 doubao/video / doubao/video-openai；
• “TTS 语音合成” → 看 doubao/volcark-tts。

---

​

二、模型名怎么填？（API 模型名）

作为 API 调用者，你只需要记住 API 模型名，例如：

• Doubao 文本模型：
  • doubao-seed-1.6
  • doubao-seed-1.6-lite
  • doubao-seed-1.6-flash
  • doubao-seed-1.6-thinking
  • doubao-seed-1.6-vision
• Doubao 辅助模型：
  • doubao-seed-code
  • doubao-seed-translation
• 聚合模型（通过火山方舟）：
  • deepseek-v3.1
  • deepseek-v3
  • deepseek-r1-ark
  • kimi-k2

在 kapon 内部，这些 API 模型名会自动映射为真实的上游版本 ID（带日期后缀的长名字），例如：

对你来说最重要的一点： 只在请求体里填 API 模型名，其他的都交给平台处理。

如果你在请求时遇到：

InvalidEndpointOrModel.NotFound
The model or endpoint xxx does not exist or you do not have access to it.

可以优先检查：

• 是否手误输入了模型名，例如 doubau-seed-1.6；
• 是否复制了带日期后缀的内部 ID（如 doubao-seed-1-6-...），而不是文档中的 API 名。

仍然不确定时，建议：

• 到 kapon 控制台的「模型价格」页面确认是否能看到该模型名；
• 或直接联系管理员确认当前账号是否有权限使用对应模型。

---

​

三、如何选 Doubao / DeepSeek / Kimi 模型？

如果你只想“先跑通再优化”，可以直接按下面的建议来选：

• 通用中文/英文对话助手
  • 首选：doubao-seed-1.6
  • 低成本版本：doubao-seed-1.6-lite
  • 对响应速度敏感：doubao-seed-1.6-flash
• 需要更强的思考与推理能力
  • Doubao 深度思考：doubao-seed-1.6-thinking
  • DeepSeek 思考增强：deepseek-v3.1、deepseek-r1-ark
  • Kimi 思维链：kimi-k2
• 需要代码能力 / 工程场景
  • 首选：doubao-seed-code
  • 也可以尝试：deepseek-v3.1 / deepseek-v3（开源社区生态更丰富）
• 翻译与多语种写作
  • 首选：doubao-seed-translation
  • 对上下文理解要求高时，可使用 doubao-seed-1.6 作为通用翻译/润色模型。
• 需要看图 / 图文问答
  • 使用：doubao-seed-1.6-vision
  • 调用方式与 OpenAI Vision 模型一致，在 messages.content 中混合文字与 image_url。

更详细的请求示例与字段说明，请参考：

• 文本 / 多模态对话：doubao/chat
• 图片生成：doubao/image
• 视频生成：doubao/video、doubao/video-openai
• 语音合成：doubao/volcark-tts

---

​

四、你不需要关心的事情

作为普通 API 调用者，你 不需要：

• 在火山方舟控制台里开通或配置模型；
• 管理 VolcArk 的 BaseURL、密钥、签名算法；
• 决定渠道如何路由、如何做负载均衡、如何定价。

这些工作都由平台和管理员负责。
你只需要：

1. 在 kapon 控制台获取一个 API Key（oh-xxxxxxxx）；
2. 在文档中选好模型名（例如 doubao-seed-1.6）；
3. 按 OpenAI 的方式调用 /v1/chat/completions、/v1/responses、/v1/images/generations 或 /v1/videos 即可。

其它诸如：模型版本升级、价格变更、上游 ID 更新、渠道切换等，都在后台自动完成，不影响你的调用方式。