创建视频
通过原生输入结构创建 Wan 3.0 视频任务。
使用 model/input/parameters 提交标准版视频任务。原生格式仍通过平台 API 地址和平台 API Key 调用，不需要阿里云 Workspace ID。平台已自动启用异步处理，客户端不必添加 X-DashScope-Async。
/api/v1/services/aigc/video-generation/video-synthesisAuthorization
bearerAuth 使用平台 API Key：Authorization: Bearer your-api-key。
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
通过原生结构提交任务；平台自动启用异步处理，无需额外提供 X-DashScope-Async。
Response Body
application/json
application/json
application/json
素材与组合规则
提示词和非空 media 至少提供一项。图片、视频、音频分别按数组中的同类素材顺序编号，可使用“图1”“视频1”“音频1”指代；不需要添加素材引用 ID。
| 素材 | 格式与数量 | 关键限制 |
|---|---|---|
| 首尾帧 | first_frame、last_frame 各最多 1 张 | 尾帧必须搭配首帧；不能与参考图片、视频、音频、文件或网页混用 |
| 参考图片 | reference_image 最多 10 张 | JPEG/JPG/PNG（无透明通道）/BMP/WEBP；每张不超过 20MB；单边 240～8000px，长宽比不超过 8:1 |
| 参考视频 | reference_video 最多 5 段 | MP4/MOV；每段 1～15 秒，总计不超过 15 秒；单文件不超过 100MB；单边 240～4096px，至少 16fps，长宽比不超过 8:1 |
| 参考音频 | reference_audio 最多 5 段 | WAV/MP3；每段 1～15 秒，总计不超过 15 秒；单文件不超过 15MB |
| 文件 | file 最多 1 个 | 不超过 100MB；PDF、Word、PowerPoint、Keynote、Pages 不超过 50 页；支持格式见字段表 |
| 网页 | link 最多 1 个 | HTTP/HTTPS 公开网页，无需登录；不能与文件同时输入 |
首尾帧图片的格式、大小和尺寸要求与参考图片相同。图片支持公开 URL 或带格式前缀的 Base64，例如 data:image/png;base64,...；其他素材使用 URL。普通素材也可使用具备访问权限的 OSS 地址，网页仅使用 HTTP/HTTPS。除网页外，URL 带扩展名时须符合相应素材格式；没有扩展名的地址仍需满足实际内容规格。
参考图片、视频和音频可组合使用；文件或网页也可搭配这些参考素材，但 file 与 link 互斥。使用文件或网页时，prompt_extend 必须开启。编辑和延长通过参考视频和提示词表达，延长时使用 ratio: "adaptive"。
时长为 -1（智能时长）或 2～30 秒整数；存在参考视频时，输入视频总时长与输出时长之和不能超过 30 秒。
创建结果与后续操作
提交成功后保存 output.task_id，通过原生查询接口获取状态和结果。request_id 是追踪标识，不用于任务查询。不要重复创建同一任务来获取进度。
若使用平台公共字段，可改用平台格式创建。两种格式不能混写。
常见错误
HTTP 400 时，根据返回的错误信息检查 JSON、模型名称、input/parameters 结构及素材组合。错误响应可能使用 code/message/data 结构，也可能包含嵌套的 error 对象。联系支持时请提供错误信息和请求 ID，不要提供 API Key。