Recraft Remove Background API
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型名称 | recraft/remove-background |
|---|---|
| 类型 | 图像编辑（去背景） |
| 接口 | POST /v1/tasks |
| 价格 | 见 HiAPI 定价 |
Recraft 去背景:一张图片 URL 进、透明背景 PNG 出,发丝和毛发级边缘保留完整,适合电商产品图、人像和设计素材批量处理。
生产建议
生产环境建议
- 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
- GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
- 产物 URL 有有效期,拿到结果后请及时转存到自己的存储。
- 提交前先校验输入图的格式、大小和尺寸,超限任务会直接失败。
适用场景
电商产品图
抠出的商品直接叠加到新背景或纯色底,批量出图。
image_url人像与宠物
发丝、毛发级边缘细节保留完整,无需手动羽化。
image_url自动化流水线
只有一个参数、无需 prompt,极易接入批处理。
image_url请求参数
model string 必填 固定填 recraft/remove-background。
input object 必填 业务参数对象；recraft/remove-background 只有一个输入字段。
image_url string 必填 待去背景图片的公网可访问 URL(https)。PNG/JPG/WebP;单张不超过 5MB;边长 256-4096 像素;总像素不超过 16MP。
callback object 可选 可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。
url string 必填 传入 callback 时必填；接收任务终态通知的 HTTPS 地址。
when enum 可选 回调触发时机；当前建议固定为 final。
用例示例
逆光毛发抠图
逆光金毛幼犬 + 复杂花市背景实测,飞散毛发完整保留,输出透明 PNG。
请求体
{
"model": "recraft/remove-background",
"input": {
"image_url": "https://static.hiapi.ai/model-covers/recraft-remove-background/2026/09/01/golden-input-2048.jpg"
}
}获取结果
- 提交成功后立即返回 taskId（不等待生成完成）。
- 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
- status=success 后，从返回的 output[].url 下载透明背景 PNG。
- 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。
常见问题
输出是什么格式?
始终为透明背景 PNG(RGBA),与输入格式无关。
对输入图有什么要求?
PNG/JPG/WebP,单张不超过 5MB,边长 256-4096 像素,总像素不超过 16MP。超出限制的任务会失败,提交前请先校验。
需要写 prompt 吗?
不需要。该模型只接收一张图片 URL,没有任何文本参数。