SuperAPI AI 工具集

background-removal

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

用途:调用 verging.ai 的 AI 背景移除接口,从图片中去除背景,返回透明 PNG。支持本地 JPG、PNG、WebP 文件及远程 URL,单张图片固定消耗 1 credit。

使用方式:命令格式为 /background-removal --image <图片文件或URL>,另有选项 --api-key/-k(默认读取环境变量 $VERGING_API_KEY)、--output/-o(结果保存路径,默认当前目录)、--download/-d(是否自动下载,默认 false)。

执行流程:解析参数并提取图片路径或 URL;若为 URL,用 curl -L -o /tmp/verging-bg-removal/photo.jpg "URL" 下载;校验文件存在、格式为 JPG/PNG/WebP 且小于 10MB;用 GET https://verging.ai/api/v1/auth/me 检查 credits(需 1 credit);用 POST https://verging.ai/api/v1/background-removal/create-job 创建任务,需 multipart 上传 image=@路径(服务端内部完成 R2 上传,无需单独上传步骤)以及 file_name、job_type=background-removal;随后每 5 秒轮询 GET https://verging.ai/api/v1/background-removal/jobs?job_ids=X,直到状态为 COMPLETED;最后返回或下载 result_url。状态依次为 PENDING、PROCESSING、COMPLETED,失败为 FAILED。

认证:推荐使用 Authorization: ApiKey <key>,也支持 Bearer <key>。API key 在 verging.ai 登录后通过头像菜单的 API Keys 获取。建议通过 export VERGING_API_KEY="your_key" 设置,不要泄露密钥。

限制:image 必须是文件上传形式(@path),不能是 URL 字符串;支持格式为 JPG、PNG、WebP,最大 10MB;费用固定为每张 1 credit;临时目录为 /tmp/verging-bg-removal/,使用后需清理临时文件。其余收费、价格或平台细节暂未提供。