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。

获取 Key ->

响应示例

错误码

状态码 说明
401 API Key 无效或缺失
400 参数错误,如缺 video/audio、地址格式非法、不支持的模型
400 余额不足,请充值
404 查询任务不存在或不属于当前账号
502 上游生成失败(失败自动全额退款)