Seedance 2.5 API · 火山引擎
Seedance 2.5 是 ByteDance 的多模态视频生成模型,可用文字、图片、视频或音频参考生成、编辑或延长片段。当前火山引擎规格提供 480p、720p、1080p 输出;通过 XiuAI 查看适用价格并接入异步视频 API。[1][2][5]
doubao-seedance-2-5-260628模型概览
供应商公开规格;实际调用范围以当前接口为准。
- 输入
- 文本、图片 URL、视频 URL、音频 URL
- 输出
- 视频,可包含同步音频
- 时长
- 4–30 秒
- 分辨率
- 480p / 720p / 1080p
- 参考上限
- 30 张图片 · 10 段视频 · 10 段音频
- 帧率
- 24 fps
- 接口
- Ark 原生 / 统一视频 API
适合哪些任务
产品或场景演示可以从文字描述开始,说明主体、运动和镜头变化;已有明确构图时,用首帧图片引导视频。需要多个参考的片段,可在提示词中说明每份素材用于外观、动作、运镜还是声音。[1][2]
已有视频也可作为编辑或延长的输入,描述要增加、移除或替换的内容。生成后仍需检查产品形状、画面文字和动作衔接;素材数量增加不保证结果更好。版本选择、成片审核和存储由你的应用安排。[1][2][6]
与 Flash 怎么选
先按输出要求和参考数量选择。2.5 的输出范围为 480p / 720p / 1080p;Flash 为 480p / 720p。2.5 最多接受 30 张图片、10 段视频、10 段音频,仍需满足各素材的组合限制。[2]
若 Flash 的规格已满足交付要求,可以比较两款在同样输入与输出条件下的当前费率和目录例价。主要关心处理速度或画面效果时,用自己的素材和请求评估;型号名称不代表固定耗时或质量保证。[2][5]
输入模式与关键参数
文生、首帧、首尾帧和全模态参考使用不同的输入角色。先选择模式,再检查 content 中每份素材的角色;首帧、首尾帧不能与全模态参考角色混用。URL 需在处理期间可供供应方读取,数量上限也不能替代格式、大小和累计时长要求。[2]
首帧、首尾帧、编辑和延长使用 ratio=adaptive;编辑还需要 duration=-1,让输出跟随参考视频。duration 描述成片长度,不是请求处理耗时。音频参考与 generate_audio 是不同选择,提交前分别核对。[2]
怎样理解生成费用
费用取决于视频 Token 用量与适用费率。分辨率、实际输出和参考视频会影响用量;含视频输入还需考虑最低计费用量。参考视频费率较低,不意味着总费用一定更低。比较成本时,同时核对输入条件、规格和用量。[3]
本页价格与费用示例取自当前目录。示例有自己的规格和用量假设,不是当前请求的报价,也不能平均成所有请求适用的固定每秒价格。每次主动创建的新生成任务分别计费,已发生费用请结合任务记录和请求记录核对。[5][3]
API 接入
通过 XiuAI 接入
沿用已有 XiuAI 账户、余额和有权限的 API Key。选择本页列出的可用协议,复制对应代码并检查准确 Model ID;Ark 原生和统一视频 API 的字段不同,不能混用。输入素材由你提供可访问 URL,生成结果由你下载保存。[5][6]
创建任务后保存返回的任务 ID,查询同一任务直至完成。离开调试页后可从使用记录继续查看任务,再用请求记录核对费用。提交结果不明确时先核对已有任务,不连续创建新任务;暂时查询失败不等于生成失败。[4][6]
将示例首帧 URL 替换为你的可访问地址。创建后使用返回的任务 ID 查询结果。
POST /api/v3/contents/generations/taskscurl 'https://router-api.xiu.ai/api/v3/contents/generations/tasks' \
-H "Authorization: Bearer $XIUAI_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"model": "doubao-seedance-2-5-260628",
"content": [
{
"type": "text",
"text": "Slowly push the camera toward a product on a desk, keeping its packaging text sharp."
},
{
"type": "image_url",
"image_url": {
"url": "https://assets.example.com/product.jpg"
},
"role": "first_frame"
}
],
"resolution": "720p",
"duration": 5,
"ratio": "adaptive",
"generate_audio": true
}'查询任务
curl https://router-api.xiu.ai/api/v3/contents/generations/tasks/$TASK_ID \
-H "Authorization: Bearer $XIUAI_API_KEY"查看完整 API 文档查看任务与费用记录任务与数据处理
- 异步交付
- 提交后按任务 ID 查询;关闭页面不表示取消生成。
- 结果下载
- 结果有效期以任务返回值为准,请在到期前保存到自己的存储。
- 素材与数据
- 使用客户提供的可访问 URL;XiuAI 不提供素材托管或创作工作流。
常见问题
可以只写提示词,不提供图片吗?
可以,选择文生视频。已有起始画面时使用首帧模式;同时指定起点和终点时使用首尾帧模式。需要多个素材引导时使用参考模式,并说明各素材的用途。[2]
支持哪些输出分辨率?输入规格是否等于输出规格?
当前火山引擎 2.5 输出规格为 480p、720p、1080p。输入视频能接受的分辨率与输出范围是两项不同限制,不能由输入规格推断更高的输出档位。[2]
参考素材达到数量上限就一定能提交吗?
不一定。数量只是一类限制,还需检查文件格式、大小、角色与累计时长。首帧和首尾帧角色不能与全模态参考角色混用;音频参考应按当前参数要求单独检查。[2]
编辑视频为什么要使用自动比例和时长?
编辑使用 ratio=adaptive 和 duration=-1,让输出跟随选中的参考视频。提示词需明确表达编辑意图,并满足待编辑视频的时长要求;参数与意图不一致仍可能使任务失败。[2]
为什么参考视频费率较低,总费用却不一定更低?
费用取决于视频 Token 用量与适用费率。分辨率、实际输出和参考视频会影响用量;含视频输入还需考虑最低计费用量。参考视频费率较低,不意味着总费用一定更低。比较成本时,同时核对输入条件、规格和用量。[3]
创建成功为什么只返回任务 ID?
创建回执确认任务已受理,不表示视频已完成。继续查询同一任务的状态,成功后取得结果。排队和生成时间会随规格与服务负载变化,成片时长不是处理耗时。[4]
相关模型
Seedance 2.5 Flash · 火山引擎资料来源与更新
规格参考供应商文档;价格与可用性来自当前 XiuAI 目录。 核对日期:2026-11-15
内容复审:2026-11-16
[1] ByteDance 模型介绍[2] 火山引擎创建参数[3] 火山引擎计价说明[4] 火山引擎任务查询[5] XiuAI 当前模型与价格数据[6] XiuAI 数据隐私说明