API Documentation

Authentication

All API requests require authentication via an API key. Generate one in your Dashboard.

curl -H "x-api-key: itb_your_api_key" https://imagetoolbox.app/api/v1/usage

Remove Background

POST /api/v1/remove-background

Upload an image to remove its background. Returns a job ID for polling.

curl -X POST \
  -H "x-api-key: itb_your_api_key" \
  -F "image=@photo.jpg" \
  https://imagetoolbox.app/api/v1/remove-background

Response

{
  "success": true,
  "data": {
    "jobId": "abc123",
    "status": "processing",
    "fullRes": true
  }
}

GET /api/v1/jobs/:id

Poll job status. When complete, includes a signed download URL (valid 24h).

curl -H "x-api-key: itb_your_api_key" \
  https://imagetoolbox.app/api/v1/jobs/abc123

Response (completed)

{
  "success": true,
  "data": {
    "jobId": "abc123",
    "status": "completed",
    "resultUrl": "https://storage.googleapis.com/...",
    "resolution": "full"
  }
}

GET /api/v1/usage

Check your remaining quota and credit balance.

{
  "success": true,
  "data": {
    "today": {
      "fullResUsed": 0,
      "lowResUsed": 3,
      "freeFullResRemaining": 1
    },
    "credits": 47,
    "limits": {
      "freeFullResPerDay": 1
    }
  }
}

Rate Limits

• Free tier: 1 full-res download per day, unlimited low-res
• Credits: each credit = 1 full-res download, no daily limit
• File size: 10MB maximum
• Supported formats: JPEG, PNG, WebP