Uncrop/Outpaint

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude

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 extend (PNG, JPEG, WebP).

extend_left integer optional · Defaults to 0

Pixels to extend left (Clipdrop only, max 2000).

extend_right integer optional · Defaults to 0

Pixels to extend right (Clipdrop only, max 2000).

extend_up integer optional · Defaults to 0

Pixels to extend up (Clipdrop only, max 2000).

extend_down integer optional · Defaults to 0

Pixels to extend down (Clipdrop only, max 2000).

seed integer optional

Random seed for reproducible results (Clipdrop only).

mask_file file conditional

Mask file (PNG with alpha channel). Required for OpenAI.

prompt string optional

Description for outpainting (OpenAI only).

size string optional

Output size (OpenAI only). Values: 1024x1024, 1024x1536, 1536x1024.

Returns

Returns raw image bytes (JPEG for Clipdrop, PNG for OpenAI) 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)

curl -X POST "https://api.aitronos.com/api/v1/images/uncrop" \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -F "provider=clipdrop" \
  -F "organization_id=org_123abc" \
  -F "image_file=@photo.jpg" \
  -F "extend_left=100" \
  -F "extend_right=100" \
  -F "extend_up=50" \
  -F "extend_down=50" \
  -F "seed=42"

Response

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

[JPEG image bytes]