Enhance
Enhance a single image.
Enhancement parameters are inferred automatically. Optionally provide a text prompt to guide the enhancement. Returns images or signed download URLs.
Authorizations
Body
Request body for the enhance endpoint.
Enhances the provided input image without requiring a text prompt, aspect ratio, or resolution -- those parameters are inferred automatically.
The image can be provided as a raw base64-encoded string or a publicly accessible URL. Both formats are accepted and detected automatically.
Input image as a raw base64 string or publicly accessible URL. Supported formats: JPEG, PNG, WebP, and HEIC/HEIF. Images larger than 4K (4096px) are automatically resized; for best results, provide images at 4K or below.
Submit asynchronously. Returns 202 with a job_id to poll at GET /v1/jobs/{job_id} instead of holding the connection until the image is ready.
Optional https URL we POST the signed result to on completion. Best-effort (polling remains authoritative). Requires async=true.
Idempotency key. A retried submit with the same value returns the original job instead of creating (and charging for) a new one.
Response delivery mode. 'bytes': return base64-encoded image data (default). 'urls': return signed download URLs (24-hour expiry) instead of image bytes.
bytes, urls Subset of your account's profiles relevant to this request. Your account holds all profiles, but only pass the ones belonging to the end-user whose photo is being edited. These profiles serve as candidates for identity preservation. The fewer profiles you pass, the easier it is for our system to determine which profiles are relevant.
Number of output images to generate (1-4).
1 <= x <= 4Output image format (png, jpg). Default: png (will change to jpg on 2026-05-08).
png, jpg Optional text instructions to guide the enhancement.
Response
Successful Response
Response returned by the edit, generate, and enhance endpoints.
Dictionary mapping a known subject's profile_id to the number of times they were generated. If multiple variations are generated, this will be the aggregated count across all variations.
Output image(s) as raw base64-encoded strings. Format matches the requested output_format. Populated when response_mode='bytes', empty otherwise.
Signed download URLs for each output image (24-hour expiry). Populated when response_mode='urls', empty otherwise.
