Ideogram - Image Generator

Generate high-quality images from a text prompt using Ideogram 3.0. Supports photorealism, stylized designs, accurate in-image text rendering, style presets, style references, and character references.

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-3
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	-
num_images	number	Yes	Number of images to generate (1–8)	1
rendering_speed	string	No	Speed vs quality tradeoff. One of FLASH, TURBO, DEFAULT, QUALITY. FLASH is not supported when transparent is true	DEFAULT
transparent	boolean	No	When true, generate a PNG with a transparent background. Disables style_type, style_preset, style_reference_images, and character_reference_images	false
aspect_ratio	string	No	Aspect ratio of the generated image. Mutually exclusive with resolution — providing both returns an error	1x1
resolution	string	No	Exact output resolution (width×height). Mutually exclusive with aspect_ratio	-
magic_prompt	string	No	Automatically enhance the prompt for better quality. One of AUTO, ON, OFF	AUTO
style_type	string	No	Style to apply. One of AUTO, GENERAL, REALISTIC, DESIGN, FICTION. Not available when transparent is true	AUTO
style_preset	string	No	Predefined artistic style. Mutually exclusive with style_reference_images. Not available when transparent is true. If style_type is provided, must be AUTO or GENERAL.	-
style_reference_images	string[]	No	Up to 5 asset paths used as style references. Each image ≤ 10 MB; total across all references ≤ 10 MB. JPEG, PNG, or WebP. Mutually exclusive with style_preset. Not available when transparent is true. If style_type is provided, must be AUTO or GENERAL.	-
character_reference_images	string[]	No	1 asset path for a character reference. Image ≤ 10 MB, JPEG/PNG/WebP. Incompatible with rendering_speed: FLASH and transparent: true. If style_type is provided, must be AUTO, REALISTIC, or FICTION.	-
negative_prompt	string	No	Elements to exclude from the image (e.g. blurry, low quality, distorted)	-
upscale_factor	string	No	Upscale the generated image by this factor. Only used when transparent is true. One of X1, X2, X4. Factors other than X1 incur additional cost	-
seed	number	No	Random seed for reproducible results (0–2147483647)	Random

Image Requirements (reference images)

• Per-file maximum size: 10 MB
• Total size of style references: ≤ 10 MB across all files
• Formats: JPEG, PNG, WebP

aspect_ratio values

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

resolution values

512x1536, 576x1408, 576x1472, 576x1536, 640x1344, 640x1408, 640x1472, 640x1536, 704x1152, 704x1216, 704x1280, 704x1344, 704x1408, 704x1472, 736x1312, 768x1088, 768x1216, 768x1280, 768x1344, 800x1280, 832x960, 832x1024, 832x1088, 832x1152, 832x1216, 832x1248, 864x1152, 896x960, 896x1024, 896x1088, 896x1120, 896x1152, 960x832, 960x896, 960x1024, 960x1088, 1024x832, 1024x896, 1024x960, 1024x1024, 1088x768, 1088x832, 1088x896, 1088x960, 1120x896, 1152x704, 1152x832, 1152x864, 1152x896, 1216x704, 1216x768, 1216x832, 1248x832, 1280x704, 1280x768, 1280x800, 1312x736, 1344x640, 1344x704, 1344x768, 1408x576, 1408x640, 1408x704, 1472x576, 1472x640, 1472x704, 1536x512, 1536x576, 1536x640

style_preset values

