创建数字人任务

POST /v1/videos/avatar/image2video：用一张人像和一段音频生成口播视频，异步

POST/v1/videos/avatar/image2video

用数字人参考图和音频生成说话视频。

项	值
模式	异步（提交 → 轮询 `GET /v1/videos/avatar/image2video/{id}`，见查询数字人任务）
计费	按输出视频实际时长（秒）结算，提交时按音频上限 300 秒预冻结

快速开始

curl https://api.vibelab.me/v1/videos/avatar/image2video \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://example.com/portrait.png",
    "sound_file": "https://example.com/speech.mp3",
    "prompt": "一边说话，一边兴奋地摇头晃脑",
    "mode": "std"
  }'

响应示例：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "6a0d571e-d36c-4811-bb2b-698c94b19a8c",
  "data": {
    "task_id": "893605946402811985",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": "your-id"
    },
    "created_at": 1722769557708,
    "updated_at": 1722769557708
  }
}

请求参数

请求头

参数	类型	必填	默认	说明
`Authorization`	string	是	-	`Bearer $LOOPTOKEN_API_KEY`
`Content-Type`	string	是	-	`application/json`

请求体

参数	类型	必填	默认	说明
`image`	string	是	-	数字人参考图，URL 或不带前缀的 Base64；jpg/jpeg/png，不超过 10MB，宽高不小于 300px，宽高比 1:2.5 到 2.5:1
`sound_file`	string	是	-	音频 URL 或 Base64；mp3/wav/m4a/aac，不超过 5MB，时长 2–300 秒
`prompt`	string	否	-	动作、情绪、运镜描述，不超过 2500 个字符
`mode`	string	否	`std`	`std` 或 `pro`
`watermark_info.enabled`	boolean	否	`false`	是否同时生成含水印结果
`callback_url`	string	否	-	任务状态变化时的 HTTPS 回调地址，见概览
`external_task_id`	string	否	-	自定义任务 ID，同一账号下不可重复

响应

字段	类型	说明
`code`	integer	`0` 表示成功，其余见错误
`message`	string	错误信息
`request_id`	string	请求 ID，排查问题时提供
`data.task_id`	string	任务 ID
`data.task_status`	string	`submitted`、`processing`、`succeed`、`failed`
`data.task_info.external_task_id`	string	创建时传入的自定义任务 ID
`data.created_at`、`data.updated_at`	integer	Unix 毫秒时间戳

计费

按输出视频实际时长（秒）结算。提交时按音频时长上限 300 秒预冻结额度，任务结束后多退少补；失败全额退回。

错误

本页参数校验返回 400 / 1201，message 原文如下：

HTTP	`code`	触发场景	处理
400	`1201`	`image is required and must be a string` / `sound_file is required and must be a string`	补齐必填字段
400	`1201`	`audio_id is not supported, use sound_file`	改传 `sound_file`
400	`1201`	`prompt must not exceed 2500 characters`	缩短提示词
400	`1201`	`mode must be std or pro`	传 `std` 或 `pro`

通用错误（鉴权、余额、并发、回调地址、上游错误）见 Kling 错误。

注意事项

与官方的差别 → 不支持 audio_id（它指向可灵账号里的历史作品，不属于你的账号），请改用 sound_file；响应不返回 final_unit_deduction、final_balance_deduction；callback_url 由 LoopToken 投递，external_task_id 在你的账号范围内去重。

创建数字人任务

本页内容