图片换脸
人脸交换
图片换脸
无需检测步骤,直接替换图片中的主要人脸。
POST
图片换脸
概述
单人图片换脸用于将图片中的主要人脸替换为一张新人脸图片。此接口不需要先做人脸检测,只需提交原始图片地址和新人脸图片地址。请求示例
参数说明
需要换脸的图片 URL。
新人脸图片 URL。
查询任务状态
提交任务后,使用统一查询接口检查进度并获取结果:获取任务信息
了解如何查询任务状态并获取生成结果
相关资源
图片多人换脸
使用检测结果替换图片中的指定人脸
人脸检测结果
查询检测状态并获取
detect_id 与人脸列表通用 API
查看账户剩余积分
授权
所有 API 都需要通过 API Key 认证。
获取 API Key:
- 访问 API Key 管理页面 获取你的 API Key
使用方式: 添加到请求头:
x-api-key: YOUR_API_KEY
注意:
- 请妥善保管你的 API Key,不要分享给他人
- 如果怀疑 API Key 已泄露,请立即在管理页面重置
请求体
application/json
响应
请求成功
响应状态码
- 200:成功 - 请求已成功处理
- 401:未授权 - 认证凭据缺失或无效
- 402:余额不足 - 账户积分不足,无法执行操作
- 404:未找到 - 请求的资源或接口不存在
- 422:验证错误 - 请求参数未通过校验
- 429:请求过多 - 已超过该资源的请求限制
- 455:服务不可用 - 系统正在维护
- 500:服务器错误 - 处理请求时发生意外错误
- 501:生成失败 - 内容生成任务失败
- 505:功能已禁用 - 请求的功能当前不可用
可用选项:
200, 401, 402, 404, 422, 429, 455, 500, 501, 505 响应消息,失败时为错误描述
示例:
"success"
