跳转到主要内容
两个模型 ID 接受相同的参数。Prime 端到端生成更快,每秒价格更高。至少传入一路参考素材:图片、视频或音频。提示词按类型和位置引用它们,每种类型按数组顺序 分别编号:中文写作 图1、视频1、音频1……,英文写作 image 1、video 1、audio 1……首帧/尾帧不能与参考素材组合使用。如需固定首帧或尾帧,请使用 图生视频。

计费

按秒计费,每秒费率由分辨率决定。计费秒数为输出秒数加上所有参考视频的秒数,向上取整到整秒。 提交时会测量参考视频的时长,并按该请求可能产生的最高费用从余额中预扣;最终按实际时长结算, 且不会超过预扣金额。生成失败不收费。当前每秒费率请见定价页。

端点

异步接口 — 返回 {id, status: "pending"};轮询 GET /v1/videos/generations/{id} 直到状态为 success 或 failed。

参数

string
必填
描述目标片段以及如何使用各路参考素材的文本提示词。最多 20000 个字符。
string[]
最多 10 张参考图片 URL(公网 HTTPS):图1、图2……
string[]
最多 5 段参考视频 URL(公网 HTTPS):视频1、视频2……其秒数与输出一并计费。
string[]
最多 5 段参考音频 URL(公网 HTTPS):音频1、音频2……
"480P" | "720P" | "1080P"
默认值:"\"1080P\""
输出分辨率。每档各有独立的每秒费率。
"adaptive" | "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9"
默认值:"\"adaptive\""
生成视频的宽高比。adaptive 让模型按参考素材自动匹配。
integer
默认值:"5"
生成片段的时长(秒),取值范围 [2, 30]。含参考视频时,参考视频秒数与输出秒数之和不能 超过 30 秒。
boolean
默认值:"true"
生成音轨。设为 false 可得到无声片段。
integer
随机种子,取值范围 [0, 2147483647]。以相同请求复用同一种子,可更接近地复现结果。
boolean
默认值:"true"
生成前由模型扩写提示词。设为 false 则按原样使用提示词。
boolean
默认值:"false"
在视频上添加 AI 生成水印。
该模型不支持的选项不会转发给它。

延长或编辑视频

参考生视频也可以续写或编辑一段参考视频:把片段放入 video_urls,并在提示词中说明要做什么, 例如「延续视频1,汽车驶入隧道」或「把视频1中的天空换成雷暴」。

示例

使用 Prime 档位时,将 "model" 改为 "alibaba/wan-3-0-prime-r2v",请求体其余部分不变。
轮询直到进入终态: