ideogram (Text-to-Image)

POST https://www.kkiai.com/ideogram/generate

Generates images synchronously based on a given prompt and optional parameters.
For specific parameters, please refer to the official documentation: https://developer.ideogram.ai/api-reference/api-reference/describe

Generates images synchronously based on the given prompt and optional parameters.
The returned image URLs are valid for 24 hours. Images cannot be accessed after this time.
Images have been reverse-proxied.

Request Parameters

Header Parameters

Parameter	Type	Required	Description	Example
Content-Type	string	Required		application/json
Accept	string	Required		application/json
Authorization	string	Required		Bearer {{YOUR_API_KEY}}

Body Parameters (application/json)

Parameter	Type	Required	Description
image_request	object	Required	Image request object (required)
└ prompt	string	Required	Prompt text for image generation (required)
└ aspect_ratio	string	Required	Image aspect ratio (optional) Options: ASPECT_10_16/ASPECT_16_10/ASPECT_9_16/ASPECT_16_9/ASPECT_3_2/ASPECT_2_3/ASPECT_4_3/ASPECT_3_4/ASPECT_1_1/ASPECT_1_3/ASPECT_3_1
└ model	string	Required	Model to use (optional) Default: V_2, Options: V_1/V_1_TURBO/V_2/V_2_TURBO
└ magic_prompt_option	string	Required	Whether to use MagicPrompt (optional) Options: AUTO/ON/OFF
└ seed	integer	Required	Random seed (optional) Range: 0-2147483647
└ style_type	string	Required	Style type (optional) Options: AUTO/GENERAL/REALISTIC/DESIGN/RENDER_3D/ANIME
└ negative_prompt	string	Required	Negative prompt (optional) Describes content you don't want to appear in the image
└ num_images	integer	Required	Number of images to generate (optional) Range: 1-8, Default: 1
└ resolution	string	Required	Resolution (optional) Options include various resolution combinations from 512x1536 to 1536x640
└ color_palette	object	Required	Color palette (optional)

Request Example

{
  "image_request": {
    "aspect_ratio": "ASPECT_10_16",
    "magic_prompt_option": "AUTO",
    "model": "V_1",
    "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."
  }
}

cURL Example

curl --location --request POST 'https://www.kkiai.com/ideogram/generate' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "image_request": {
    "aspect_ratio": "ASPECT_10_16",
    "magic_prompt_option": "AUTO",
    "model": "V_1",
    "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."
  }
}'

Response

🟢 200 Success

Response Body

Parameter	Type	Required	Description
created	string	Required
data	array[object]	Required
└ is_image_safe	boolean	Optional
└ prompt	string	Optional
└ resolution	string	Optional
└ seed	integer	Optional
└ style_type	null	Optional
└ url	string	Optional

Response Example

{
  "created": "2024-12-15T17:32:00.965408+00:00",
  "data": [
    {
      "is_image_safe": true,
      "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.",
      "resolution": "768x1232",
      "seed": 1785282233,
      "style_type": null,
      "url": "https://ideogram.ai/api/images/ephemeral/WkoxvqiOTaaCqG1nO2tQoA.png?exp=1734370337&sig=110fe96dc9e01002c8d837e5b4cde1aaa266195561d231ce76e19e095e478ffe"
    }
  ]
}