企业官网建设流程全解析

数字人API接口新手开发文档—— 简单易懂，新手友好版

一、接口概述
本接口提供数字人短视频生成服务。只需准备一段真人视频和一段音频，调用接口即可让数字人"开口说话"，生成口播短视频。
基本信息如下：
项目 内容
接口名称 123数字人短视频API接口
接口状态 正常
认证方式 需实名认证
计费方式 按量计费
免费额度 10次
计费单价 1元/分钟
每日请求限制 无限制

二、接口信息
项目 说明
接口地址 https://#/api/ai/human123
返回格式 application/json
请求方式 HTTP GET / POST
请求示例 https://#/api/ai/human123?key=你的key&templateVideoId=视频URL&inputAudioUrl=音频URL

请求Header设置：
名称 值
Content-Type application/x-www-form-urlencoded;charset:utf-8;

三、计费说明
123数字人口播视频生成不足一分钟按秒扣费，数字人克隆训练免费。

四、提交任务（生成视频）
调用此接口可以提交一个数字人口播视频生成任务。以下是需要填写的参数说明：
必填参数：
参数名 类型 说明
key string 接口密钥，在控制台->密钥管理查看
type string 固定填 start，表示提交任务
templateVideoId string 视频URL地址或ID（数字人角色视频）
inputAudioUrl string 音频URL地址（要让数字人说的内容）

可选参数（不填也可以正常使用）：
参数名 类型 说明
callbackUrl string 自定义回调URL，任务完成后会通知你
subtitlefileurl string 字幕文件URL（支持SRT和ASS格式）
subtitle_y int 字幕显示位置（底部边距），默认自适应
subtitle_font_size int 字幕字号大小，默认10像素
subtitle_color string 字幕颜色，默认白色 &HFFFFFF
subtitle_border_color string 字幕描边颜色，默认黑色 &H000000
subtitle_outline int 字幕描边大小，默认1（0-4）
subtitle_shadow int 字幕阴影，默认0（0-3）
subtitle_alignment int 字幕对齐方式，默认2（底部居中）
subtitle_font int 字幕字体，默认1
videotitle string 视频标题
ailogo string AI水印LOGO，不想要就留空，默认1
bgm string 背景音乐URL或ID
bgm_volume string 背景音乐音量，默认0.3（0.0-1.0）
original_volume string 数字人音量，默认1.0（0.0-1.0）

视频要求：
1. 数量：1个 2. 大小：3GB以内 3. 时长：10秒-5分钟 4. 格式：mp4、mov等 5. 分辨率：最大支持4K 6. 帧率：>=25fps，推荐30fps 7. 色彩标准：SDR-Rec.709
音频要求：
1. 时长不超过100分钟 2. 文件大小不超过2G 3. 支持格式：wav、mp3、m4a、wma、ogg
拍摄提示：可朗读"123..."口令或自由说话，也可闭嘴不说话。推荐拍摄正常说话视频，建议用OSS存储。请确保视频已获授权且符合法律法规。

五、查询任务（查看结果）
提交任务后会得到一个 taskId，你可以用这个ID来查询任务进度和结果：
参数名 类型 说明
key string 接口密钥
type string 固定填 query，表示查询任务
taskId string 任务ID（提交任务时返回）

查询方式有两种：
1. 回调方式：提交时填写 callbackUrl，任务完成后系统会自动通知你。
2. 轮询方式：主动用 taskId 反复查询，直到收到成功结果。

六、返回结果说明
接口返回 JSON 格式数据，主要字段如下：
字段名 类型 说明
code int 状态码，200表示成功
msg string 状态信息描述
data object 请求结果数据集
data.taskId string 任务ID
data.status string 任务状态：SUBMIT已提交、GENERATING合成中、SUCCESS合成成功、FAILED合成失败
data.failedCode string 错误代码（失败时有值）
data.failedMessage string 失败原因描述
data.videoUrl string 生成的视频文件URL地址
data.duration string 视频时长（秒）
data.createTime string 创建时间
data.updateTime string 更新时间
data.subtitleFileUrl string 字幕文件URL
data.templateId string 数字人角色ID
data.templateVideoId string 数字人角色ID（status=SUCCESS时可用）
data.md5 string 视频文件MD5值
exec_time float 执行耗时（秒）
user_ip string 客户端IP

常见错误代码：
21000：没有成功记录ID | 21001：模型ID不存在 | 21002：视频格式异常 | 21003：音频格式异常 | 21004：音频下载失败 | 21005：视频下载失败 | 21006：存在多人脸

七、返回示例
成功时的返回示例：
{
"code": 200,
"msg": "查询成功",
"data": {
"taskId": "a9b86729-4691-425f-8b6d-e4a88c0e9c91",
"status": "SUCCESS",
"failedCode": 0,
"failedMessage": "",
"videoUrl": "https://#/#.mp4",
"duration": 60,
"createTime": "2026-05-03T21:41:53",
"updateTime": "2026-05-03T21:42:24",
"subtitleFileUrl": "",
"templateId": "a9b86729-4691-425f-8b6d-e4a88c0e9c91",
"templateVideoId": "a9b86729-4691-425f-8b6d-e4a88c0e9c91",
"md5": "78b35bb6b5f2b50e5438ed99fd7580d3"
},
"exec_time": 0.000548,
"ip": "1.204.205.30"
}

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