图片数字人 API 快速接入指南（小白版）

欢迎使用图片数字人 API！只需一张静态照片和一句提示词，即可让照片“开口说话”，生成逼真的数字人播报视频。

接入前必读
实名认证：使用前需完成平台实名认证。
计费说明：按量计费，单价 1元/次（若选择1080p分辨率，计费翻倍）。
免费福利：新用户赠送 5次 免费调用额度。
并发限制：每日请求次数无限制，可放心调用。

️ 2. 接口基础信息
配置项   说明
接口地址   https://#/api/aivideo/humanvideo

请求方式   HTTP GET 或 HTTP POST

返回格式   application/json

请求头 (Header)   Content-Type: application/x-www-form-urlencoded;charset:utf-8;

请求参数说明

调用接口时，请携带以下参数：
参数名   必填   类型   示例值   详细说明
key   是   string   35kj5jnlj53453kl5j43nj5   接口密钥，请在控制台“密钥管理”中获取。

image_url   是   string   https://#/1/190000.jpg   人物照片URL。支持 jpg, png, webp, bmp, tiff, gif 格式。

prompt   是   string   数字人自然口播...   提示词。不传则默认：“数字人自然口播，嘴型匹配说话动态，头部轻微微动，呼吸肩动自然，面部稳定无扭曲，柔和慢镜头运镜。”

ratio   是   string   9:16   视频比例。可选 9:16(竖屏) 或 16:9(横屏)。建议：图片是竖屏就用竖屏，横屏就用横屏。

duration   否   string   10   视频时长。默认固定为10秒，无需手动传入。

resolution   否   string   720p   视频分辨率。默认 720p，可传 1080p（注意：1080p 计费翻倍）。

task_id   是   string   cgt-20260705185852-rgvmw   任务唯一标识ID。

返回参数说明
参数名   类型   说明
code   int   状态码（200 表示请求成功）。

msg   string   状态提示信息。

data   object   核心结果数据集，包含以下字段：

↳ task_id   string   任务ID，用于追踪生成进度。

↳ status   string   任务状态（如 succeeded 表示生成成功）。

↳ video_url   string   生成的视频下载地址。

↳ estimated_time   string   预计生成所需时间。

debug   string/array   调试数据（开发阶段可用）。

exec_time   float   接口执行耗时（秒）。

user_ip   string   客户端IP地址。

完整代码示例

请求示例
POST https://#/api/aivideo/humanvideo?key=你的key
Content-Type: application/x-www-form-urlencoded;charset:utf-8;

image_url=https://#/1/190000.jpg&prompt=数字人自然口播，嘴型匹配说话动态&ratio=9:16&task_id=cgt-20260705185852-rgvmw

成功返回示例
{
  "code": 200,
  "msg": "视频生成成功",
  "data": {
    "task_id": "cgt-20260705175319-4n4wj",
    "status": "succeeded",
    "video_url": "https://#/#.mp4"
  },
  "exec_time": 0.118394,
  "user_ip": "220.172.48.255"
}

新手避坑指南
图片选择：尽量使用正面、光线均匀、无遮挡的人像照片，生成效果最佳。
比例匹配：ratio 参数一定要和原图比例保持一致，否则可能会出现画面拉伸或黑边。
异步处理：视频生成需要一定时间，建议通过 task_id 轮询状态或等待回调，不要阻塞主线程。
成本控制：测试阶段请使用默认的 720p 分辨率，确认效果满意后再升级为 1080p，避免产生不必要的费用。

来源：酷虎数字人开放平台