双人数字人

双人数字人把一张双人合照 + 混合音频 + 两路单人音频驱动成两人对话的口型同步视频。异步任务，提交后轮询查状态。素材不在公网？先用文件上传换取 6 小时有效的 URL。

Base URL：https://api.aiclonevoicefree.com ｜鉴权：Authorization: Bearer sk_...

`POST /api/v2/avatar/dual`

字段	类型	必填	说明
`dual_image_url`	string	✅	双人合照 URL
`audio_mix_url`	string	✅	两人混合后的音频 URL
`audio1_url`	string	✅	说话人 1 的音频 URL
`audio2_url`	string	✅	说话人 2 的音频 URL
`mask1_url`	string	⬜	说话人 1 的遮罩（指定说话区域）
`resize_mode`	string	⬜	配合 `mask1_url`：`pad`（默认）/ `crop`
`width`	int	⬜	输出宽，默认 `1280`
`height`	int	⬜	输出高，默认 `720`

计费（视频积分）

cost = 向上取整(实测秒数 × 2)，即 2 积分/秒（双人）——提交时服务端从 audio_mix_url 实测音频时长计费，无需自报。音频超过 300 秒会被拒绝（audio_too_long）；无法读取时长时提交返回 audio_probe_failed（请确认 URL 可公开访问）。余额不足直接 402；失败自动退款。

算例：15 秒 = 15 × 2 = 30 积分

示例

curl -X POST https://api.aiclonevoicefree.com/api/v2/avatar/dual \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "dual_image_url": "https://your-cdn.com/two-people.png",
    "audio_mix_url": "https://your-cdn.com/mix.mp3",
    "audio1_url": "https://your-cdn.com/speaker1.mp3",
    "audio2_url": "https://your-cdn.com/speaker2.mp3",
    "width": 1280,
    "height": 720
  }'

响应 202

{
  "task_id": "task_...",
  "status": "pending",
  "capability": "avatar",
  "action": "dual",
  "model": "dual-avatar"
}

取结果

轮询 GET /api/v2/avatar/tasks/{task_id}，完成时 videoUrl 为成片地址：

{
  "status": "completed",
  "capability": "avatar",
  "model": "dual-avatar",
  "videoUrl": "https://.../result.mp4"
}

另见 AI 数字人（标准版与 Pro 接口）。

POST /api/v2/avatar/dual

计费（视频积分）

示例

取结果

On this page

`POST /api/v2/avatar/dual`