Skip to main content

​
Ideogram V3

Ideogram V3 is the latest generation text-to-image model with significant improvements in text rendering and image quality.

​
Generate Image

POST /ideogram/v1/ideogram-v3/generate

​
Request Parameters

ParameterTypeRequiredDescription
promptstringYesImage description prompt
aspect_ratiostringNoAspect ratio, e.g. ASPECT_1_1, ASPECT_16_9, ASPECT_9_16
modelstringNoModel version, defaults to V_3
magic_prompt_optionstringNoPrompt enhancement: AUTO, ON, OFF
rendering_speedstringNoRendering speed: DEFAULT, TURBO, QUALITY
style_typestringNoStyle type: AUTO, GENERAL, REALISTIC, DESIGN
negative_promptstringNoNegative prompt

​
Request Examples

curl -X POST https://crazyrouter.com/ideogram/v1/ideogram-v3/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "prompt": "A serene Japanese garden with cherry blossoms, text saying \"Hello World\" on a wooden sign",
    "aspect_ratio": "ASPECT_16_9",
    "rendering_speed": "DEFAULT",
    "style_type": "REALISTIC"
  }'

​
Response Example

{
  "created": 1709123456,
  "data": [
    {
      "url": "https://ideogram.ai/assets/image/...",
      "prompt": "A serene Japanese garden with cherry blossoms",
      "resolution": "1344x768",
      "is_image_safe": true,
      "seed": 12345
    }
  ]
}

​
Edit Image

POST /ideogram/v1/ideogram-v3/edit
Edit and modify an existing image.

​
Request Parameters

ParameterTypeRequiredDescription
promptstringYesEdit description
imagestringYesOriginal image URL or Base64
maskstringNoMask image, marking the area to be edited
style_typestringNoStyle type
cURL
curl -X POST https://crazyrouter.com/ideogram/v1/ideogram-v3/edit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "prompt": "Replace the sky with a starry night",
    "image": "https://example.com/photo.jpg",
    "mask": "https://example.com/mask.png"
  }'

​
Remix Image

POST /ideogram/v1/ideogram-v3/remix
Generate variations based on a reference image and new prompt.
ParameterTypeRequiredDescription
promptstringYesNew prompt
imagestringYesReference image
image_weightnumberNoReference image weight, 0-100
cURL
curl -X POST https://crazyrouter.com/ideogram/v1/ideogram-v3/remix \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "prompt": "Same scene but in watercolor painting style",
    "image": "https://example.com/photo.jpg",
    "image_weight": 50
  }'

​
Reframe

POST /ideogram/v1/ideogram-v3/reframe
Expand the image canvas, generating content beyond the original boundaries.
ParameterTypeRequiredDescription
imagestringYesOriginal image
resolutionstringNoTarget resolution

​
Replace Background

POST /ideogram/v1/ideogram-v3/replace-background
Automatically detect the subject and replace the background.
ParameterTypeRequiredDescription
promptstringYesNew background description
imagestringYesOriginal image
cURL
curl -X POST https://crazyrouter.com/ideogram/v1/ideogram-v3/replace-background \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "prompt": "A tropical beach at sunset",
    "image": "https://example.com/portrait.jpg"
  }'
Ideogram V3 excels at text rendering, making it ideal for scenarios that require text within images.