跳转到主要内容
POST
通过 POST /v1/videos/generations 提交任务,从 data[0].task_id 获取任务 ID,再调用 GET /v1/tasks/{task_id} 查询结果。
string
必填
使用 Authorization: Bearer <token>,其中 <token> 为你的 APIMart API Key。

请求参数

string
必填
使用 seedance-2-5-flash。也接受 doubao-seedance-2-5-flash;带点写法 seedance-2.5-flash 不受支持。
boolean
默认值:"false"
是否在提交视频任务前执行内容审核。
  • true:使用 omni-moderation-latest 审核提示词和输入图片
  • false 或不传:不发起审核请求,不增加审核成本与延迟(默认)
命中时同步返回 HTTP 400(nsfw_content_detected),不创建任务、不扣生成费用。参考视频和音频不送审;审核服务异常时请求可能继续提交。
string
必填
必填提示词。可用 @图片1 / @视频1 / @音频1 指代参考素材,下标从 1 开始,对应各类数组的顺序。
string
默认值:"720p"
仅支持 480p / 720p,默认 720p。传入 1080p、2k、4k 等值同步返回 HTTP 400。
string
默认值:"adaptive"
支持 16:9、4:3、1:1、3:4、9:16、21:9、adaptive(默认);别名为 aspect_ratio。首帧 / 首尾帧、视频编辑和延长只能使用 adaptive。
integer
整数秒 4–30,普通请求省略时为 5;-1 表示由模型决定。显式 edit 只能传 -1 或省略,省略时按 -1 处理,输出时长跟随源视频。自动时长预扣按 30 秒计算,完成后按实际 token 用量结算。
boolean
默认值:"true"
是否生成声音,默认 true;别名为 audio。与输入参考音频 audio_urls 不同。
boolean
默认值:"false"
是否添加 AI 生成水印,默认 false。
integer
可选随机种子;相同种子不保证结果完全一致。
string
默认值:"mp4"
输出封装格式,支持 mp4(默认)或 mov。
string
默认值:"auto"
支持 auto(默认)、reference、edit、extend,只用于带参考素材的任务。显式指定类型时在提交阶段校验对应限制,见下方任务类型表。
string[]
参考图数组,均按 reference_image 处理。与 image_with_roles 中的图片合计最多 10 张。首尾帧请使用 image_with_roles。
object[]
每项包含 url 和 role。role 支持 reference_image、first_frame(最多 1 张)、last_frame(最多 1 张,与首帧配合)。与 image_urls 合计最多 10 张;不要混用冲突的图片角色。存在 video_urls / audio_urls 时,首尾帧会转为参考图参与多模态任务。
string[]
最多 5 个参考视频,单个 2–30 秒,合计不超过 30 秒。视频编辑的源视频须为 4–30 秒。
string[]
最多 5 段参考音频,单段 2–30 秒,合计不超过 30 秒。支持纯音频参考,可不配图片或视频。
boolean
默认值:"false"
设为 true 时,成功后额外返回尾帧图片,地址位于 data.result.videos[].last_frame_url。
是否允许模型按需联网搜索,默认 false。
object[]
可选工具列表,例如 [{"type":"web_search"}],用于联网搜索。
不支持 draft / draft_task_id,请从请求中移除;传入样片字段会同步返回 HTTP 400。需要样片功能时使用 Seedance 2.5。

素材要求

素材使用公网可访问的 http(s) 链接,或已审核通过的 asset:// 素材 ID。输出分辨率与输入视频的像素限制分别校验。

任务类型与限制

显式类型不符合限制时同步返回 HTTP 400,不创建任务、不扣费。auto 由模型根据素材和提示词判断任务类型,可能在生成阶段因类型限制而失败;即使显式指定类型,提示词意图不匹配仍可能返回 InvalidParameter.TaskTypeMismatch。

请求示例

多模态参考

首尾帧生成

视频编辑

视频延长

使用私域素材

含真人人脸的参考图或视频应先通过素材库审核,再使用 asset://。上传素材时,model 也传 seedance-2-5-flash。可参考 素材库接口,并使用下方 Flash 模型名。
通过统一任务接口轮询素材审核任务,审核通过后从素材列表获取 asset:// ID,填入 image_urls、image_with_roles[].url、video_urls 或 audio_urls。

查询任务与结果

通过任务查询接口轮询。pending / processing 表示处理中,completed 表示成功,failed 表示失败。成功后读取 data.result.videos[0].url[0];注意 url 是数组。

计费规则

  • 提交时按分辨率对应的每秒档位预扣;有参考视频时使用带输入档位,预扣秒数为输出时长加参考视频总时长。
  • 普通请求未传 duration 时按 5 秒输出预扣;duration: -1 或 edit 省略时长时,按 30 秒输出预扣。
  • 成功后按 data.usage.completion_tokens 结算:token 数 ÷ 1,000,000 × 对应的每百万 token 单价,再应用账户优惠;与预扣多退少补。是否带参考视频决定使用 token 或 token-input 档位。最终实扣以 data.cost 为准。
  • 提交失败不扣生成费用,生成失败退回预扣费用。单价和账户优惠以价格页为准。

常见错误