curl -X POST "https://api.hooked.so/v1/image/remove-background" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "imageUrl": "https://example.com/portrait.jpg" }'

const response = await fetch('https://api.hooked.so/v1/image/remove-background', {
  method: 'POST',
  headers: { 'x-api-key': 'your_api_key_here', 'Content-Type': 'application/json' },
  body: JSON.stringify({ media: 'cm1a2b3c4d5e6f7g8h9i0j1k2' })
});

const { data } = await response.json();
if (data.status === 'COMPLETED') {
  console.log(data.backgroundRemovedUrl); // PNG with transparency
} else {
  console.log(`Poll GET /v1/image/${data.mediaId}`);
}

import requests

response = requests.post(
    'https://api.hooked.so/v1/image/remove-background',
    headers={'x-api-key': 'your_api_key_here'},
    json={'imageUrl': 'https://example.com/portrait.jpg'}
)

data = response.json()['data']
print(data['mediaId'], data['status'])

{
  "success": true,
  "message": "Background removal started",
  "data": {
    "mediaId": "cm1a2b3c4d5e6f7g8h9i0j1k2",
    "status": "PROCESSING",
    "url": "https://.../portrait.jpg",
    "jobId": "aab23fd5fe10445c8fc1d2821b1482bd",
    "usedCredits": 4
  }
}

{
  "success": true,
  "message": "Background removal already running",
  "data": {
    "mediaId": "cm1a2b3c4d5e6f7g8h9i0j1k2",
    "status": "PROCESSING",
    "url": "https://.../portrait.jpg",
    "jobId": "aab23fd5fe10445c8fc1d2821b1482bd",
    "usedCredits": 0
  }
}

{
  "success": true,
  "message": "Background already removed",
  "data": {
    "mediaId": "cm1a2b3c4d5e6f7g8h9i0j1k2",
    "status": "COMPLETED",
    "url": "https://.../portrait.jpg",
    "backgroundRemovedUrl": "https://.../cm1a2b3c4d5e6f7g8h9i0j1k2-1726560000000.png",
    "usedCredits": 0
  }
}

{
  "success": false,
  "message": "media: Image not found"
}

{
  "success": false,
  "errorCode": "INSUFFICIENT_CREDITS",
  "creditsNeeded": 4,
  "creditsAvailable": 1,
  "message": "Not enough credits to perform this action"
}

{
  "success": false,
  "code": "missing_credentials",
  "errorCode": "MISSING_CREDENTIALS",
  "missingProviders": ["bria"],
  "message": "Your team uses its own provider keys (BYOK) and these are missing or invalid: Bria. Add them in Settings → AI keys."
}