POST
/
v1
/
image
/
gen
/
ideogram
curl --request POST \
  --url https://openapi.monica.im/v1/image/gen/ideogram \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "V_2",
  "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.",
  "aspect_ratio": "ASPECT_10_16",
  "magic_prompt_option": "AUTO",
  "seed": 0,
  "negative_prompt": "",
  "style_type": "AUTO"
}'
{
  "data": [
    {
      "url": "<string>"
    }
  ]
}
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
header
required

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
Example:

"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."

​
model
enum<string>
default:V_2
Available options:
V_2
Example:

"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
Example:

"ASPECT_10_16"

​
magic_prompt_option
enum<string>
default:AUTO

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

Available options:
AUTO,
ON,
OFF
Example:

"AUTO"

​
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
Example:

0

​
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
Example:

""

​
style_type
enum<string>
default:AUTO

The style type to generate with.

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

"AUTO"

Response

200 - application/json
Success
​
data
object[]

An array of generated image URLs.