Ideogram 4.0 - Image Generator

Generate high-quality images from a text prompt using Ideogram 4.0. It follows prompts closely, renders crisp in-image text, and supports native 1K/2K resolutions and transparent-background output up to 8K.

Endpoint

POSThttps://api.1min.ai/api/features

Request Headers

Field	Value
API-KEY	<api-key>
Content-Type	application/json

Parameters

Parameter	Type	Required	Description
type	string	Yes	Feature type identifier. Must be IMAGE_GENERATOR
model	string	Yes	AI model identifier. Must be ideogram-4
promptObject	object	Yes	Configuration object containing all generation parameters

Prompt Object Parameters

Parameter	Type	Required	Description	Default
prompt	string	Yes	Text description of the image to generate. Magic prompt is applied automatically	-
rendering_speed	string	Yes	Speed vs quality tradeoff. One of TURBO, DEFAULT, QUALITY	-
transparent	boolean	No	When true, generate a PNG with a transparent background	-
resolution	string	No	Output resolution (width×height). See resolution values below. Ignored when transparent is true	-
aspect_ratio	string	No	Aspect ratio. See aspect_ratio values below. Only used when transparent is true	-
output_resolution	string	When transparent is true	Pixel budget tier. One of 1K, 2K, 4K, 8K. Only used when transparent is true; higher tiers cost more	-

resolution values

1K: 1024x1024, 896x1120, 1120x896, 864x1152, 1152x864, 832x1248, 1248x832, 800x1280, 1280x800, 720x1280, 1280x720, 720x1440, 1440x720, 512x1536, 1536x512

2K: 2048x2048, 1440x2880, 2880x1440, 1664x2496, 2496x1664, 1792x2240, 2240x1792, 1440x2560, 2560x1440, 1600x2560, 2560x1600, 1728x2304, 2304x1728, 1296x3168, 3168x1296, 1152x2944, 2944x1152, 1248x3328, 3328x1248, 1280x3072, 3072x1280, 1024x3072, 3072x1024

aspect_ratio values (transparent only)

AUTO, 1x4, 1x3, 1x2, 9x16, 10x16, 2x3, 3x4, 4x5, 1x1, 5x4, 4x3, 3x2, 16x10, 16x9, 2x1, 3x1, 4x1

Code Examples

cURL

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_GENERATOR",
"model": "ideogram-4",
"promptObject": {
  "prompt": "A poster for a summer design conference with the title \"SUNSET 2026\"",
  "rendering_speed": "DEFAULT",
  "resolution": "1024x1024"
}
}'

JavaScript

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'IMAGE_GENERATOR',
  model: 'ideogram-4',
  promptObject: {
    prompt: 'A poster for a summer design conference with the title "SUNSET 2026"',
    rendering_speed: 'DEFAULT',
    resolution: '1024x1024'
  }
})
})

Python

import requests

url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}

data = {
"type": "IMAGE_GENERATOR",
"model": "ideogram-4",
"promptObject": {
  "prompt": "A poster for a summer design conference with the title \"SUNSET 2026\"",
  "rendering_speed": "DEFAULT",
  "resolution": "1024x1024"
}
}

response = requests.post(url, headers=headers, json=data)

Interactive Playground

API Playground

GETPOSTPUTDELETEhttps://api.1min.ai/api/features

AI Model *Ideogram 4.0

Prompt *

Text description of the image to generate

A poster for a summer design conference

Rendering Speed *

Speed vs quality tradeoff

TurboDefaultQuality (Best)

Transparent Background

Generate a PNG with transparent background

DisabledEnabled

Resolution

WIDTHxHEIGHT from the supported list (ignored when transparent)

Aspect Ratio (transparent only)

AUTO or a ratio such as 1x1, 16x9

Output Resolution (transparent only) 1K2K4K8K

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
  -H "API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "IMAGE_GENERATOR",
  "model": "ideogram-4",
  "promptObject": {
    "prompt": "A poster for a summer design conference",
    "rendering_speed": "DEFAULT"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "e40dd9ef-0944-4ce5-bc90-1edd2548619a",
  "model": "ideogram-4",
  "type": "IMAGE_GENERATOR",
  "status": "SUCCESS",
  "aiRecordDetail": {
    "promptObject": {
      "prompt": "A poster for a summer design conference",
      "rendering_speed": "DEFAULT",
      "resolution": "1024x1024"
    },
    "resultObject": [
      "development/images/2026_09_14_16_30_00_000_abc123.png"
    ],
    "responseObject": {
      "created": "2026-09-14T16:30:00Z",
      "data": [
        {
          "url": "https://ideogram.ai/api/images/ephemeral/...",
          "prompt": "A poster for a summer design conference",
          "resolution": "1024x1024",
          "is_image_safe": true,
          "seed": 12345
        }
      ]
    }
  }
}
}