Generate

1 import requests 2 3 url = "https://api.ideogram.ai/generate" 4 5 payload = { "image_request": { 6 "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.", 7 "aspect_ratio": "ASPECT_10_16", 8 "model": "V_2", 9 "magic_prompt_option": "AUTO" 10 } } 11 headers = { 12 "Api-Key": "<apiKey>", 13 "Content-Type": "application/json" 14 } 15 16 response = requests.post(url, json=payload, headers=headers) 17 18 print(response.json())

1 { 2 "created": "2000-01-23T04:56:07Z", 3 "data": [ 4 { 5 "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there's an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.", 6 "resolution": "1024x1024", 7 "is_image_safe": true, 8 "seed": 12345, 9 "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g", 10 "style_type": "REALISTIC" 11 } 12 ] 13 }

Generates images synchronously based on a given prompt and optional parameters.

Images links are available for a limited period of time; if you would like to keep the image, you must download it.

Request

This endpoint expects an object.

image_requestobjectRequired

Response

Image(s) generated successfully.

createddatetime

The time the request was created.

datalist of objects

A list of ImageObjects that contain the generated image(s).

Headers

Request

Response

Errors