SuperAPI AI 工具集

remove-background

编程与开发

查看项目

更新于 10-15 17:29

技能介绍

用途:把图片背景移除,输出带透明通道的 PNG 抠图,用于电商产品图、人像头像、前景分割与合成素材。由 Bria RMBG 2.0 模型驱动,资料称其可商用、免版税。

主要能力:支持本地文件路径(JPEG、PNG、WEBP,自动 base64 编码上传)和公开图片 URL;输出为透明 PNG 的下载 URL。可处理头发与毛发、透明或半透明物体、复杂背景、多主体和精细细节。除普通去背景外,还有引导式接口 POST /v2/image/edit/remove_background/guided,用 prompt 指定保留、移除或只保留某个对象。

使用方式:先配置认证。检查 ~/.bria/credentials,若无凭证则走设备授权流程,请求 https://engine.prod.bria-api.com/v2/auth/device/authorize 获取 user_code 让用户登录授权,再轮询 /v2/auth/token 获取令牌并保存。随后调用 /v2/auth/token/introspect 检查计费状态并取得 api_token。调用时加载客户端脚本后使用 bria_call,例如: source ~/.agents/skills/remove-background/references/code-examples/bria_client.sh RESULT_URL=$(bria_call /v2/image/edit/remove_background "/path/to/image.png") 再用 curl -sL "$RESULT_URL" -o output.png 下载结果。bria_call 负责认证、编码、构造请求与异步轮询。引导式调用示例: RESULT_URL=$(bria_call /v2/image/edit/remove_background/guided "/path/to/yoga.jpg" '"prompt":"the person with the mat and the plant"')

适用场景:电商产品抠图、人像与头像去背景、批量处理目录图片、前景提取用于合成与图层分离。

限制与注意:引导式调用耗时约 15-20 秒,普通调用更快;若引导式接口返回 404,表示当前组织不可用,应回退到普通去背景,其他错误(401、422、5xx、超时)需如实报错。计费被阻止时须提示用户并停止调用。若 prompt 为空仍按引导式计费,因此纯去背景应走普通接口。把某个非显著对象从场景中单独提取(如“extract the tree”)应使用 bria-ai 的 extract_object,不属于本技能。其他参数与价格资料暂未提供。