API Reference
AI avatar HD render API
POST
digital-human-api
ID 11
Render an avatar video from a person video and driving audio. The job is async.
POST
https://xiaoapis.com/api/aihuman/create
Overview
- 视频 + 音频驱动合成
- 异步任务
- 回调通知
- 任务查询
Use cases
- 数字人口播
- 企业宣传自动化
- AI Agent 成片
Conventions
- Gateway ·
https://xiaoapis.com - Auth · send
key(query or JSON body, as this API specifies) - Response · JSON. Check the business code and the HTTP status, not only HTTP 200
Authentication
Send the platform API key (query parameter key or JSON field key, as this page specifies). Create one in API key management.
POST https://xiaoapis.com/api/aihuman/create
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
Request example
https://xiaoapis.com/api/aihuman/create?key=你的密钥
Details
请求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 |
Response example
{ "code": 200, "data": { "task_id": "string" }, "msg": "string"}
FAQ
什么是数字人 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；常见原因是素材不可达、格式不符或额度不足。
Related APIs
- Text to speech API
- Voice cloning API
- Public avatar list API
- Public voice list API
- Smart editing — presenter video API
- Photo avatar API
Full console doc (with the debugger):/doc/11