通义万相-视频换人API参考

北京地域：POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

新加坡地域：POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

步骤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-mix",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/bhkfor/mix_input_image.jpeg",
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/wqefue/mix_input_video.mp4"
    },
    "parameters": {
        "mode": "wan-std"
    }
  }'

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

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/0385dc79-5ff8-4d82-bcb6-xxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "request_id": "a67f8716-18ef-447c-a286-xxxxxx",
    "output": {
        "task_id": "0385dc79-5ff8-4d82-bcb6-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"
    }
}

wan2.2-animate-mix 模型提供标准模式wan-std和专业模式wan-pro两种服务模式，以满足不同场景对视频换人效果的需求。

计费规则

• 计费模式：采用按量后付费模式。按成功生成的视频秒数计费，计费时长以任务成功响应中的 usage.video_duration 字段为准。

  点击查看计费示例

  费用在免费额度耗尽后开始计算。计费公式为：总费用 = 视频实际生成时长 (秒) × 所选服务模式的单价。

  假设您调用北京地域的模型生成一个视频，任务成功后返回的 usage.video_duration 为 5.2 秒，且选择的是标准模式wan-std。

  费用计算为 5.2 秒 * 0.6元/秒 = 3.12元

  注：计费时长以任务成功后返回的 usage.video_duration 字段为最终依据。

• 抵扣顺序：优先消耗免费额度。额度用尽后，默认转为按量付费。可开启“免费额度用完即停”功能，以避免免费额度耗尽后产生额外费用。详情请参见免费额度。

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

限流：主账号与RAM子账号合计请求频率上限为5次/秒，最多有1个任务在处理中，超出限制的新任务将进入排队队列。模型限流规则及常见问题，请参见限流。

Q: 如何查看模型调用量？

A: 模型的调用信息存在小时级延迟，在模型调用完约一小时后，请在模型观测（北京或新加坡）页面，查看调用量、调用次数、成功率等指标。如何查看模型调用记录？

Q: 如何优化生成视频的效果?

A: 可参考以下建议

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

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

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

Q: 如何将临时的视频链接转为永久链接？

A: 不能直接转换该链接。正确的做法是：后端服务获取到url后，通过代码下载该视频文件，然后将其上传到永久对象存储服务（如阿里云 OSS），生成一个新的、永久访问链接。

import requests

def download_and_save_video(video_url, save_path):
    try:
        response = requests.get(video_url, stream=True, timeout=300) # 设置超时
        response.raise_for_status() # 如果HTTP状态码不是200，则引发异常
        with open(save_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f"视频已成功下载到: {save_path}")
        # 此处可以接上传到永久存储的逻辑
    except requests.exceptions.RequestException as e:
        print(f"下载视频失败: {e}")

if __name__ == '__main__':
    video_url = "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxxx"
    save_path = "video.mp4"
    download_and_save_video(video_url, save_path)

Q: 返回的视频链接可以在浏览器中直接播放吗？

A: 不建议这样做，因为链接会在 24 小时后失效。最佳实践是后端下载转存后，使用永久链接进行视频播放。