Skip to main content
POST
  • 阿里云万相视频生成模型
  • 支持三种模式:文生视频(Text-to-Video)、图生视频(Image-to-Video)、参考视频(Reference Video,r2v)
  • 服务端根据请求参数自动路由到合适的上游模型
  • 支持 720p/1080p 分辨率,5/10/15 秒时长
  • 非 Flash 版本视频默认带有声音
重要变更:为了更好的性能和成本控制,我们不再支持在 image_urls 中直接传入 base64 图片数据。请先使用 上传图片接口 上传图片,获取 URL 后再调用本接口。

路由逻辑

服务端根据请求参数自动选择上游模型:

认证

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

请求参数

string
必填
视频生成模型名称,固定为 wan2.6
string
必填
视频内容描述文生视频模式下必填;图生视频和参考视频模式下可选(描述期望的动作或风格)示例:"一只可爱的猫咪在阳光下伸懒腰"
string[]
参考图片 URL 数组(图生视频模式,仅支持 1 张图片)⚠️ 仅支持 URL 格式(不再支持 base64)
  • 公开可访问的图像 URL(http:// 或 https://)
  • 可使用 上传图片接口 上传本地图片获取 URL
示例:["https://example.com/image.jpg"]注意: 不能与 metadata.reference_urls 同时使用
string
默认值:"16:9"
视频宽高比(适用于文生视频和参考视频模式)可选值:
  • 16:9 - 横屏(默认)
  • 9:16 - 竖屏
  • 1:1 - 方形
  • 4:3 - 横屏
  • 3:4 - 竖屏
默认值:16:9注意: 图生视频模式不支持此参数
string
默认值:"1080p"
视频分辨率可选值:
  • 720p - 标清
  • 1080p - 高清(默认)
默认值:1080p不支持 480p。按秒计费,不同分辨率价格不同,详见模型市场
integer
默认值:"5"
视频时长(秒)支持:51015默认值:5
string
负面提示词,描述不希望出现的内容示例:"模糊, 低质量, 变形"
integer
随机种子,用于复现结果示例:12345
boolean
默认值:"true"
自动扩展提示词开启后系统会自动优化并丰富您的提示词,默认已启用,设为 false 可禁用
boolean
在视频中添加音频非 Flash 的 Wan2.6 模型默认输出有声视频,设为 true 可显式启用
string
镜头类型(适用于文生视频和参考视频模式)可选值:
  • single - 单镜头
  • multi - 多镜头(电影式剪辑)
boolean
在生成的视频上添加阿里云水印
object
扩展参数

分辨率与宽高比组合

响应

string
唯一任务标识符,用于后续查询状态
string
对象类型,固定为 generation.task
string
使用的模型名称
string
任务状态
  • queued - 排队等待
  • in_progress - 处理中
  • completed - 成功完成
  • failed - 失败
integer
任务进度百分比(0-100)
integer
任务创建时间戳(Unix 时间戳)
object
任务元数据

使用场景

场景一:文生视频

场景二:图生视频

场景三:参考视频(r2v)

场景四:文生视频(完整参数)

查询任务结果视频生成为异步任务。提交后返回 task_id,使用 获取视频任务状态 接口查询生成进度和结果。