功能与接口选择

通义万相（Wan）可以根据文本、图片或参考素材生成视频。“原生格式”指保留阿里百炼的 model + input + parameters 请求结构；通过青云调用时仍使用青云地址和青云 API Key。

调用格式创建入口（基础地址 https://top.qingyuntop.ai）模型范围和用途
统一视频格式/v1/videos下表全部 23 个视频模型，适合统一任务管理。
Responses 格式/v1/responses支持下表视频模型；图片生成请使用对应图片文档。
阿里百炼原生视频格式/ali/api/v1/services/aigc/video-generation/video-synthesis常规文生、图生、Wan 3.0 参考视频等，保留 input / parameters 结构。
阿里百炼原生首尾帧 / 数字人格式/ali/api/v1/services/aigc/image2video/video-synthesis建议 wan2.2-kf2v-flash 和 wan2.2-s2v 使用，与阿里官方对应。

两个原生 POST 入口都按 model 选择生成方式。推荐 wan2.2-kf2v-flash、wan2.2-s2v 使用上表 image2video 路径，其他视频模型使用 video-generation 路径。使用统一视频或 Responses 时，按对应文档填写模型和输入即可。

multimodal-generation、image-generation、text2image 是图片生成入口，不用于本目录的视频任务。

两步调用

  1. 在创建请求中携带 Authorization: Bearer YOUR_API_KEY，提交模型、提示词和素材，取得 output.task_id。
  2. 用相同 Key 查询 GET /ali/api/v1/tasks/{task_id}；状态为 SUCCEEDED 后下载视频。基础地址仍为青云TOP API。

创建请求使用 Content-Type: application/json，无需设置 X-DashScope-Async。鉴权随每次请求发送，不需要先调用登录接口。

视频模型完整清单

本目录适用的视频模型见下表。调用前请在青云控制台确认 API Key 的模型权限；除音频驱动数字人外，不指定时长时默认 5 秒。

模型输入结构分辨率（默认）时长（秒）
wan3.0-video文本 / media 全能参考480P / 720P / 1080P（1080P）2–30，或 -1
wan3.0-video-prime文本 / media 全能参考480P / 720P / 1080P（1080P）2–30，或 -1
wan2.7-t2vprompt 文生720P / 1080P（1080P）2–15
wan2.7-i2vmedia 图生 / 续写720P / 1080P（1080P）2–15
wan2.6-t2vprompt 文生 + size720P / 1080P（1080P）2–15
wan2.6-t2v-usprompt 文生 + size720P / 1080P（1080P）5 / 10 / 15
wan2.6-i2vimg_url 图生720P / 1080P（1080P）2–15
wan2.6-i2v-flashimg_url 图生720P / 1080P（1080P）2–15
wan2.6-i2v-usimg_url 图生720P / 1080P（1080P）5 / 10 / 15
wan2.5-t2v-previewprompt 文生 + size480P / 720P / 1080P（1080P）5 / 10
wan2.5-i2v-previewimg_url 图生480P / 720P / 1080P（1080P）5 / 10
wan2.2-t2v-plusprompt 文生 + size480P / 1080P（1080P）5
wan2.2-i2v-flashimg_url 图生480P / 720P / 1080P（720P）5
wan2.2-i2v-plusimg_url 图生480P / 1080P（1080P）5
wan2.2-kf2v-flashfirst_frame_url 首尾帧480P / 720P / 1080P（720P）5
wan2.2-s2vimage_url + audio_url 数字人480P / 720P（480P）跟随音频，小于 20
wanx2.1-t2v-plusprompt 文生 + size720P（720P）5
wanx2.1-t2v-turboprompt 文生 + size480P / 720P（720P）5
wanx2.1-i2v-plusimg_url 图生720P（720P）5
wanx2.1-i2v-turboimg_url 图生480P / 720P（720P）3 / 4 / 5
wan2.7-t2v-2026-04-25prompt 文生720P / 1080P（1080P）2–15
wan2.7-t2v-2026-06-12prompt 文生720P / 1080P（1080P）2–15
wan2.7-i2v-2026-04-25media 图生 / 续写720P / 1080P（1080P）2–15

带日期后缀的模型使用对应基础型号的请求结构。wan2.7-r2v、wan2.7-vace 等未列出的型号不适用本页调用说明；请勿直接替换 model。wan2.7-image、wan2.6-t2i 等图片模型请使用图片生成文档。

Wan 3.0 的调用限制

  • 官方比例含 21:9，但本接口不接受该值。通过青云使用 adaptive、16:9、9:16、1:1、4:3、3:4。
  • duration=-1 表示智能时长，仅 Wan 3.0 支持。不要把它解释为取消时长限制；有输入视频时，输入视频总时长加输出视频时长不能超过 30 秒。
  • 首帧 / 首尾帧模式不能与 reference_image、reference_video、reference_audio、file、link 混合。尾帧必须配首帧。
  • 参考图最多 10 张；参考视频、参考音频各最多 5 个，每类总时长均不能超过 15 秒。文件和网页各最多 1 个，file 与 link 互斥，使用它们必须 prompt_extend: true。
  • 请同时满足模型、素材尺寸、时长和组合要求。创建成功只表示请求已受理，仍需查询任务是否生成成功。

下一步

官方参考