Skip to main content
POST

认证

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

请求参数

string
必填
视频生成模型名称支持的模型:
  • seedance-2.0 - 标准版,支持文生视频、图生视频、首尾帧视频、参考视频、参考音频、有声视频
  • seedance-2.0-fast - 快速版,功能与标准版一致,生成速度更快
  • seedance-2.0-mini - 迷你版,功能与标准版一致
boolean
默认值:"false"
是否在提交视频任务前执行内容审核。
  • true:使用 omni-moderation-latest 审核提示词和输入图片
  • false 或不传:不发起审核请求,不增加审核成本与延迟(默认)
审核范围:
  • 文本:promptnegative_prompt
  • 图片:image_urlsimage_with_roles[].urlfirst_frame_imagelast_frame_image
  • 图片类型的 asset:// 私域素材:反查原始公网 URL 后审核
  • base64 图片:转为公网地址后审核
video_urlsaudio_urls 以及视频/音频类型的私域素材不会送审,因为审核模型不支持视频和音频。适用模型:seedance-2.0seedance-2.0-fastseedance-2.0-miniseedance-2.0-faceseedance-2.0-fast-faceseedance-2-0(旧名)、seedance-2.5审核调用本身不向发起视频请求的用户计费。
  • 命中审核时同步返回 HTTP 400(nsfw_content_detected),不会创建任务、不会返回 task_id、不会扣除视频生成额度
  • 审核服务不可用、超时或响应异常时采用 fail-open:生成请求继续提交。因此该参数不能作为绝对的内容安全保证
  • 无法解析为公网图片地址的输入会跳过;其他模型传 nsfw_check: true 会被静默忽略
开启示例:
审核命中响应:
string
视频内容描述文生视频时必填,图生视频/视频参考生视频时可选建议明确主体、动作、镜头和风格,以获得更好的生成效果
  • 提示词限制输入 4000 个字符,但是建议输入 500 字符。
  • 模型 seedance-2.0-mini 没有字数限制。建议:中文提示词不超过500字,英文提示词不超过1000词。字数过多易导致信息分散,模型可能忽略细节、 仅关注重点,进而造成视频缺失部分元素。
示例:"小猫对着镜头打哈欠"
integer
默认值:"5"
视频时长(秒)支持范围:4 ~ 15默认值:5
string
默认值:"16:9"
视频宽高比宽高比要在 0.5-2.5 之间可选值:
  • 16:9 - 横屏
  • 9:16 - 竖屏
  • 1:1 - 方形
  • 4:3 - 传统比例
  • 3:4 - 竖向传统比例
  • 21:9 - 超宽屏
  • adaptive - 自适应(根据输入图片/视频自动匹配)
默认值:16:9
string
默认值:"720p"
视频分辨率可选值:
  • 480p - 标清
  • 720p - 高清
  • 1080p - 全高清(仅 seedance-2.0 支持)
  • 4k - 超高清(仅 seedance-2.0 支持)
默认值:720p
integer
随机种子,用于控制生成内容的随机性
  • 相同的请求下,模型收到不同的 seed 值,将生成不同的结果
  • 相同的请求下,模型收到相同的 seed 值,会生成类似的结果,但不保证完全一致
boolean
默认值:"true"
是否生成音频(有声视频)设置为 true 时,视频将包含 AI 生成的配套音频设置为 false 时,视频将不包含音频(无声视频)默认值:true
boolean
默认值:"false"
是否返回尾帧图片设置为 true 时,任务结果中会额外返回视频最后一帧的图片 URL,可用于连续视频生成默认值:false
array<object>
工具列表,用于联网搜索等增强能力示例:[{"type": "web_search"}]
array<string>
图片 URL 数组,用于图生视频支持两种格式:
  • 普通图片 URL:https://example.com/cat.jpg
  • Asset URL(审核通过的素材):asset://asset_a
示例:["https://example.com/cat.jpg"]["asset://asset_a"]
Asset URL 支持全部 Seedance 2.0 模型:seedance-2.0seedance-2.0-fastseedance-2.0-mini
  • image_urlsimage_with_roles 不能同时使用
  • 最多 9 张参考图
array
带角色的图片数组,支持指定首帧/尾帧
url 字段使用 Asset URL 时,支持全部 Seedance 2.0 模型:seedance-2.0seedance-2.0-fastseedance-2.0-mini
示例:
Asset URL 写法:
  • image_urlsimage_with_roles 不能同时使用
  • 使用首尾帧图片时,video_urlsaudio_urls 不可用
array<string>
参考视频 URL 数组支持两种格式:
  • 普通视频 URL:https://example.com/reference.mp4
  • Asset URL(审核通过的素材):asset://asset_a
示例:["https://example.com/reference.mp4"]["asset://asset_a"]
Asset URL 支持全部 Seedance 2.0 模型:seedance-2.0seedance-2.0-fastseedance-2.0-mini
  • 使用首帧/尾帧图片(image_with_roles)时,参考视频不可用
  • 最多 3 个参考视频,1.8s < 总时长 < 15.2s
  • 参考视频分辨率需要在 480P ~ 720P 之间
array<string>
参考音频 URL 数组支持两种格式:
  • 普通音频 URL:https://example.com/speech.wav
  • Asset URL(审核通过的素材):asset://asset_a
示例:["https://example.com/speech.wav"]["asset://asset_a"]
Asset URL 支持全部 Seedance 2.0 模型:seedance-2.0seedance-2.0-fastseedance-2.0-mini
  • 使用首帧/尾帧图片(image_with_roles)时,参考音频不可用
  • 最多 3 个参考音频,总时长 ≤ 15s
  • 参考音频需与参考图片或者参考视频使用

响应

integer
响应状态码,成功时为 200
array
返回数据数组

使用场景

场景 1:文生视频

场景 2:图生视频(首帧)

场景 3:首尾帧视频

场景 4:视频参考生视频

场景 5:参考视频 + 参考音频

场景 6:有声视频

场景 7:连续视频生成(返回尾帧)

场景 8:快速版生成

场景 9:参考图片 + 参考视频 + 参考音频(多模态视频)

结合参考图片、参考视频和参考音频,生成沉浸式第一人称视角广告视频。适用于产品宣传、品牌广告等需要多素材融合的场景。

场景 10:使用 Asset URL 图生视频

审核通过的虚拟人像素材可直接作为参考图片传入,无需重新上传和审核。

场景 11:使用 Asset URL 指定参考人像(image_with_roles)

场景 12:快速版 + Asset URL 图生视频

场景 13:Asset URL 图片 + 参考视频(动作迁移)

将审核通过的人像素材与参考视频结合,驱动人物完成指定动作。
查询任务结果视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。

与 1.5 Pro 版本的差异