AI 数字人

AI 数字人把一张照片（或一段输入视频）+ 一段音频驱动成口型同步的说话视频。异步任务，提交后轮询查状态。

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

`POST /api/v2/avatar/digital-human`

字段	类型	必填	说明
`image_url`	string	⬜*	人像照片 URL（`image_url` 与 `input_video_url` 至少给一个）
`input_video_url`	string	⬜*	输入视频 URL（驱动已有视频）
`audio_url`	string	✅	说话音频 URL
`audio_duration_seconds`	number	✅	音频时长（秒），用于计费
`width`	int	⬜	输出宽，默认 `1280`
`height`	int	⬜	输出高，默认 `720`

计费（视频积分）

cost = 向上取整(audio_duration_seconds) × 倍率，倍率 = 当 width ≥ 1000 或 height ≥ 1000 时为 5，否则为 1（即标清 1 积分/秒、高清 5 积分/秒）。提交时不足直接 402；失败自动退款。

算例

标清 854×480、12 秒 = 12 × 1 = 12 积分
高清 1280×720、12 秒 = 12 × 5 = 60 积分

示例

curl -X POST https://api.aiclonevoicefree.com/api/v2/avatar/digital-human \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://your-cdn.com/portrait.png",
    "audio_url": "https://your-cdn.com/speech.mp3",
    "audio_duration_seconds": 12,
    "width": 1280,
    "height": 720
  }'

响应 202

{
  "task_id": "b1d2...-uuid",
  "status": "pending",
  "capability": "avatar",
  "action": "digital-human",
  "model": "digital-human"
}

取结果

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

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

另见 AI 数字人 Pro（高清直出）与双人数字人。

POST /api/v2/avatar/digital-human

计费（视频积分）

示例

取结果

On this page

`POST /api/v2/avatar/digital-human`