提交灵动人像 LivePortrait 播报视频生成异步任务
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "liveportrait",
"input": {
"image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250911/ynhjrg/p874909.png",
"audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251226/fwnqyq/liveportrait_boy.mp3"
},
"parameters": {
"template_id": "normal",
"eye_move_freq": 0.5,
"video_fps": 30,
"mouth_move_strength": 1,
"paste_back": true,
"head_move_strength": 0.7
}
}'{
"output": {
"task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
"task_status": "PENDING"
},
"request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}| 模型名 | 模型简介 |
|---|---|
| liveportrait | 灵动人像 LivePortrait，基于人物肖像图片和语音音频，生成口型与音频同步的播报视频。适用于数字人播报、虚拟主播等场景。 |
| 模板名 | 说明 |
|---|---|
| normal | 默认，中等幅度头部运动，适用于多种场景。 |
| calm | 平静，小幅度头部运动，推荐用于播报场景。 |
| active | 活跃，大幅度头部运动，推荐用于演唱场景。 |
task_id。task_id 轮询任务状态，直到获取生成的视频 URL。千问云 API Key。详见获取 API Key。
固定值 enable，启用异步模式。
模型名称，固定为 liveportrait。
显示子属性
人物肖像图片公网 URL。建议先通过 LivePortrait 图像检测 接口验证图片是否符合规范。
图片要求：
驱动视频的语音音频公网 URL。
音频要求：
显示子属性
头部运动模板，控制头部运动风格。normal：默认，中等幅度头部运动，适用于多种场景；calm：平静，小幅度头部运动，推荐用于播报场景；active：活跃，大幅度头部运动，推荐用于演唱场景。默认为 normal。
眨眼频率，取值范围 0～1。值越大眨眼次数越多。默认为 0.5。
生成视频的帧率，取值范围 15～30（整数）。默认为 24。
嘴部运动幅度，取值范围 0～1.5。0 表示嘴部不动。默认为 1。
是否将面部粘贴回原始图像身体上。true：输出完整人物图像；false：仅输出面部区域。默认为 true。
头部运动幅度，取值范围 0～1。默认为 0.7。
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "liveportrait",
"input": {
"image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250911/ynhjrg/p874909.png",
"audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251226/fwnqyq/liveportrait_boy.mp3"
},
"parameters": {
"template_id": "normal",
"eye_move_freq": 0.5,
"video_fps": 30,
"mouth_move_strength": 1,
"paste_back": true,
"head_move_strength": 0.7
}
}'{
"output": {
"task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
"task_status": "PENDING"
},
"request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}
