API Reference

换脸 API

Q: 如何获取结果？

异步任务完成后通过查询或回调获取成片。

Q: 是否保存素材？

以平台隐私政策与文件留存规则为准。

POST face-swap-api ID 21

视频换脸接口：将视频中的人脸替换为指定人像，用于创意与制作场景（须合法授权）。

POST https://apis.xiaobao.ink/api/video/aiface

获取 API Key 工作台 / 调试打开 Markdown

概述

视频 + 人脸图
异步任务

适用场景

创意视频
角色替换（已授权）

调用约定

网关 · https://apis.xiaobao.ink
鉴权 · 请求携带 key（Query 或 JSON Body，以本接口为准）
回包 · JSON；请同时校验业务码与 HTTP 状态，不要只看 200

鉴权

请求需携带平台 API Key（查询参数 key 或 JSON 字段 key，以本接口说明为准）。在控制台 API Key 管理创建密钥。

POST https://apis.xiaobao.ink/api/video/aiface
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

请求示例

https://apis.xiaobao.ink/api/video/aiface?key=你的密钥

详细说明

请求HEADER：

名称	值
Content-Type	application/json

请求参数说明：

名称	必填	类型	示例值	说明
key	是	string	35kj5jnlj53453kl5j43nj5	接口密钥,在控制台->密钥管理查看
image	是	string	https://api.xx.et/images/store4.jpg	上传换脸的图片
video	是	string	https://api.xx.et/im.mp4	视频地址
notify	是	string	https://xx.com/xxx	回调地址（任务推送地址）

返回参数说明：

名称	类型	说明
code	int	状态码
msg	string	状态信息
data	string	请求结果数据集
- task_id	string	任务ID
debug	string/array	调试数据
exec_time	float	执行耗时
user_ip	string	客户端IP

错误码

错误码	类型	说明
403	int	没有权限
400	int	参数传递不正确
500	int	服务器内部错误

常见问题

换脸 API 需要什么输入？

待处理视频 URL 与新人脸图片 URL，以及 API Key。

合规要求？

仅可处理你拥有合法权利的人像与视频，禁止未授权换脸。

如何获取结果？