Skip to content
EN

图生动作

方法: POST路径: /qwen/api/v1/services/aigc/image2video/video-synthesis

官方api 文档

通义万相-图生动作模型,可基于人物图片和参考视频,生成人物动作视频。

功能简述:将视频角色的动作/表情迁移到图片角色中,赋予图片角色动态表现力。

适用场景:复刻舞蹈、复刻高难度肢体动作、复刻影视剧表演表情及肢体动作细节,低成本动捕替代。

请求参数

Header 参数

text
X-DashScope-Async
string
必需
示例:
enable
Content-Type
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json 必填

text
model
string
必需
input
object
必需
image_url
string
必需
输入图像的公网可访问的HTTP/HTTPS链接,不能包含中文等非ASCII字符,否则需要进行编码后再传入。
本地文件可通过上传文件获取临时URL。
格式:JPG、JPEG、PNG、BMP、WEBP。
尺寸:图像的宽度和高度都在[200,4096]像素范围内,宽高比在1:3至3:1范围内。
文件大小:不超过5MB。
内容:画面中仅有一人,正对镜头,人脸完整无遮挡,且在画面中的占比适中,避免过大或过小。
示例值:
https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg
video_url
string
必需
输入视频的公网可访问的HTTP/HTTPS链接,不能包含中文等非ASCII字符,否则需要进行编码后再传入。
本地文件可通过上传文件获取临时URL。
建议:提高参考视频的分辨率和帧率,可有效提升生成视频的画质效果。
格式:MP4、AVI、MOV。
时长:2~30s。
尺寸:视频的宽度和高度都在[200, 2048]像素范围内,宽高比在1:3至3:1范围内。
文件大小:不超过200MB。
内容:画面中仅有一人,正对镜头,人脸完整无遮挡,且在画面中的占比适中,避免过大或过小。
示例值:
https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4
parameters
object
必需
mode
string
必需
模型服务模式选择,支持两种模式。
wan-std:标准模式,生成速度较快,性价比高,适用于快速预览和基础动画场景,处理1s视频耗时约8s。
wan-pro:专业模式,动画流畅度更高,效果更佳,但处理时间和费用也相应增加,处理1s视频耗时约13s。
check_image
boolean
可选
是否进行图像检测。
true:默认值,接口将对传入的图片进行检测。
false:跳过图片检测环节,直接对图片进行后续处理。
示例
{
"model"
:
"wan2.2-animate-move"
,
"input"
:
{
"image_url"
:
"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg"
,
"video_url"
:
"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4"
}
,
"parameters"
:
{
"mode"
:
"wan-std"
}
}

请求示例代码

Shell

bash
curl --location --request POST '/qwen/api/v1/services/aigc/image2video/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "wan2.2-animate-move",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg",
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4"
    },
    "parameters": {
        "mode": "wan-std"
    }
  }'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

text
object

示例

json
{}