Sign in
Image

Ideogram 4.5

Generate images or edit source images with prompts and up to five image references. Very low quality requires an image. Set preserve_source_size to keep the first source image dimensions; aspect_ratio and resolution are then ignored.

post/generate/image/ideogram/ideogram-4.5

Headers

X-Webhook-URLstring uri

URL to receive a POST request when the job completes. The webhook will receive the job data including results.

Request body

promptstring required
seedinteger
quality'very_low' | 'low' | 'medium' | 'high'
preserve_source_sizeboolean
skip_prompt_expansionboolean
aspect_ratio'1:1' | '4:3' | '3:2' | '16:9' | '2.4:1' | '4:5' | '2:3' | '9:16'

Aspect ratio. One of: 1:1, 4:3, 3:2, 16:9, 2.4:1, 4:5, 2:3, 9:16.

resolution'2K'

Resolution scale. One of: 2K.

image_urlsstring[]

Up to five source or reference images for prompt-based editing. Omit for text-to-image generation.

Response

The resulting job data. This will be returned in a pending state until the job is completed. See /jobs/{id} for retrieving the results.

job_idstring uuid required
status'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled' required
created_atstring date-time required
{"stackTrail":"paths:/generate/image/ideogram/ideogram-4.5:post:responses:200:content:application/json:schema:properties:completed_at","oasType":"schema","type":"unknown"}
{"stackTrail":"paths:/generate/image/ideogram/ideogram-4.5:post:responses:200:content:application/json:schema:properties:result","oasType":"schema","type":"unknown"}

Changes

Changed in 1 of the 88 revisions of this API.1