通义万相-图生动作API参考

步骤1：创建任务获取任务ID

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": "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": {
        "check_image": true,
        "mode": "wan-std"
    }
  }'

步骤2：根据任务ID查询结果

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/d279369d-97d5-40ad-a30d-xxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "request_id": "a67f8716-18ef-447c-a286-xxxxxx",
    "output": {
        "task_id": "d279369d-97d5-40ad-a30d-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-18 15:32:00.105",
        "scheduled_time": "2025-09-18 15:32:15.066",
        "end_time": "2025-09-18 15:34:41.898",
        "results": {
            "video_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxx.mp4?Expires=xxxxxx"
        }
    },
    "usage": {
        "video_duration": 5.2,
        "video_ratio": "standard"
    }
}

{
    "request_id": "daad9007-6acd-9fb3-a6bc-xxxxxx",
    "output": {
        "task_id": "fe8aa114-d9f1-4f76-b598-xxxxxx",
        "task_status": "FAILED",
        "code": "InternalError",
        "message": "xxxxxx"
    }
}

使用限制

• 输入内容限制：以下是输入图片与视频的内容限制，对于视频，相关要求适用于首帧。

  • 人数：必须仅包含一个人，不能无人或多人。

  • 清晰度：必须清晰，特别是人脸部分，不能过暗或模糊。

  • 完整性：人脸必须 完整无遮挡。

  • 朝向：人物需要正面朝向镜头，不能是背身。人脸朝向应基本正对，不能有严重偏斜。

  • 构图：人物在图片中的占比要适中，不能过大（如大头贴）或过小。

  除此之外，输入图片与视频还需要满足格式、尺寸、大小等限制。

• 内容审核：输入的图片与视频均会经过内容安全审核，包含违规内容的请求将报错“IPInfringementSuspect”或“DataInspectionFailed”，具体参见错误信息。

• 数据时效：任务task_id和视频URL均只保留 24 小时，过期后将无法查询或下载，请及时下载视频到本地。

使用建议

为了优化视频换人效果，请参考以下建议：：

1. 确保输入图片与参考视频中的人物画幅占比相似。

2. 尽量保持图片和视频中人物的身材比例一致。

3. 使用高清素材，避免使用模糊图片和低帧率视频，确保细节识别准确。

计费规则

• 计费项：按成功生成的 视频秒数 计费，采用按量后付费模式。

• 计费公式：费用 = 计费单价 × 视频时长（秒）。

• 抵扣顺序：优先消耗免费额度。额度用尽后，默认转为按量付费。

  • 您可开启“免费额度用完即停”功能，以避免免费额度耗尽后产生额外费用。详情请参见免费额度。

• 失败不计费：模型调用失败或处理错误不产生任何费用，也不消耗免费额度。

免费额度

关于免费额度的领取、查询、使用方法等详情，请参见免费额度。

调用量查询

模型调用完约一小时后，请在模型观测页面，查看调用量、调用次数、成功率等指标。

限流

模型限流规则及常见问题，请参见限流。