background-removal

概览

background-removal 技能可以做什么

background-removal 技能通过 inference.sh (infsh) CLI 调用 BiRefNet 模型，为图片提供自动化的高质量抠图和背景移除。

适用于：

• 电商和平台用的干净产品图
• 人像、头像类照片抠图
• 需要透明 PNG 的营销与社媒创意素材
• 想在尽量少人工操作的情况下快速去除或替换背景的图片编辑场景

该技能只依赖 inference.sh 工具（Bash 下的 infsh * 命令），因此可以自然融入 shell 脚本、CI 流水线和各种自动化图片处理流程中。

核心能力

• 使用 BiRefNet 实现 精准背景移除，主体边缘清晰
• 输出 透明背景，适合导出 PNG 和后期合成
• 借助 falai/reve app 实现 基于 prompt 的背景替换（例如换成全新场景）
• 支持 先生成再编辑 的工作流：先用 AI 模型生成图片，再通过去除或更换背景进行精修

适用人群

在以下情况下，你可以考虑使用 background-removal 技能：

• 维护 电商商品库，需要统一、干净的商品图片
• 从事 市场或设计工作，希望自动化重复性的抠图任务
• 运行 批量图片处理流水线（脚本或 CI 任务），需要优先使用 CLI 来做背景移除
• 已在使用或愿意使用 inference.sh CLI 来运行 AI 图像模型

在这些情况下则 不太适合：

• 只希望使用桌面图形界面编辑器（不使用终端）
• 需要完全离线处理、不能依赖远程 AI 推理
• 必须手动精修、逐像素控制掩码的极致定制抠图

使用方法

前置条件

在使用 background-removal 技能之前，请确保：

• 有可用的 终端 环境（macOS、Linux，或 Windows 上的 WSL/PowerShell）
• 已安装 inference.sh CLI (infsh)
• 拥有一个 inference.sh 账号，用于运行如 infsh/birefnet 和 falai/reve 等 app

CLI 的安装说明维护在仓库中：

• https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md

安装 background-removal 技能

通过以下命令将该技能安装到你的 agent 或本地技能环境中：

npx skills add https://github.com/inferen-sh/skills --skill background-removal

此命令会从 inferen-sh/skills 仓库中拉取 background-removal 的配置，使你的 agent 能够调用相关的 infsh apps 和工作流。

第 1 步 – 使用 inference.sh CLI 登录

安装好 infsh 后，先完成登录，以便运行模型：

infsh login

根据终端提示完成登录流程。

第 2 步 – 使用 BiRefNet 做背景移除

对于简单的背景移除需求（例如把一张产品图生成透明 PNG），可以在 CLI 中直接调用 BiRefNet app：

infsh app run infsh/birefnet --input '{
  "image_url": "https://your-photo.jpg"
}'

将 https://your-photo.jpg 替换为可公网访问的图片 URL。该 app 会返回包含已完成背景移除图片链接的 JSON 输出。

第 3 步 – 使用 Reve 编辑背景（可选）

如果不仅仅是移除背景，还想把背景换成特定场景，可以使用技能中展示的 Reve 图片编辑能力。

移除背景并变为透明

infsh app run falai/reve --input '{
  "prompt": "remove the background, make it transparent",
  "image_url": "https://portrait.jpg"
}'

将背景替换为新场景

infsh app run falai/reve --input '{
  "prompt": "change the background to a beach",
  "image_url": "https://product-photo.jpg"
}'

根据需要调整 prompt 文本，描述你想要的背景（如 studio white、gradient、office、nature 等）。

第 4 步 – 先生成再编辑（AI 图像工作流）

background-removal 技能还演示了一种“生成 + 编辑”的工作流模式：

1. 使用 AI 模型 生成图片
2. 再对图片进行 编辑，移除或调整背景

示例（结构参考仓库中的片段）：

# 1. 生成一张图片
infsh app run falai/flux-dev-lora --input '{
  "prompt": "a cute robot mascot"
}' > robot.json

