API Reference
AI 数字人高清合成 API
POST
digital-human-api
ID 11
销豹数字人 API 根据人物视频与驱动音频合成数字人口播视频，异步出片，适合短视频与自动化成片。
POST
https://apis.xiaobao.ink/api/aihuman/create
概述
- 视频 + 音频驱动合成
- 异步任务
- 回调通知
- 任务查询
适用场景
- 数字人口播
- 企业宣传自动化
- AI Agent 成片
调用约定
- 网关 ·
https://apis.xiaobao.ink - 鉴权 · 请求携带
key（Query 或 JSON Body，以本接口为准） - 回包 · JSON；请同时校验业务码与 HTTP 状态，不要只看 200
鉴权
请求需携带平台 API Key（查询参数 key 或 JSON 字段 key，以本接口说明为准）。在控制台 API Key 管理 创建密钥。
POST https://apis.xiaobao.ink/api/aihuman/create
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
请求示例
https://apis.xiaobao.ink/api/aihuman/create?key=你的密钥
详细说明
请求HEADER：
| 名称 | 值 |
|---|---|
| Content-Type | application/jso |
请求参数说明：
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| video_url | 是 | string | https://xx.mp4 | 视频地址 |
| audio_url | 是 | string | https://xx.mp3 | 音频地址 |
| notify | https://xx.com | 回调地址 （ 任务推送地址） |
返回参数说明：
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 状态信息 |
| data | array | 请求结果数据集 |
| - task_id | string | 任务id |
| exec_time | float | 执行耗时 |
| user_ip | string | 客户端IP |
返回示例
{ "code": 200, "data": { "task_id": "string" }, "msg": "string"}
常见问题
什么是数字人 API？
数字人 API 用人物参考视频与驱动音频生成口播出镜视频，把「文案→声音→出镜」接到业务系统。
数字人 API 怎么调用？
POST 提交 video_url、audio_url 与 key，创建异步任务后轮询查询接口或接收 notify 回调。
没有人物视频怎么办？
可先调用公共数字人形象列表接口获取平台提供的 video_url，再交给数字人合成。
没有音色怎么办？
可先调用公共音色列表拿到 voice_id，再用 TTS（voice_type=public）生成驱动音频。
素材有什么要求？
人物视频与音频均需公网可访问；清晰度、时长与格式限制以接口文档为准。
如何查询任务进度？
使用数字人任务查询接口，传入 create 返回的 task_id。
可以和智能剪辑一起用吗？
可以。数字人成片后可作为素材，再走智能剪辑包装成可发布短视频。
鉴权方式是什么？
统一使用平台 API Key（query 或 JSON 中的 key 字段，以文档为准）。
失败了怎么办？
查看返回码与 fail_reason / msg；常见原因是素材不可达、格式不符或额度不足。
相关接口
完整控制台文档（含调试台）：/doc/11