用途:background-remover 是调用 verging.ai AI 抠图能力的 CLI 助手,用于去除图片背景、生成透明 PNG,适合电商产品图、人像头像和设计素材等场景。
主要能力:支持本地图片路径或远程图片 URL;支持 JPG/JPEG、PNG、WebP,单文件最大 10MB;处理完成后返回结果 URL,可选自动下载到本地。
使用方式:命令格式为 /background-remover --image <图片文件或URL> [选项]。选项包括 --image/-i(必填)、--api-key/-k、--output/-o(默认当前目录)、--download/-d(默认 false)。API Key 也可通过环境变量 VERGING_API_KEY 提供,API 基础地址由 VERGING_API_URL 指定,默认 https://verging.ai/api/v1。
处理流程:解析参数(远程 URL 先用 curl 下载);调用 /api/v1/auth/me 检查积分;调用 /api/v1/upload-video 获取 R2 预签名上传地址并用 PUT 上传;调用 /api/v1/background-removal/create-job 创建任务;每 5 秒轮询 /api/v1/background-removal/jobs?job_ids=xxx,状态为 PENDING → PROCESSING → COMPLETED/FAILED;完成后返回 result_url,若指定 --download 或 --output 则用 curl 下载。
认证:请求头格式为 Authorization: ApiKey <your_api_key>,注意 ApiKey 与密钥之间有一个空格。API Key 可在 https://verging.ai 登录后点击头像进入 API Keys 获取。
限制与计费:抠图每张图片消耗 1 credit,积分不足需充值;依赖 curl;本地临时文件存放于 /tmp/verging-bg-removal/ 并在处理后清理;图片会上传至 verging.ai 的 R2 存储处理,结果通过公开 URL 返回。其他收费、平台或效果信息暂未提供。