Ideogram API — Developer Guide

Authentication

All requests require an API key passed as an HTTP header:

Api-Key: YOUR_API_KEY

Generate an Image (v2)

POST https://api.ideogram.ai/generate

Request body (JSON):

{
  "image_request": {
    "prompt": "A neon sign that says 'Open 24/7' on a rainy street",
    "aspect_ratio": "ASPECT_16_9",
    "model": "V_2",
    "style_type": "REALISTIC",
    "negative_prompt": "blurry, low quality",
    "magic_prompt_option": "AUTO"
  }
}

Key parameters:

model — V_1, V_1_TURBO, V_2, V_2_TURBO
style_type — AUTO, GENERAL, REALISTIC, DESIGN, RENDER_3D, ANIME
aspect_ratio — ASPECT_1_1, ASPECT_16_9, ASPECT_9_16, ASPECT_4_3, etc.
magic_prompt_option — ON, OFF, AUTO (enhances prompts automatically)

Additional Endpoints

POST /edit — Inpainting: edit specific regions of an existing image
POST /remix — Remix: generate a new image inspired by an uploaded reference
POST /upscale — Upscale a generated image to higher resolution
GET /generate/{request_id} — Poll for async generation results

Rate limits and credit consumption vary by model version and resolution tier. Refer to the official API docs for full schema details.