# 2. 从 robot.json 中提取 image_url（用 jq 或类似工具），再用 Reve 编辑
# （伪示例，根据你的实际工具链调整）
IMAGE_URL=$(jq -r '.image_url' robot.json)

infsh app run falai/reve --input "{
  \"prompt\": \"remove background, make it transparent\",
  \"image_url\": \"$IMAGE_URL\"
}"

这种模式特别适合先批量生成图片，再统一进行抠图和背景处理，用于市场推广或产品展示。

集成到脚本和自动化流程中

由于 background-removal 技能是基于 CLI 驱动的，非常适合与 Bash 脚本或 CI 工作流集成：

• 遍历一个包含商品图片 URL 的 CSV 或列表
• 对每个 URL 调用 infsh app run infsh/birefnet
• 将返回的 URL 或已下载图片保存到你的资产管线中

Bash 示意脚本：

while read -r URL; do
  echo "Processing $URL"
  infsh app run infsh/birefnet --input "{\"image_url\": \"$URL\"}" >> results.json
done < product-images.txt

你可以根据自己的存储方式（S3、CDN、本地文件夹等）和后处理需求对其进行扩展。

常见问题

什么时候应该用 background-removal 技能，而不是桌面编辑器？

当你需要可复现、可脚本化的批量背景移除时，更推荐使用 background-removal 技能，尤其是要处理大量图片的场景。它非常适合偏好 CLI 工具、自动化，或希望把 AI 图像编辑整合进现有流水线的团队。若只是零星处理少量图片，并更习惯可视化操作，桌面编辑器可能更顺手。

background-removal 依赖哪些模型和工具？

该技能主要基于：

• BiRefNet (infsh/birefnet)：用于高精度背景移除
• Reve (falai/reve)：用于基于 prompt 的图像编辑，包括背景替换
• 示例工作流中的 flux-dev-lora (falai/flux-dev-lora)：用于图像生成
• 作为执行入口的 inference.sh CLI (infsh)

使用这个技能是否必须安装 inference.sh CLI？

是的。background-removal 技能假定你已经安装并配置好了 inference.sh CLI。技能中展示的命令（例如 infsh login 和 infsh app run ...）在没有 CLI 的情况下无法运行。

我能用本地图片文件而不是 URL 吗？

仓库示例使用的是带 HTTP 链接的 image_url。是否支持本地文件取决于当前 infsh CLI 和具体 app 的能力。请查看最新的 infsh 文档以及 infsh/birefnet、falai/reve 的 app 说明，了解在你的环境中是否支持本地文件路径或文件上传。

background-removal 能完全离线使用吗？

不能。background-removal 技能是通过 inference.sh 平台调用远程推理 app 的，因此需要网络连接。如果你必须完全离线处理，需要选择其他本地部署的解决方案。

在营销和电商场景中的典型用法有哪些？

常见用法包括：

• 将原始产品拍摄图片转换为干净、透明 PNG，用于 店铺和电商平台
• 将整个商品库的背景统一（例如全部纯白或浅灰）
• 为 营销活动视觉物料 做准备，对主视觉图片进行背景移除和替换
• 快速清理达人图、人物照片，用于落地页和社交媒体

想要快速上手、尽量少配置，该怎么做？

1. 按照 cli-install.md 中的说明安装 inference.sh CLI。
2. 运行 infsh login 完成登录。
3. 使用以下命令测试一张图片：

   infsh app run infsh/birefnet --input '{
     "image_url": "https://your-photo.jpg"
   }'
   

4. 如果效果符合预期，就可以通过 background-removal 技能将该命令集成进你的脚本或 agent 配置中。

在哪里可以查看该技能的配置？

在 inferen-sh/skills 仓库中，打开 tools/image/background-removal/SKILL.md 文件。里面记录了技能名称、描述、允许调用的工具，以及本指南中总结的示例命令等信息。