万相 2.5 视频生成
视频系列
万相 2.5 视频生成
阿里万相 Wan 2.5 文生视频、图生视频
POST
万相 2.5 视频生成
简介
万相 2.5(Wan 2.5)是阿里云百炼推出的视频生成系列,由文生视频(wan2.5-t2v-preview)与图生视频(wan2.5-i2v-preview)组成,支持 480P、720P 与 1080P 输出。
通过 GravitexAI 统一视频接口调用:先 提交视频任务 获取任务 id,再 查询视频任务 轮询状态并获取视频 URL。
万相 2.5 的推荐请求体通过
metadata.input 与 metadata.parameters 传递底层 DashScope 参数。顶层 prompt、duration 等字段用于兼容展示,实际生效以 metadata.parameters 为准。认证
string
必填
Bearer Token,如
Bearer sk-xxxxxxxxxx支持的模型
调用流程
- 提交任务:
POST /v1/video/generations,传入model、prompt及metadata中的万相参数。 - 轮询状态:
GET /llm-api/v1/video/generations/{id}(域名maas.gravitex.ai),建议每 3–15 秒查询一次,直到data.status为completed或failed。 - 获取结果:成功时从
data.url、data.video_url或data.metadata.output.video_url获取视频地址(通常为临时链接,请及时下载转存)。
通用请求结构
提交成功响应
提交接口返回 OpenAI Video 风格对象,使用id 作为后续查询的任务 ID:
查询成功响应
查询接口返回统一包装结构,data.status 为 completed 时表示成功:
使用场景
- 文生视频 (T2V)
- 图生视频 (I2V)
参数参考
metadata.parameters
metadata.input
查询响应关键字段
状态映射
错误处理
任务失败时,
data.status 为 failed,可结合 data.metadata.output.task_status 排查原因。
常见问题
顶层 duration 和 metadata.parameters.duration 不一致怎么办?
顶层 duration 和 metadata.parameters.duration 不一致怎么办?
以
metadata.parameters.duration 为准。建议正式接入时要么不传顶层 duration,要么保证两者完全一致,避免理解偏差。prompt 需要传几次?
prompt 需要传几次?
建议顶层
prompt 与 metadata.input.prompt 保持一致,便于查询结果中的 orig_prompt 与请求对齐。生成的视频链接有效期多久?
生成的视频链接有效期多久?
查询成功后拿到的
video_url 一般为临时 OSS 链接,建议获取后立即下载并转存至自有存储。如何判断任务成功?
如何判断任务成功?
建议按以下优先级判断:
data.status == "completed"data.video_url或data.url非空data.metadata.output.task_status == "SUCCEEDED"
与万相 2.7 的调用方式有何不同?
与万相 2.7 的调用方式有何不同?
万相 2.5 仅支持文生视频与图生视频(首帧),图生视频使用
metadata.input.img_url 而非 2.7 的 media 数组;万相 2.7 额外支持参考生视频、视频续写、首尾帧等能力。详见 万相 2.7。相关接口
提交视频任务
统一视频任务提交入口与多模型参数说明
查询视频任务
轮询任务状态并获取视频 URL
