Wan图生视频带音频

方法: POST路径: /v2/videos/generations

通义万相-图生视频模型根据首帧图像和文本提示词，生成一段流畅的视频。支持的能力包括：

基础能力：时长灵活（3-10秒）、指定视频分辨率、智能改写prompt、添加水印。

音频能力：支持自动配音，或传入自定义音频文件，实现音画同步。（仅wan2.5支持）

视频特效：部分模型内置“魔法悬浮”、“气球膨胀”等特效模板，可直接调用。

请求参数

Header 参数

Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

prompt
string
必需
model
enum<string>
必需
值:
wan2.5-i2v-preview
万相2.5 preview（有声视频
新增音频能力：支持自动配音，或传入自定义音频文件
duration
enum<integer>
可选
枚举值:
5
10
resolution
enum<string>
可选
wan2.5-i2v-preview ：可选值：480P、720P、1080P。默认值为1080P
枚举值:
720P
480P
1080P
audio_url
string
可选
仅 wan2.5-i2v-preview 支持。音频文件的 URL，模型将使用该音频生成视频。使用方式参见音频设置。
支持 HTTP 或 HTTPS 协议。本地文件可通过上传文件获取临时URL。
音频限制：
格式：wav、mp3。
时长：3～30s。
文件大小：不超过15MB。
超限处理：若音频长度超过 duration 值（5秒或10秒），自动截取前5秒或10秒，其余部分丢弃。若音频长度不足视频时长，超出音频长度部分为无声视频。例如，音频为3秒，视频时长为5秒，输出视频前3秒有声，后2秒无声。
示例值：
https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3。
audio
string
可选
仅 wan2.5-i2v-preview 支持。 用于控制是否添加音频。
参数优先级：audio_url > audio，仅在 audio_url为空时生效。使用方式参见音频设置。
true：默认值，自动为视频添加音频。
false：不添加音频，输出无声视频。
images
array
[string]
必需
仅支持一张参考图
使用公网可访问URL
支持 HTTP 或 HTTPS 协议。本地文件可通过上传文件获取临时URL。
示例值：
https://cdn.translate.alibaba.com/r/wanx-demo-1.png。
传入 Base64 编码图像后的字符串
数据格式：data:{MIME_type};base64,{base64_data}。
示例值：data:image/png;base64,GDU7MtCZzEbTbmRZ......。（编码字符串过长，仅展示片段）
watermark
boolean
可选
template
string
可选
negative_prompt
string
可选
prompt_extend
string
可选
seed
integer
可选
示例
{
"model"
:
"wan2.5-i2v-preview"
,
"prompt"
:
"一幅都市奇幻艺术的场景。一个充满动感的涂鸦艺术角色。一个由喷漆所画成的少年，正从一面混凝土墙上活过来。他一边用极快的语速演唱一首英文rap，一边摆着一个经典的、充满活力的说唱歌手姿势。场景设定在夜晚一个充满都市感的铁路桥下。灯光来自一盏孤零零的街灯，营造出电影般的氛围，充满高能量和惊人的细节。视频的音频部分完全由少年的rap构成，没有其他对话或杂音。"
,
"images"
:
[
"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
]
,
"audio_url"
:
"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3"
,
"resolution"
:
"480P"
,
"prompt_extend"
:
true
,
"duration"
:
5
}

请求示例代码

Shell

curl --location --request POST '/v2/videos/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "wan2.5-i2v-preview",
    "prompt": "一幅都市奇幻艺术的场景。一个充满动感的涂鸦艺术角色。一个由喷漆所画成的少年，正从一面混凝土墙上活过来。他一边用极快的语速演唱一首英文rap，一边摆着一个经典的、充满活力的说唱歌手姿势。场景设定在夜晚一个充满都市感的铁路桥下。灯光来自一盏孤零零的街灯，营造出电影般的氛围，充满高能量和惊人的细节。视频的音频部分完全由少年的rap构成，没有其他对话或杂音。",
    "images": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
    ],
    "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3",
    "resolution": "480P",
    "prompt_extend": true,
    "duration": 5
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

task_id
string
必需

示例

{
    "task_id": "e7bed961-d1b9-4b3f-8ef9-5f441bde28c8"
}