aliyun/videoretalk
声动人像 VideoRetalk:上传人物视频 + 配音音频,生成口型同步视频(2-120 秒)。异步任务式:创建任务拿 task_id,再用 GET /v1/videos/{task_id} 轮询(与视频生成同一查询接口)。
接口详情
POST
https://ai.codenews.cc/v1/videos/lip-sync请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| video | string | 是 | - | 人物视频公网 URL(mp4/avi/mov,≤300MB,2-120 秒) |
| audio | string | 是 | - | 配音音频:公网 URL 或 data:audio/*;base64,...(wav/mp3/aac,≤30MB,2-120 秒) |
| ref_image | string | 否 | - | 指定目标人脸图(多人画面时使用),公网 URL 或 base64 |
| duration | number | 否 | - | 预扣费提示时长(秒,2-120):传入则按该时长预扣,结算时按实际输出时长多退少补;不传则不预扣 |
| model | string | 否 | - | aliyun/videoretalk,不传按权重随机路由 |
代码示例
请将 $API_KEY 替换为您在控制台申请的真实 API Key。
响应示例
错误码
| 状态码 | 说明 |
|---|---|
| 401 | API Key 无效或缺失 |
| 400 | 参数错误,如缺 video/audio、地址格式非法、不支持的模型 |
| 400 | 余额不足,请充值 |
| 404 | 查询任务不存在或不属于当前账号 |
| 502 | 上游生成失败(失败自动全额退款) |