众扬汇 AI 开放平台 API 文档

声动人像 VideoRetalk

做什么:基于人物视频与人声音频,重新生成口型,使其与输入音频对齐;可选传参考图。

一、提交任务

curl
curl --location 'https://api.allyang.cn/qwen/api/v1/services/aigc/image2video/video-synthesis/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer <API-Key>" \
--header 'Content-Type: application/json' \
--data '{
    "model": "videoretalk",
    "input": {
        "video_url": "<人物视频地址>",
        "audio_url": "<人声音频地址>",
        "ref_image_url": ""
    },
    "parameters": {
        "video_extension": false
    }
}'

ref_image_url 可留空;video_extension 控制是否在结果后延展视频。

json
{
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
        "task_status": "PENDING"
    },
    "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}

二、查询任务状态

curl
curl -X GET 'https://api.allyang.cn/qwen/api/v1/tasks/<task_id>' \
--header "Authorization: Bearer <API-Key>"
json
{
    "request_id": "87b9dce5-7f36-4305-a347-xxxxxx",
    "output": {
        "task_id": "3afd65eb-9604-48ea-8a91-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-11 20:15:29.887",
        "scheduled_time": "2025-09-11 20:15:36.741",
        "end_time": "2025-09-11 20:16:40.577",
        "video_url": "<生成视频地址>"
    },
    "usage": {
        "video_duration": 7.16,
        "video_ratio": "standard"
    }
}

可用模型

模型名称 说明 单价
videoretalk 生成口型与输入音频匹配的新视频 0.08 元/秒

单价口径:数值来自源文档,未核价,正式以「模型广场」为准。