Skip to content
Last updated

Remove text overlays and watermarks from images.

POSThttps://api.aitronos.com/v1/images/remove-text

Request Body (multipart/form-data)

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.

Provider Notes

Clipdrop: Automatically detects and removes text without requiring a mask.

OpenAI: Requires mask file with dimensions matching the source image.

Returns

Returns raw image bytes (PNG format) with provider metadata in response headers.

Response Headers

  • X-Provider - Provider that processed the request
  • X-Provider-Request-Id - Provider's request ID
  • X-Provider-Credits-Consumed - Credits consumed (Clipdrop only)
Bash
curl -X POST "https://api.aitronos.com/api/v1/images/remove-text" \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -F "provider=clipdrop" \
  -F "organization_id=org_123abc" \
  -F "image_file=@image.jpg"

Response

Text
Content-Type: image/png
X-Provider: clipdrop
X-Provider-Request-Id: req_abc123
X-Provider-Credits-Consumed: 1

[PNG image bytes]