一、接口概述
4K 超清数字人 API 接口（数字人分身短视频训练 API）支持快速训练专属数字人分身形象，可 1:1 复刻真人 4K 超清高保真数字人。接口提供免费使用权限（需实名认证），支持 2K/4K 高清数字人模型生成，适用于短视频制作、虚拟形象打造等场景。
二、基本信息
更新日期：2025-06-06
每日限制：无调用次数限制
请求频率：1 秒内最多 20 次请求
接口地址：/api/aih/train
返回格式：application/json
请求方式：HTTP GET
三、请求示例
/api/aih/train?key=你的key&video_url=视频URL&callbackUrl=回调URL
四、请求参数说明
参数名称    必填    类型    示例值    说明
key    是    string    35kj5jnlj53453kl5j43nj5    接口密钥，可在控制台「密钥管理」中查看
video_url    是    string    https://*/1/1.mp4    视频 URL 地址，需满足格式及内容要求
callbackUrl    否    string    https://#/callback/    自定义回调 URL，训练完成后通过 POST 请求返回结果；若不填写，需通过轮询方式主动获取结果
五、视频要求
格式：仅支持 mp4/mov 格式。
大小：视频文件需小于 5GB。
内容：
避免多人脸画面，确保主体人脸清晰；
面部不得被遮挡，且人脸宽度需占画面宽度的 1/4 以上，不超出屏幕范围；
分辨率：不低于 360p，不高于 4K；
时长：5 秒至 30 分钟之间，视频中可朗读口令（如 “123”）、自由说话或保持闭嘴状态。
六、授权提示
请确保上传的视频已获得合法授权，且内容符合法律法规要求，避免侵权风险。
七、返回参数说明
参数名称    类型    说明
code    int    状态码，200 表示请求成功
msg    string    状态信息，“ok” 表示任务创建成功，其他为异常提示
time    float    响应时间
task_id    string    任务 ID，用于轮询结果或关联任务
model_id    string    生成的数字人模型 ID
八、关联接口
数字人训练 H⁺获取结果：用于通过任务 ID 轮询训练结果（需主动调用）。
数字人合成 H⁺：支持基于训练好的数字人模型进行视频合成。
九、使用流程建议
准备符合要求的真人视频素材，确保人脸清晰且画面规范；
通过控制台获取接口密钥（key）；
构造请求 URL，传入 key、video_url 及可选的 callbackUrl；
发送 GET 请求，获取 task_id 和 model_id；
若未设置回调 URL，需通过 “数字人训练 H⁺获取结果” 接口轮询训练状态，直至任务完成。
十、注意事项
未实名认证时无法使用接口，需先完成身份验证；
视频质量直接影响数字人复刻效果，建议上传说话状态的视频样本（非闭嘴视频）；
合成效果示例可参考官方提供的视频（需通过合规渠道获取）。