Install
openclaw skills install @alouhaou/background-removeAI Background Removal - Remove background from images, create transparent PNG. Supports JPG, PNG, WebP local files and remote URLs. One credit per image.
openclaw skills install @alouhaou/background-removeRemove image backgrounds with AI via verging.ai. Returns transparent PNG.
/background-removal --image <image file or URL> [options]
| Option | Short | Description | Default |
|---|---|---|---|
| --image | -i | Image file path or URL | Required |
| --api-key | -k | API Key | $VERGING_API_KEY |
| --output | -o | Save path for result | Current directory |
| --download | -d | Auto download result | false |
Recommended: Authorization: ApiKey <your_key>
# ✅ Recommended (canonical form)
curl -H "Authorization: ApiKey vrg_sk_your_key_here" https://verging.ai/api/v1/auth/me
# ✅ Also works (Bearer with API key is supported)
curl -H "Authorization: Bearer vrg_sk_your_key_here" https://verging.ai/api/v1/auth/me
Get your API key: https://verging.ai → Login → Avatar → API Keys
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/auth/me
Response: {"email":"...","name":"...","credits":100}
# ⚠️ image is a FILE upload (@path) — server handles R2 upload internally
# ⚠️ You do NOT need to use /upload-video separately for background removal
curl -X POST https://verging.ai/api/v1/background-removal/create-job \
-H "Authorization: ApiKey $VERGING_API_KEY" \
-F "image=@/tmp/verging-bg-removal/photo.jpg" \
-F "file_name=photo.jpg" \
-F "job_type=background-removal"
Response: {"code":10000,"result":{"job_id":"456"},"message":{"en":"Request Success","zh":"提交任务成功"}}
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
"https://verging.ai/api/v1/background-removal/jobs?job_ids=456"
Response: [{"id":456,"status":"COMPLETED","progress":100,"result_url":"https://...","image_url":"https://...","created_at":"...","updated_at":"..."}]
Status values: PENDING → PROCESSING → COMPLETED (or FAILED)
curl -L -o /tmp/verging-bg-removal/photo.jpg "URL"image=@path — server uploads to R2 internally, no separate upload step needed)Authorization: ApiKey <key> (recommended) — Bearer <key> also worksimage=@pathimage must be a file upload (@path) — NOT a URL string/tmp/verging-bg-removal/export VERGING_API_KEY="your_key"