Appearance
Doubao 概览
面向普通 API 调用者的 Doubao / VolcArk 能力说明
本页面面向 普通 API 使用者(非管理员),帮助你快速搞清楚三件事:
- Doubao / VolcArk 能做什么;
- 你需要记住哪些模型名;
- 想要实现某个能力,该去看哪一篇文档、调用哪个接口。
你可以把 Doubao / VolcArk 理解为:
- 由 火山引擎方舟(VolcArk) 提供的一组大模型与多模态能力;
- 在 Fhddos 中,通过统一的 OpenAI 风格 API 暴露出来(
/v1/chat/completions、/v1/responses、/v1/images/generations、/v1/videos等); - 包含豆包自研模型,以及通过方舟聚合的 DeepSeek / Kimi 等模型。
你只需要会用 Fhddos 的 API Key 和模型名,不需要管理渠道、密钥和控制台配置。
一、快速上手:Doubao 能力一览
在文档左侧的 “Doubao” Tab 下,你可以找到几类能力:
文本 & 多模态对话
- 使用
/v1/chat/completions或/v1/responses; - 代表模型:
- 豆包:
doubao-seed-1.8、doubao-seed-1.6、doubao-seed-1.6-lite、doubao-seed-1.6-flash、doubao-seed-1.6-vision(兼容别名:doubao-seed-1.6-thinking) - DeepSeek:
deepseek-v3.2、deepseek-v3.1、deepseek-v3、deepseek-r1-ark - Kimi:
kimi-k2 - GLM:
glm-4.7(需管理员在 VolcArk 渠道启用)
- 豆包:
- 详见:
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 一致)
- VolcArk 原生接口:
- 代表模型:
doubao-seedance-2-5、dreamina-seedance-2-5、doubao-seedance-2-0、doubao-seedance-1-0-pro - 详见:
doubao/seedance-2-5、doubao/doubao-seedance-2-0、doubao/byteplus-seedance-2-0、doubao/video
- 两种调用方式:
真人素材库(真人认证 / LivenessFace)
- 把本人授权并通过活体认证的图片、视频或音频保存为可信素材,再以
asset://提交给 Seedance; - 接口入口:
/volcark/?Action=...&Version=2024-01-01 - 详见:
doubao/real-person-assets
- 把本人授权并通过活体认证的图片、视频或音频保存为可信素材,再以
语音合成(TTS)
- 使用 Volcengine OpenSpeech 接口透传:
/volcark/openspeech/... - 支持 V1 / V3 HTTP 与 WebSocket;
- 详见:
doubao/volcark-tts
- 使用 Volcengine OpenSpeech 接口透传:
可以简单理解为:
- “对话 / Agent / 工具调用” → 看
doubao/chat; - “画图 / 图生图 / 组图” → 看
doubao/image; - “Seedance 2.5 / 文生视频 / 多模态视频编辑” → 看
doubao/seedance-2-5; - “Seedance 1.x / 2.0 视频” → 看
doubao/video和对应的 2.0 专页; - “真人认证 / 真人素材” → 看
doubao/real-person-assets; - “TTS 语音合成” → 看
doubao/volcark-tts。
二、模型名怎么填?(API 模型名)
作为 API 调用者,你只需要记住 API 模型名,例如:
- Doubao 文本模型:
doubao-seed-1.8doubao-seed-1.6doubao-seed-1.6-litedoubao-seed-1.6-flashdoubao-seed-1.6-visiondoubao-seed-1.6-thinking(兼容别名)
- Doubao 辅助模型:
doubao-seed-codedoubao-seed-translation
- 聚合模型(通过火山方舟):
deepseek-v3.2deepseek-v3.1deepseek-v3deepseek-r1-arkkimi-k2glm-4.7(需管理员在 VolcArk 渠道启用)
在 Fhddos 内部,这些 API 模型名会自动映射为真实的上游版本 ID(带日期后缀的长名字),例如:
| API 模型名 | 后台实际模型 ID(示例,仅供理解) |
|---|---|
doubao-seed-1.8 | doubao-seed-1-8-251228 |
doubao-seed-1.6 | doubao-seed-1-6-251015 |
doubao-seed-1.6-lite | doubao-seed-1-6-lite-251015 |
doubao-seed-1.6-flash | doubao-seed-1-6-flash-250828 |
doubao-seed-1.6-vision | doubao-seed-1-6-vision-250815 |
doubao-seed-1.6-thinking | doubao-seed-1-8-251228 |
doubao-seed-code | doubao-seed-code-preview-251028 |
doubao-seed-translation | doubao-seed-translation-250915 |
deepseek-v3.2 | deepseek-v3-2-251201 |
deepseek-v3.1 | deepseek-v3-1-terminus / deepseek-v3-1-250821 |
deepseek-v3 | deepseek-v3-250324 |
deepseek-r1-ark | deepseek-r1-250528 |
glm-4.7 | glm-4-7-251222 |
kimi-k2 | kimi-k2-thinking-251104 |
对你来说最重要的一点: 只在请求体里填 API 模型名,其他的都交给平台处理。
如果你在请求时遇到:
InvalidEndpointOrModel.NotFoundThe 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 名。
仍然不确定时,建议:
- 到 Fhddos 控制台的「模型价格」页面确认是否能看到该模型名;
- 或直接联系管理员确认当前账号是否有权限使用对应模型。
三、如何选 Doubao / DeepSeek / Kimi 模型?
如果你只想“先跑通再优化”,可以直接按下面的建议来选:
通用中文/英文对话助手
- 首选:
doubao-seed-1.8 - 稳定兼容:
doubao-seed-1.6 - 低成本版本:
doubao-seed-1.6-lite - 对响应速度敏感:
doubao-seed-1.6-flash
- 首选:
需要更强的思考与推理能力
- Doubao 深度思考:
doubao-seed-1.8(doubao-seed-1.6-thinking为兼容别名) - DeepSeek 思考增强:
deepseek-v3.2、deepseek-v3.1、deepseek-r1-ark - Kimi 思维链:
kimi-k2
- Doubao 深度思考:
需要代码能力 / 工程场景
- 首选:
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/seedance-2-5、doubao/video、doubao/video-openai - 真人素材库:
doubao/real-person-assets - 语音合成:
doubao/volcark-tts
四、你不需要关心的事情
作为普通 API 调用者,你 不需要:
- 在火山方舟控制台里开通或配置模型;
- 管理 VolcArk 的 BaseURL、密钥、签名算法;
- 决定渠道如何路由、如何做负载均衡、如何定价。
这些工作都由平台和管理员负责。 你只需要:
- 在 Fhddos 控制台获取一个 API Key(
oh-xxxxxxxx); - 在文档中选好模型名(例如
doubao-seed-1.6); - 按 OpenAI 的方式调用
/v1/chat/completions、/v1/responses、/v1/images/generations或/v1/videos即可。
其它诸如:模型版本升级、价格变更、上游 ID 更新、渠道切换等,都在后台自动完成,不影响你的调用方式。