+ |
+ #### 请求参数
+
+ ##### 请求头（Headers）
+
+ Content-Type`string`（必选）
+
+ 请求内容类型。此参数必须设置为`application/json`。
+
+ Authorization`string`（必选）
+
+ 请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值：Bearer sk-xxxx。
+
+ X-DashScope-Async`string`（必选）
+
+ 异步处理配置参数。HTTP请求只支持异步，必须设置为`enable`。
+
+
+ 缺少此请求头将报错：“current user api does not support synchronous calls”。
+
+
+ ##### 请求体（Request Body）
+
+ model `string` （必选）
+
+ 模型名称。可选值：
+
+ - `wan3.0-video-prime`：高速版，能力对齐标准版，端到端速度显著提升。
+ - `wan3.0-video`：标准版。
+
+ input `object` （必选）
+
+ 输入的基本信息。`prompt` 和 `media` 必填其一。
+
+
+ prompt `string` （条件必选）
+
+ 文本提示词，用来描述期望生成的视频内容。和 `media` 必填其一。
+
+ 支持中英文，每个汉字/字母占一个字符，不超过20000个字符，超过部分会自动截断。
+
+ 在全能参考模式下，prompt中可以用"图1""视频1""音频1"等指代 media 数组中对应顺序的媒体素材。
+
+ media `array` （条件必选）
+
+ 媒体素材数组，支持图像、视频、音频、文件和网页作为输入。和 `prompt` 必填其一。
+
+ - 数组中每个元素为一个媒体对象，包含 `type` 与 `url` 字段。
+ - 在参考生视频模式下，按照数组顺序定义 `prompt` 中素材引用的顺序。图和视频分别计数，即可同时存在图1、视频1。
+
+ - 数组中的第 1 个 `reference_video` 对应 视频1，第 2 个对应 视频2，以此类推。
+ - 数组中的第 1 个 `reference_image` 对应 图1，第 2 个对应 图2，以此类推。
+ - 数组中的第 1 个 `reference_audio` 对应 音频1，第 2 个对应 音频2，以此类推。
+
+
+ type `string` （必选）
+
+ 媒体素材类型。可选值为：
+
+ - `first_frame`：首帧图像。最多1张，严格作为视频第一帧。
+ - `last_frame`：尾帧图像。最多1张，严格作为视频最后一帧。
+ - `reference_image`：参考图像。最多10张。
+ - `reference_video`：参考视频。最多5段，总时长不大于15秒。
+ - `reference_audio`：参考音频。最多5段，总时长不大于15秒。
+ - `file`：文件。最多1个，不可与 link 同时输入。
+ - `link`：网页链接。最多1个，不可与 file 同时输入。
+
+
+ 不同 `type` 的组合规则和限制请参见[素材组合](#w30media_combo_t)。
+
+
+ url `string` （必选）
+
+ 媒体素材URL或Base64 编码数据。
+
+
+ 图像URL或Base64 编码数据。
+
+ 图像限制：
+
+ - 格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP。
+ - 分辨率：单边\[240, 8000]像素。
+ - 长宽比：不超过8:1。
+ - 文件大小：不超过20MB。
+
+ 支持输入的格式：
+
+ 1. 公网URL：
+
+ - 支持HTTP或HTTPS协议。
+ - 示例值：[https://xxx/xxx.png](https://xxx/xxx.png)。
+ 2. 临时URL：
+
+ - 支持OSS协议，必须通过[上传文件获取临时 URL](/zh/model-studio/get-temporary-file-url)。
+ - 示例值：oss\://dashscope-instant/xxx/xxx.png。
+ 3. Base64 编码图像后的字符串：
+
+ - 数据格式：`data:{MIME_type};base64,{base64_data}`。
+ - 示例值：data:image/png;base64,GDU7MtCZzEbTbmRZ......。（编码字符串过长，仅展示片段）
+ - 详情请参见[传入图像](/zh/model-studio/image-to-video-guide#32d9db99f1fk0)。
+
+
+
+ 参考视频URL。
+
+ 视频限制：
+
+ - 格式：mp4、mov。
+ - 时长：单个\[1, 15]秒，总时长不大于15秒。
+ - 帧率：≥16 fps。
+ - 分辨率：单边\[240, 4096]像素。
+ - 长宽比：不超过8:1。
+ - 单文件大小：不超过100MB。
+
+ 支持输入的格式：
+
+ 1. 公网URL：
+
+ - 支持HTTP或HTTPS协议。
+ - 示例值：[https://xxx/xxx.mp4](https://xxx/xxx.mp4)。
+ 2. 临时URL：
+
+ - 支持OSS协议，必须通过[上传文件获取临时 URL](/zh/model-studio/get-temporary-file-url)。
+ - 示例值：oss\://dashscope-instant/xxx/xxx.mp4。
+
+
+
+ 参考音频URL。
+
+ 音频限制：
+
+ - 格式：wav、mp3。
+ - 时长：单个\[1, 15]秒，总时长不大于15秒。
+ - 文件大小：不超过15MB。
+
+ 支持输入的格式：
+
+ 1. 公网URL：
+
+ - 支持HTTP或HTTPS协议。
+ - 示例值：[https://xxx/xxx.mp3](https://xxx/xxx.mp3)。
+ 2. 临时URL：
+
+ - 支持OSS协议，必须通过[上传文件获取临时 URL](/zh/model-studio/get-temporary-file-url)。
+ - 示例值：oss\://dashscope-instant/xxx/xxx.mp3。
+
+
+
+ 文件URL。
+
+ 文件限制：
+
+ - 格式：docx、doc、xlsx、xls、pptx、ppt、pdf、txt、key、pages、numbers、md。
+ - 文件大小：不超过100MB。
+ - 页数限制：不超过50页（对pdf、docx、doc、pptx、ppt、key、pages格式校验）。
+
+ 支持输入的格式：
+
+ 1. 公网URL：
+
+ - 支持HTTP或HTTPS协议。
+ - 示例值：[https://xxx/xxx.pdf](https://xxx/xxx.pdf)。
+ 2. 临时URL：
+
+ - 支持OSS协议，必须通过[上传文件获取临时 URL](/zh/model-studio/get-temporary-file-url)。
+ - 示例值：oss\://dashscope-instant/xxx/xxx.pdf。
+
+
+
+ 公开网页的URL地址。仅支持解析无需登录的公开网页（如新闻、博客、公众号等）。
+
+ 支持输入的格式：
+
+ 1. 公网URL：
+
+ - 支持HTTP或HTTPS协议。
+ - 示例值：[https://xxx/article/xxx](https://xxx/article/xxx)。
+
+
+
+
+ parameters `object` （可选）
+
+ 视频处理参数。
+
+
+ resolution `string` （可选）
+
+ 生成视频的分辨率档位。默认值为 `1080P`。可选值：
+
+ - `1080P`
+ - `720P`
+ - `480P`
+
+ ratio `string` （可选）
+
+ 生成视频的宽高比。可选值：
+
+ - `adaptive`（默认值）：自适应长宽比，根据输入媒体比例和意图自动推荐合适的长宽比。
+ - `21:9`
+ - `16:9`
+ - `4:3`
+ - `1:1`
+ - `3:4`
+ - `9:16`
+
+ duration `integer` （可选）
+
+ 生成视频的时长，单位为秒。默认值为5。
+
+ - 无视频输入时：取值范围为\[2, 30]的整数。
+ - 有视频输入时：输入视频总时长 + 输出视频时长不超过30秒。
+ - 传 `-1` 时：智能时长模式，模型根据输入的 prompt、内容和富媒体自动推荐合适时长生成。
+
+ audio `boolean` （可选）
+
+ 输出视频是否包含音频。
+
+ - `true`：默认值，输出视频包含声音。
+ - `false`：输出视频不包含音轨。
+
+ 开关声音价格相同。
+
+ seed `integer` （可选）
+
+ 随机种子，用于复现生成结果。取值范围：-1或\[0, 2147483647]。传入-1或未指定时，系统自动生成随机种子。即使使用相同seed，也不能保证每次生成结果完全一致。
+
+ prompt\_extend `boolean` （可选）
+
+ 是否开启prompt智能改写。开启后使用大模型对输入prompt进行智能改写。对于较短的prompt生成效果提升明显，但会增加耗时。
+
+ - `true`：默认值，开启智能改写。
+ - `false`：不开启智能改写。
+
+
+ 当传入文档（`file`）或网页（`link`）素材时，`prompt_extend` 取值必须为 `true`。
+
+
+ watermark `boolean` （可选）
+
+ 是否添加水印标识。
+
+ - `false`：默认值，不添加水印。
+ - `true`：添加水印。
+
+ |
+
+
+
+
+ 通过 `file` 类型传入文件，模型自动理解文件内容生成视频。
+
+ ```bash
+ curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
+ -H 'X-DashScope-Async: enable' \
+ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
+ -H 'Content-Type: application/json' \
+ -d '{
+ "model": "wan3.0-video",
+ "input": {
+ "prompt": "一支高端智能眼镜产品广告，整体风格极简、未来感、时尚高级，光影克制，画面以黑色、银灰色、冰蓝色为主色调，局部点缀柔和白光与参数UI图形。开场在纯黑背景中，一副智能眼镜从黑暗中缓缓浮现，镜腿边缘掠过精致高光，镜框轮廓在冷冽边缘光下被勾勒出来，镜头超近距离掠过镜片、鼻托、转轴、镜腿与材质细节，展现金属与高性能复合材料的细腻质感，表面处理高级克制，线条轻薄流畅。随后产品在空中缓慢旋转，画面以极简动态图形同步展示核心参数信息。随后镜头快速收拢，所有零件精准回归组装成完整产品，切换到年轻模特佩戴展示，模特五官立体、气质自信，穿着简洁高级的都市时尚服装，在极简空间和城市光影环境中自然转头、抬手、行走、微笑，镜头从正面、侧面、斜后方展示眼镜佩戴状态，突出轻薄贴合、时尚轮廓与日常百搭属性。结尾在纯色背景中，产品悬浮定格，镜头缓慢推进到品牌logo和核心slogan，整体音乐极简电子氛围配合精准鼓点，节奏干净有力，画面质感高级、克制、纯粹，具有强烈品牌记忆点和国际化科技审美。",
+ "media": [
+ {
+ "type": "file",
+ "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260806/ebapmr/glass.pptx"
+ }
+ ]
+ },
+ "parameters": {
+ "resolution": "480P",
+ "ratio": "adaptive",
+ "duration": 10,
+ "prompt_extend": true
+ }
+ }'
+ ```
+
+
+
+ 通过 `input.media` 传入参考图片、视频、音频、文件或网页链接，模型自动理解意图生成视频。
+
+ ```bash expandable
+ curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
+ -H 'X-DashScope-Async: enable' \
+ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
+ -H 'Content-Type: application/json' \
+ -d '{
+ "model": "wan3.0-video",
+ "input": {
+ "prompt": "视频1抱着图3，在图4的椅子上弹奏一支舒缓的乡村民谣，并说道："今天的阳光真好。"图1手中拿着图2，路过视频1，把手中的图2放到视频1旁边的桌子上，并说道："真好听，能不能再唱一遍"。",
+ "media": [
+ {
+ "type": "reference_image",
+ "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg"
+ },
+ {
+ "type": "reference_video",
+ "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4"
+ },
+ {
+ "type": "reference_image",
+ "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/rtjeqf/wan-r2v-object3.png"
+ },
+ {
+ "type": "reference_image",
+ "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
+ },
+ {
+ "type": "reference_image",
+ "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
+ }
+ ]
+ },
+ "parameters": {
+ "resolution": "480P",
+ "ratio": "adaptive",
+ "duration": 5,
+ "prompt_extend": true
+ }
+ }'
+ ```
+
+
+
+ 仅通过 `prompt` 生成视频，不传入任何媒体文件。
+
+ ```bash
+ curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
+ -H 'X-DashScope-Async: enable' \
+ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
+ -H 'Content-Type: application/json' \
+ -d '{
+ "model": "wan3.0-video",
+ "input": {
+ "prompt": "一只小猫在月光下的屋顶上奔跑，城市的霓虹灯在远处闪烁，电影级画质，流畅运镜。"
+ },
+ "parameters": {
+ "resolution": "480P",
+ "ratio": "adaptive",
+ "duration": 5,
+ "prompt_extend": true
+ }
+ }'
+ ```
+
+
+
+ 仅传入 `first_frame`，严格指定视频首帧图像。
+
+ ```bash
+ curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
+ -H 'X-DashScope-Async: enable' \
+ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
+ -H 'Content-Type: application/json' \
+ -d '{
+ "model": "wan3.0-video",
+ "input": {
+ "prompt": "一只猫在草地上奔跑",
+ "media": [
+ {
+ "type": "first_frame",
+ "url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png"
+ }
+ ]
+ },
+ "parameters": {
+ "resolution": "480P",
+ "ratio": "adaptive",
+ "duration": 5,
+ "prompt_extend": true
+ }
+ }'
+ ```
+
+
+
+ 仅支持传入 `first_frame` 和 `last_frame`，严格指定视频的首帧和尾帧图像。
+
+ ```bash expandable
+ curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
+ -H 'X-DashScope-Async: enable' \
+ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
+ -H 'Content-Type: application/json' \
+ -d '{
+ "model": "wan3.0-video",
+ "input": {
+ "prompt": "清晨太阳刚刚升起，在南瓜地里面，有一颗小南瓜上面挂着露珠，突然小南瓜咔擦一声，出现了裂缝，从裂缝中透出金光，小南瓜伴随着金光裂开，出现一团白雾，一只小兔子在南瓜裂开的南瓜中央出现。",
+ "media": [
+ {
+ "type": "first_frame",
+ "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/welyei/wan2.7-i2v-first-frame.webp"
+ },
+ {
+ "type": "last_frame",
+ "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/zongha/wan2.7-i2v-last-frame.webp"
+ }
+ ]
+ },
+ "parameters": {
+ "resolution": "480P",
+ "ratio": "adaptive",
+ "duration": 5,
+ "prompt_extend": true
+ }
+ }'
+ ```
+
+
+
+ 通过 `reference_video` 类型传入待编辑视频，结合 `prompt` 指令编辑视频内容。
+
+ ```bash
+ curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
+ -H 'X-DashScope-Async: enable' \
+ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
+ -H 'Content-Type: application/json' \
+ -d '{
+ "model": "wan3.0-video",
+ "input": {
+ "prompt": "将整个画面转换为黏土风格",
+ "media": [
+ {
+ "type": "reference_video",
+ "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4"
+ }
+ ]
+ },
+ "parameters": {
+ "resolution": "720P",
+ "prompt_extend": true
+ }
+ }'
+ ```
+
+
+
+ 通过 `reference_video` 类型传入原始视频，结合含延长意图关键词的 `prompt` 延长视频内容。需将 `ratio` 设为 `adaptive`。
+
+ ```bash
+ curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
+ -H 'X-DashScope-Async: enable' \
+ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
+ -H 'Content-Type: application/json' \
+ -d '{
+ "model": "wan3.0-video",
+ "input": {
+ "prompt": "将视频1向后延长，面包师端上刷好的面包，将刷子放到一旁，镜头跟随面包师，去斜后方的烤炉进行烤制",
+ "media": [
+ {
+ "type": "reference_video",
+ "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4"
+ }
+ ]
+ },
+ "parameters": {
+ "resolution": "720P",
+ "ratio": "adaptive",
+ "prompt_extend": true
+ }
+ }'
+ ```
+
+
+ |
+
+ ](https://xxx/xxx.png){kind=link}