POST
/
v1
/
image
/
gen
/
ideogram
Follow the quickstart guide to get your own API Key.

Ideogram is an advanced AI image generation model developed by Ideogram AI. See the pricing page for pricing details.

Ideogram V2

  • Latest version of Ideogram’s image generation technology
  • Exceptional text rendering capabilities
  • Superior handling of typography and logos
  • Precise control over text placement and style
  • Ideal for:
    • Marketing materials
    • Brand assets
    • Social media content
    • Designs requiring text integration
    • Professional graphics with text elements

Previews

Authorizations

​
Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
prompt
string
required

The prompt to use to generate the image.

Required string length: 1 - 1000
​
model
enum<string>
default: V_2
Available options:
V_2
​
aspect_ratio
enum<string>
default: ASPECT_1_1

The aspect ratio to use for image generation, which determines the image’s resolution.

Available 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
​
magic_prompt_option
enum<string>
default: AUTO

Determine if MagicPrompt should be used in generating the request or not.

Available options:
AUTO,
ON,
OFF
​
seed
integer

Random seed to use for the image generation process. If 0, we will use a totally random seed. Between 0 and 2147483647.

Required range: x < 2147483647
​
negative_prompt
string

Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt.

Maximum length: 4000
​
style_type
enum<string>
default: AUTO

The style type to generate with.

Available options:
AUTO,
GENERAL,
REALISTIC,
DESIGN,
RENDER_3D,
ANIME

Response

200 - application/json
​
data
object[]

An array of generated image URLs.

Playground modelsHumanize