API

Auth

Send Authorization: Bearer <key>. Create project keys in the dashboard after signing in. Legacy env API_KEYS still work. The signed-in website uses short-lived JWTs from POST /api/token (session required).

POST /v1/remove

• multipart field file — JPEG, PNG, WebP, or HEIC · max 15MB
• optional crop=true — trim transparent bounds
• success: image/png with alpha
• errors: JSON { error, code, hint }

Restarts and first inference

The Oracle VM stays on. After a service restart the model loads into RAM; GET /v1/health returns 503 with code=waking until ready. Set client timeouts to at least 120 seconds. Warm CPU inference is typically a few seconds (isnet-general-use).

curl

curl -X POST "https://api.rembg.site/v1/remove" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@./photo.jpg" \
  --max-time 120 \
  -o removed.png

fetch

const form = new FormData();
form.append("file", file); // File / Blob

const res = await fetch("https://api.rembg.site/v1/remove", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
  // Free tier cold start: allow at least 120s
  signal: AbortSignal.timeout(120_000),
});

if (!res.ok) {
  const err = await res.json();
  throw new Error(err.error + " — " + err.hint);
}

const png = await res.blob(); // image/png with alpha