Background Removal API

Authentication

Create an API key on the Pro page. Send it as X-Api-Key: ald_… or Authorization: Bearer ald_….

Remove background

POST /api/v1/background/remove — multipart field image or file.

curl -X POST https://aladdin-agent.net/api/v1/background/remove \
  -H "X-Api-Key: ald_YOUR_KEY" \
  -F "image=@photo.jpg"

# Response: { "jobId", "poll", "download", "ttlSeconds" }

curl -H "X-Api-Key: ald_YOUR_KEY" \
  "https://aladdin-agent.net/api/v1/background/remove/JOB_ID"

curl -H "X-Api-Key: ald_YOUR_KEY" \
  -o result.png \
  "https://aladdin-agent.net/api/v1/background/remove/JOB_ID/download"

Job lifecycle

• GET /api/v1/background/remove/:jobId — poll until status: done
• GET /api/v1/background/remove/:jobId/download — PNG result

Files are never stored beyond the TTL. No backups.

OpenAPI

Machine-readable spec: /api/v1/openapi (alias /api/v1/openapi.json)

Local browser API

Free tier: use Private Background Remover — 100% browser Wasm/WebGPU, zero upload.

Adobe Photoshop

UXP sample plugin in plugins/adobe-photoshop/ — calls this API from Photoshop 2023+.