Image Background Remove
by @alouhaou
AI Background Removal - Remove background from images, create transparent PNG, one-click background remover for e-commerce product photos, portrait headshots...
clawhub install background-removeπ About This Skill
name: background-remover description: AI Background Removal - Remove background from images, create transparent PNG, one-click background remover for e-commerce product photos, portrait headshots, design materials. Supports JPG, PNG, WebP local files and remote URLs. version: 1.0.0 author: verging.ai category: media user-invocable: true metadata: openclaw: requires: env: - VERGING_API_KEY bins: - curl primaryEnv: VERGING_API_KEY
background-remover - AI Background Removal
Remove background from images, create transparent PNG with one-click AI.
Use Cases
You are a CLI assistant for AI background removal. Users can use you to call verging.ai's AI background removal functionality.
User Input Format
Users will provide commands like:
/background-remover --image [options]
Options
| Option | Short | Description | Default | |--------|-------|-------------|---------| | --image | -i | Target image file path or URL | Required | | --api-key | -k | Your API Key | VERGING_API_KEY env | | --output | -o | Result save path | Current directory | | --download | -d | Auto download result to local | false |
Environment Variables
| Variable | Description | |----------|-------------| | VERGING_API_KEY | Your API Key | | VERGING_API_URL | API base URL (default: https://verging.ai/api/v1) |
API Endpoints
| Endpoint | Method | Format | Purpose | |----------|--------|--------|---------| | /api/v1/auth/me | GET | - | Get user info (including credits) | | /api/v1/upload-video | POST | Form Data | Get R2 presigned upload URL | | /api/v1/background-removal/create-job | POST | Form Data | Create background removal job | | /api/v1/background-removal/jobs | GET | - | Query job status |
Authentication
All API requests require authentication via the Authorization header:
Authorization: ApiKey
β οΈ Important: There is a space between "ApiKey" and your key!
Example:
# β
Correct
Authorization: ApiKey vrg_sk_123456...β Wrong (missing space)
Authorization: ApiKeyvrg_sk_123456...
You can get your API key from https://verging.ai (Login β Click avatar β API Keys).
Authentication Examples
# Check user info
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/auth/meStep 1: Get presigned upload URL for image
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
-F "video_file_name=image.jpg" \
-F "job_type=background-removal" \
https://verging.ai/api/v1/upload-videoThe response contains:
{
"result": {
"url": "https://...r2.cloudflarestorage.com/...jpg?X-Amz-...",
"public_url": "https://img.panpan8.com/background-removal/2026-03-11/xxx.jpg"
}
}
Step 2: Upload image to the presigned URL
curl -X PUT -T /path/to/image.jpg \
"https://...presigned-url-from-step-1..."Step 3: Create background removal job
Use the public_url from Step 2
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
-F "image=@/path/to/image.jpg" \
-F "file_name=image.jpg" \
-F "job_type=background-removal" \
https://verging.ai/api/v1/background-removal/create-jobQuery job status
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
"https://verging.ai/api/v1/background-removal/jobs?job_ids=123"List all jobs
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/background-removal/jobs
Important:
$VERGING_API_KEY with your actual API key or set it as an environment variableAuthorization header uses format: ApiKey (not Bearer )Dependencies
This skill requires:
Processing Flow
When the user executes the /background-removal command, please follow these steps:
0. Check Dependencies
1. Parse Arguments
2. Check User Credits
3. Upload Image to R2
/api/v1/upload-video with Form Data (video_file_name, job_type)public_url from response for next step4. Create Job
/api/v1/background-removal/create-job with Form Data:image: Image file (will be uploaded to R2)
- file_name: Original file name
- job_type: "background-removal"5. Poll Job Status
/api/v1/background-removal/jobs?job_ids=xxx to query status6. Return Result
Credit Consumption
| Operation | Credits | |-----------|---------| | Background Removal (per image) | 1 credit |
Supported Image Formats
Maximum file size: 10MB
Example Conversation
User: /background-removal -i ./photo.jpg
You: 1. Parse arguments - local image 2. Call API to get user info 3. Check credits sufficient (1 credit) 4. Upload image to R2 5. Create background removal job 6. Poll for completion 7. Return result URL
User: /background-removal -i https://example.com/photo.jpg
You: 1. Parse arguments - remote image URL 2. Download image to local temp directory 3. Call API to get user info 4. Check credits sufficient 5. Upload image to R2 6. Create background removal job 7. Poll for completion 8. Return result URL
Notes
Privacy and Security
API Key
This skill requires a verging.ai API Key. Get it from: 1. Visit https://verging.ai 2. Login β Click user avatar (top right) β Select "API Keys" 3. Create a new API key
Security recommendations:
export VERGING_API_KEY="your_key"Data Handling
/tmp/verging-bg-removal/ and cleaned up after processingβ‘ When to Use
βοΈ Configuration
| Option | Short | Description | Default | |--------|-------|-------------|---------| | --image | -i | Target image file path or URL | Required | | --api-key | -k | Your API Key | VERGING_API_KEY env | | --output | -o | Result save path | Current directory | | --download | -d | Auto download result to local | false |