Replace image backgrounds with new scenes or environments.
POSThttps://api.aitronos.com/v1/images/replace-background
provider string required
Provider to use. Values: openai, clipdrop.
organization_id string required
Organization ID (org_ prefixed string).
image_file file required
Image file to process (PNG, JPEG, WebP).
mask_file file conditional
Mask file (PNG with alpha channel). Required for OpenAI, optional for Clipdrop.
prompt string optional
Prompt for background generation (e.g., "A tropical beach at sunset").
accept string optional
Accept header for Clipdrop response format. Values: image/png, image/webp, image/jpeg.
Returns raw image bytes (PNG, WebP, or JPEG format) with provider metadata in response headers.
X-Provider- Provider that processed the requestX-Provider-Request-Id- Provider's request IDX-Provider-Credits-Consumed- Credits consumed (Clipdrop only)
Bash
- Bash
- Python
- JavaScript
curl -X POST "https://api.aitronos.com/v1/images/replace-background" \
-H "X-API-Key: $FREDDY_API_KEY" \
-F "provider=clipdrop" \
-F "organization_id=org_abc123" \
-F "image_file=@product.jpg" \
-F "prompt=modern office environment" \
--output product_new_bg.pngResponse:
Returns raw image bytes (PNG, WebP, or JPEG format).
Response Headers:
Content-Type: image/png
X-Provider: clipdrop
X-Provider-Request-Id: req_abc123
X-Provider-Credits-Consumed: 1