generate

Advertisement Resizer

Resizes an advertisement image to the exact target size. Supply prompt to provide specific instructions for how the advertisement should look after resizing.

The request is processed asynchronously and immediately returns a generation_id. Poll GET /v1/generations/{generation_id} until status is completed or failed. The completed polling response contains the final resized image(s) in data and the amount charged for variable usage-based pricing in usage_cost_usd_micros. If a webhook_url is supplied, the completed result is also POSTed to that URL.

Supply the advertisement image as raw image bytes via multipart/form-data.

The required resolution (WIDTHxHEIGHT) sets the exact output dimensions.

The model is fixed by the route, so no model field is accepted.

post/v1/async/ad-resizer

Query parameters

webhook_urlstring uri

HTTPS URL that Ideogram delivers the generated result to. Ideogram sends a JSON POST to this URL once all images for the request have finished generating. The body mirrors the synchronous generate response: request_id, created, and a data array containing every generated image (url, prompt, resolution, seed, is_image_safe). Each delivery is signed with Ed25519 and verifiable against the public keys at https://api.ideogram.ai/v1/.well-known/jwks.json. Must be HTTPS; private and loopback hosts and the cloud metadata service are rejected.

Headers

Api-Keystring required

API key for access control. Use in the header with the name "Api-Key"

Response

Request accepted for asynchronous processing.

generation_idstring required

URL-safe base64 ID of the accepted generation. Matches the generation_id field delivered in the webhook payload, and the generation_id accepted by the generation polling endpoint.

Changes