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

图片数字人 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，避免产生不必要的费用。

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