Head Swap

接口提示

head_swap 会替换包括面部、头发、轮廓和耳朵在内的完整头部. 如果只需替换面部区域, 请使用 face_swap

head_swap 仅接受 input[0].params 下已列出的字段, 未知字段会被拒绝

head_swap 使用公开模型 ID 计费, 最终费用通过任务响应中的 usage 对象返回

认证

authorization string required

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

访问 API Key 管理页面 获取 API Key

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model string required

请求使用的模型 ID

值： head_swap

---

input array required

输入数组. 传入一个对象, 并将模型参数放在 input[0].params 下

params object required

Head Swap 换头参数

image string required

头部将被替换的目标图片. 支持 HTTP 或 HTTPS URL 以及 Base64 编码图片数据

head_image string required

要替换到目标图片上的参考头部图片. 支持 HTTP 或 HTTPS URL 以及 Base64 编码图片数据

seed integer

随机种子. 设置为 0 或省略该字段时使用随机值

范围： 0 - 2147483647

轮询

由于结果生成需要时间，您需要在创建任务后轮询任务状态

初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取

轮询请求与响应示例见右侧

---

响应格式

error object

错误信息, 仅在状态为 failed 时存在

code string

错误码

message string

详细错误信息

---

output array

生成结果, 仅在状态为 completed 时存在

content array

生成的资源内容列表

type string

资源类型

值: image｜video

url string

处理后的资源 URL

jobId string

远端任务 ID

---

usage object

使用统计, 仅在状态为 completed 时存在

cost string

总费用（美元）

discount number

折扣金额

---

metadata object

元数据信息