80S_ILLUSTRATION, 90S_NOSTALGIA, ABSTRACT_ORGANIC, ANALOG_NOSTALGIA, ART_BRUT, ART_DECO, ART_POSTER, AURA, AVANT_GARDE, BAUHAUS, BLUEPRINT, BLURRY_MOTION, BRIGHT_ART, C4D_CARTOON, CHILDRENS_BOOK, COLLAGE, COLORING_BOOK_I, COLORING_BOOK_II, CUBISM, DARK_AURA, DOODLE, DOUBLE_EXPOSURE, DRAMATIC_CINEMA, EDITORIAL, EMOTIONAL_MINIMAL, ETHEREAL_PARTY, EXPIRED_FILM, FLAT_ART, FLAT_VECTOR, FOREST_REVERIE, GEO_MINIMALIST, GLASS_PRISM, GOLDEN_HOUR, GRAFFITI_I, GRAFFITI_II, HALFTONE_PRINT, HIGH_CONTRAST, HIPPIE_ERA, ICONIC, JAPANDI_FUSION, JAZZY, LONG_EXPOSURE, MAGAZINE_EDITORIAL, MINIMAL_ILLUSTRATION, MIXED_MEDIA, MONOCHROME, NIGHTLIFE, OIL_PAINTING, OLD_CARTOONS, PAINT_GESTURE, POP_ART, RETRO_ETCHING, RIVIERA_POP, SPOTLIGHT_80S, STYLIZED_RED, SURREAL_COLLAGE, TRAVEL_POSTER, VINTAGE_GEO, VINTAGE_POSTER, WATERCOLOR, WEIRD, WOODBLOCK_PRINT

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-3",
"promptObject": {
  "prompt": "A bioluminescent jellyfish in an underwater city",
  "num_images": 1,
  "rendering_speed": "DEFAULT",
  "aspect_ratio": "1x1",
  "magic_prompt": "AUTO",
  "style_type": "AUTO",
  "style_preset": "JAPANDI_FUSION"
}
}'

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-3',
  promptObject: {
    prompt: 'A bioluminescent jellyfish in an underwater city',
    num_images: 1,
    rendering_speed: 'DEFAULT',
    aspect_ratio: '1x1',
    magic_prompt: 'AUTO',
    style_type: 'AUTO',
    style_preset: 'JAPANDI_FUSION'
  }
})
})

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-3",
"promptObject": {
  "prompt": "A bioluminescent jellyfish in an underwater city",
  "num_images": 1,
  "rendering_speed": "DEFAULT",
  "aspect_ratio": "1x1",
  "magic_prompt": "AUTO",
  "style_type": "AUTO",
  "style_preset": "JAPANDI_FUSION"
}
}

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

Interactive Playground

API Playground

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

AI Model *Ideogram 3.0

Prompt *

Text description of the image to generate

A bioluminescent jellyfish in an underwater city

Number of Images

How many images to generate (1–8)

Rendering Speed

Speed vs quality tradeoff (FLASH disabled for transparent)

Flash (Fastest)TurboDefaultQuality (Best)

Transparent Background

Generate a PNG with transparent background

DisabledEnabled

Aspect Ratio

Mutually exclusive with Resolution

1:11:22:11:33:12:33:23:44:34:55:49:1616:910:1616:10

Resolution

Exact WIDTHxHEIGHT, mutually exclusive with Aspect Ratio

Magic Prompt

Auto-enhance the prompt

AutoOnOff

Style Type

Not available when transparent is true

AutoGeneralRealisticDesignFiction

Style Preset

Mutually exclusive with style_reference_images

Style Reference Images

Comma-separated asset paths for style references (up to 5, ≤10 MB each/total). Mutually exclusive with style_preset. Not available when transparent is true.

Character Reference Image

Single asset path for a character reference (≤10 MB, JPEG/PNG/WebP). Incompatible with rendering_speed: FLASH and transparent: true.

Negative Prompt

Elements to exclude from the image

Upscale Factor (transparent only)

Only applies when transparent is true

X1X2X4

Seed

Random seed for reproducibility (0–2147483647)

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-3",
  "promptObject": {
    "prompt": "A bioluminescent jellyfish in an underwater city",
    "num_images": 1,
    "rendering_speed": "DEFAULT",
    "aspect_ratio": "1x1",
    "magic_prompt": "AUTO",
    "style_type": "AUTO"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "e40dd9ef-0944-4ce5-bc90-1edd2548619a",
  "userId": "f944dd01-da40-405c-b698-708269eb9664",
  "teamId": "7d530bad-357c-4f6e-b627-16f043c9a16b",
  "model": "ideogram-3",
  "type": "IMAGE_GENERATOR",
  "status": "SUCCESS",
  "createdAt": "2026-04-15T10:30:00.000Z",
  "aiRecordDetail": {
    "promptObject": {
      "prompt": "A bioluminescent jellyfish in an underwater city",
      "num_images": 1,
      "rendering_speed": "DEFAULT",
      "aspect_ratio": "1x1",
      "style_type": "AUTO",
      "style_preset": "JAPANDI_FUSION",
      "magic_prompt": "AUTO"
    },
    "resultObject": [
      "development/images/2026_04_15_17_30_00_000_abc123.png"
    ],
    "responseObject": {
      "created": "2026-04-15T10:30:00Z",
      "data": [
        {
          "url": "https://ideogram.ai/.../jellyfish.png",
          "prompt": "A bioluminescent jellyfish in an underwater city",
          "resolution": "1024x1024",
          "is_image_safe": true,
          "seed": 12345,
          "style_type": "AUTO"
        }
      ]
    }
  },
  "temporaryUrl": ""
}
}