图片数字人 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你的keyContent-Type: application/x-www-form-urlencoded;charset:utf-8;image_urlhttps://#/1/190000.jpgprompt数字人自然口播嘴型匹配说话动态ratio9:16task_idcgt-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避免产生不必要的费用。来源酷虎数字人开放平台