Skip to main content
POST
  • 一个模型覆盖多种生成方式,按传入的素材自动判断:文生视频、首帧、首尾帧、参考生视频、参考文档或网页生视频。
  • 分辨率 480P / 720P / 1080P,时长 2~30 秒,或传 -1 由模型决定。
  • 异步接口:提交后立即返回任务 id,再调用 查询视频任务 获取结果。
  • 按时长和分辨率计费,见 模型价格。任务失败自动退款。

模型

可用模型以 模型广场 为准。

生成模式

鉴权

string
必填
Bearer <API Key>。在 API 密钥 页面创建。

基础参数

string
必填
wan3.0-video 或 wan3.0-video-prime。
string
必填
视频描述,最长 20000 字符,超出部分自动截断。参考生视频时,可以用「图1」「视频1」「音频1」指代素材。编号按同类素材在数组中的顺序从 1 开始,图片、视频、音频各自计数。
integer
必填
视频时长(秒):2~30 的整数,或 -1 由模型决定时长。
有参考视频时,参考视频总时长加输出时长不能超过 30 秒。
string
默认值:"1080P"
分辨率:480P、720P、1080P,大小写均可。
不传时按 1080P 生成和计费,价格最高。对成本敏感时请显式传 480P 或 720P。
string
默认值:"adaptive"
宽高比:adaptive(自适应)、16:9、4:3、1:1、3:4、9:16、21:9。也可以用 aspect_ratio 字段传入。
boolean
默认值:"true"
输出视频是否包含音轨。
integer
随机种子,取值 0~2147483647。
boolean
默认值:"false"
是否添加水印。
boolean
是否由模型自动扩写提示词。传入 file_url 或 link_url 时必须为 true(不传时自动开启)。
string
指定 image_urls 中的图片按哪种方式使用:
  • frame:作为首帧 / 尾帧
  • reference:作为参考图
不传时自动判断,规则见下方「素材使用规则」。

素材参数

所有素材都需要是公网可访问的 URL。
string[]
图片 URL 数组。作为首尾帧时最多 2 张,作为参考图时最多 10 张。
object[]
带角色的图片数组,可以精确指定每张图的用途。每项包含:
  • url:图片 URL
  • role:first_frame、last_frame 或 reference_image
string[]
参考视频,最多 5 段,单段 1~15 秒,总时长不超过 15 秒。
string[]
参考音频,最多 5 段,单段 1~15 秒,总时长不超过 15 秒。需要同时提供参考图或参考视频。
string
单条参考音频,与 audio_urls 只传一条时等价。
string
参考文档 URL,最多 1 个,不能与 link_url 同时传入。支持 docx / doc / xlsx / xls / pptx / ppt / pdf / txt / key / pages / numbers / md 等格式,不超过 100 MB、50 页。
参考网页 URL,最多 1 个,需要无需登录即可访问。不能与 file_url 同时传入。

素材使用规则

素材分为两类,不能混用,混用时提交直接返回 400,不创建任务、不扣费: image_urls 中的图片按以下顺序判断用途:
  1. 传了 generation_type,以它为准。
  2. 没传,但请求中有参考视频、参考音频、文档或网页,则作为参考图。
  3. 都没有,则作为首尾帧:第 1 张为首帧,第 2 张为尾帧。
尾帧必须与首帧一起使用。需要精确控制时,请使用 image_with_roles。

素材要求

提交响应

返回 object 为 video、status 为 queued 的任务对象,字段说明见 Seedance 2.0。用其中的 id 调用 查询视频任务。

查询结果

任务成功后,视频链接在 data.result.videos[0].url[0]:
视频链接约 24 小时后过期(见 expires_at),请及时下载转存。生成通常需要 1~5 分钟,时长越长耗时越久。

使用示例

首帧生视频

首尾帧生视频

多素材参考生视频

参考文档生视频

参考网页生视频