Skip to main content
POST
万相 2.5 视频生成

简介

万相 2.5(Wan 2.5)是阿里云百炼推出的视频生成系列,由文生视频(wan2.5-t2v-preview)与图生视频(wan2.5-i2v-preview)组成,支持 480P720P1080P 输出。 通过 GravitexAI 统一视频接口调用:先 提交视频任务 获取任务 id,再 查询视频任务 轮询状态并获取视频 URL。
万相 2.5 的推荐请求体通过 metadata.inputmetadata.parameters 传递底层 DashScope 参数。顶层 promptduration 等字段用于兼容展示,实际生效以 metadata.parameters 为准

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx

支持的模型

调用流程

  1. 提交任务POST /v1/video/generations,传入 modelpromptmetadata 中的万相参数。
  2. 轮询状态GET /llm-api/v1/video/generations/{id}(域名 maas.gravitex.ai),建议每 3–15 秒查询一次,直到 data.statuscompletedfailed
  3. 获取结果:成功时从 data.urldata.video_urldata.metadata.output.video_url 获取视频地址(通常为临时链接,请及时下载转存)。

通用请求结构

提交成功响应

提交接口返回 OpenAI Video 风格对象,使用 id 作为后续查询的任务 ID:

查询成功响应

查询接口返回统一包装结构,data.statuscompleted 时表示成功:

使用场景

基于文本提示词生成视频,支持智能改写 prompt、自定义分辨率与宽高比。
string
必填
文本提示词,建议与顶层 prompt 保持一致
string
默认值:"720P"
480P720P1080P
string
默认值:"16:9"
宽高比:16:99:161:14:33:4
integer
默认值:"5"
视频时长(秒),常见取值如 3、5、10
boolean
默认值:"true"
是否开启 Prompt 智能改写
boolean
默认值:"false"
是否添加水印
integer
随机种子,范围 [0, 2147483647]
文生视频示例:

参数参考

metadata.parameters

metadata.input

查询响应关键字段

状态映射

错误处理

任务失败时,data.statusfailed,可结合 data.metadata.output.task_status 排查原因。

常见问题

metadata.parameters.duration 为准。建议正式接入时要么不传顶层 duration,要么保证两者完全一致,避免理解偏差。
建议顶层 promptmetadata.input.prompt 保持一致,便于查询结果中的 orig_prompt 与请求对齐。
查询成功后拿到的 video_url 一般为临时 OSS 链接,建议获取后立即下载并转存至自有存储。
建议按以下优先级判断:
  1. data.status == "completed"
  2. data.video_urldata.url 非空
  3. data.metadata.output.task_status == "SUCCEEDED"
万相 2.5 仅支持文生视频与图生视频(首帧),图生视频使用 metadata.input.img_url 而非 2.7 的 media 数组;万相 2.7 额外支持参考生视频、视频续写、首尾帧等能力。详见 万相 2.7

相关接口

提交视频任务

统一视频任务提交入口与多模型参数说明

查询视频任务

轮询任务状态并获取视频 URL