API Reference
超凡数字人 API
POST
phototalk-api
ID 20
超凡数字人 API 将人物照片与驱动音频合成为说话/唱歌类虚拟形象视频，适合形象口播场景。
POST
https://xiaoapis.com/api/video/phototalk
概述
- 照片 + 音频驱动
- 异步生成
- 回调通知
适用场景
- 照片驱动口播
- 虚拟形象视频
- 营销口播
调用约定
- 网关 ·
https://xiaoapis.com - 鉴权 · 请求携带
key（Query 或 JSON Body，以本接口为准） - 回包 · JSON；请同时校验业务码与 HTTP 状态，不要只看 200
鉴权
请求需携带平台 API Key（查询参数 key 或 JSON 字段 key，以本接口说明为准）。在控制台 API Key 管理 创建密钥。
POST https://xiaoapis.com/api/video/phototalk
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
请求示例
https://xiaoapis.com/api/video/phototalk?key=你的密钥
详细说明
请求HEADER：
| 名称 | 值 |
|---|---|
| Content-Type | application/json |
请求参数说明：
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| key | 是 | string | 35kj5jnlj53453kl5j43nj5 | 接口密钥,在控制台->密钥管理查看 |
| image | 是 | string | https://a1t/images/store4.jpg | 网络图片URL |
| audio | 是 | string | mp3 | 音频地址 |
| resolution | 否 | string | 480p | 480p 、720p |
| seed | 否 | string | -1 | |
| notify | 是 | string | https://xx.com/xxx | 回调地址 （ 任务推送地址） |
返回参数说明：
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 状态信息 |
| data | string | 请求结果数据集 |
| - task_id | string | 任务ID |
| exec_time | float | 执行耗时 |
| user_ip | string | 客户端IP |
常见问题
超凡数字人和高清数字人有什么区别？
超凡数字人侧重照片驱动出镜；高清合成侧重人物视频驱动。按素材类型选择对应接口。
需要什么输入？
清晰的人物/主体照片与驱动音频（公网 URL），以及 API Key。
如何获取结果？
创建任务后通过回调或任务查询获取成片地址。
照片有什么要求？
建议半身、正面、清晰；具体分辨率与大小限制见接口文档。
可以配合 TTS 吗？
可以。先用 TTS 或声音克隆生成音频，再提交本接口。
相关接口
完整控制台文档（含调试台）：/doc/20