API 레퍼런스 · Media

Remove background

Send an image back, get the subject with a transparent background.

POST/v1/images/remove-background10 per image

Send multipart/form-data with a file part (PNG or JPG). No prompt, no parameters — the background-removal workflow does exactly one job: it keeps the subject and returns a PNG with a transparent background.

The cutout is saved to your creation library (library_id on the item — manage with /v1/creations); add a folder_id part to file it in one of your folders. A failed extraction refunds itself; the request holds until the cutout is ready (a few seconds). Not deployed everywhere: tools["remove-background"] on GET /v1/engines says whether it is live (else 503 model_unavailable, nothing billed).

curl -X POST https://eroq.ai/v1/images/remove-background \
  -H "Authorization: Bearer $EROQ_API_KEY"
/v1/images/remove-background
→ POST /v1/images/remove-background
실행을 눌러 보세요 — 문서에 담긴 데이터로 실제 요청과 응답을 그대로 재현해요. 키도, 요청도, 요금도 없어요.

응답

200 · application/json
{
  "created": 1756118400,
  "model": "eroq-cutout",
  "data": [{ "b64_json": "iVBORw0KGgo…", "content_type": "image/png", "library_id": "…" }],
  "usage": { "credits_spent": 10, "credits_remaining": 977 }
}