跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Bria Eraser API

POST Base URL: https://api.hiapi.ai /v1/tasks

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 bria-eraser
类型 图像编辑（蒙版擦除）
接口 POST /v1/tasks
价格 见 HiAPI 定价

Bria Eraser：上传原图和黑白蒙版，擦除白色区域里的路人、杂物或瑕疵并自然补全背景，无需提示词，输出与原图同分辨率的 PNG。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
  • 产物 URL 有有效期，拿到结果后请及时转存到自己的存储。

适用场景

商品图清理

去掉商品图上的灰尘、划痕、价签或多余道具，商品本身保持不动。

image_urlmask_url
街景与旅行照片

擦掉画面里的路人、车辆或电线，补全成自然的背景。

mask_urlmask_type
透明素材修整

清理带透明背景的素材，开启 preserve_alpha 保留透明区域。

preserve_alpha

请求参数

model string 必填

固定填 bria-eraser。

示例 bria-eraser
input object 必填

业务参数对象，无需提示词。

image_url string 必填

要清理的图片公网 URL（http/https），支持 JPEG、PNG、WEBP；结果保持原图分辨率。

示例 https://dev-static.hiapi.ai/model-onboarding/bria-eraser/2026/10/21/1792546025379-46c31ddb2b52110d-e1-street-src.png
mask_url string 必填

黑白蒙版 URL，宽高比须与原图一致：白色区域擦除，黑色区域保留；白色范围比物体边缘略大更干净。

示例 https://dev-static.hiapi.ai/model-onboarding/bria-eraser/2026/10/21/1792546025861-e5d2a17ae1d12d41-e1-street-mask.png
mask_type enum 可选

手绘蒙版填 manual；分割工具生成的蒙版填 automatic。

默认 manual 可选值: manualautomatic
preserve_alpha boolean 可选

原图带透明通道时，结果中的透明区域保持透明。

默认 false
callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

手绘蒙版擦除路人

黄金任务：石板街原图，蒙版只把路人涂白，其余区域为黑色；mask_type 用 manual，输出 1360 × 768 PNG。

请求体
{
  "model": "bria-eraser",
  "input": {
    "image_url": "https://dev-static.hiapi.ai/model-onboarding/bria-eraser/2026/10/21/1792546025379-46c31ddb2b52110d-e1-street-src.png",
    "mask_url": "https://dev-static.hiapi.ai/model-onboarding/bria-eraser/2026/10/21/1792546025861-e5d2a17ae1d12d41-e1-street-mask.png",
    "mask_type": "manual"
  }
}
分割工具生成的蒙版

蒙版来自抠图或分割工具时改用 automatic。

请求体
{
  "model": "bria-eraser",
  "input": {
    "image_url": "https://dev-static.hiapi.ai/model-onboarding/bria-eraser/2026/10/21/1792546025379-46c31ddb2b52110d-e1-street-src.png",
    "mask_url": "https://dev-static.hiapi.ai/model-onboarding/bria-eraser/2026/10/21/1792546025861-e5d2a17ae1d12d41-e1-street-mask.png",
    "mask_type": "automatic"
  }
}

获取结果

  1. 提交成功后立即返回 taskId，不等待生成完成。
  2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后，从返回的 output 中取图片地址并下载。
  4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

蒙版怎么画？

白色涂出要去掉的内容，黑色保留；白色范围比物体边缘略大一些，擦除边缘会更干净。

蒙版必须和原图一样大吗？

宽高比必须与原图一致；建议直接按原图尺寸绘制蒙版。

需要写提示词吗？

不需要。接口不接收 prompt，被擦除的区域会按周围画面自动补全。

mask_type 选 manual 还是 automatic？

画笔手绘的蒙版用 manual（默认）；抠图或分割工具自动生成的蒙版用 automatic。

原图带透明背景时会怎样？

默认不保留透明；开启 preserve_alpha 后，原图里的透明区域在结果中保持透明。

输出是什么格式和尺寸？

输出 1 张 PNG，分辨率与原图相同（实测输入 1360 × 768，输出也是 1360 × 768）；PNG 为 RGBA 格式，未开启 preserve_alpha 时完全不透明。

支持哪些输入格式？

原图支持 JPEG、PNG、WEBP，通过公网可访问的 http/https 地址传入。

怎么计费？

按输出图片张数计费，每次请求返回 1 张；当前单价见实时价格页。

下一步