Generate — Ideogram | Documentation

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

Request

This endpoint expects an object.

image_requestobjectRequired

Response

This endpoint returns an object.

createddatetime

The time the request was created.

datalist of objects

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

Errors

1 curl -X POST https://api.ideogram.ai/generate \ 2 -H "Api-Key: <apiKey>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "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 }'

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 "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.", 14 "resolution": "1024x1024", 15 "is_image_safe": true, 16 "seed": 12345, 17 "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g", 18 "style_type": "REALISTIC" 19 } 20 ] 21 }

1	curl -X POST https://api.ideogram.ai/generate \
2	-H "Api-Key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"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	}'

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	"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.",
14	"resolution": "1024x1024",
15	"is_image_safe": true,
16	"seed": 12345,
17	"url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g",
18	"style_type": "REALISTIC"
19	}
20	]
21	}