Ideogram - Image Variator

Create a new image guided by both an existing image and a text prompt using Ideogram 3.0's Remix. Control how much influence the source image has via image_weight, and optionally apply style presets, style references, or a character reference.

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_VARIATOR
model	string	Yes	AI model identifier. Must be ideogram-3
promptObject	object	Yes	Configuration object containing all remix parameters

Prompt Object Parameters

Parameter	Type	Required	Description	Default
prompt	string	Yes	Text description guiding the variation	-
imageUrl	string	Yes	Asset path to the source image to remix	-
num_images	number	Yes	Number of variations to generate (1–8)	-
image_weight	number	No	How much the source image influences the result (0–100). 0 = ignore source, 100 = copy source	50
rendering_speed	string	No	Speed vs quality tradeoff. One of FLASH, TURBO, DEFAULT, QUALITY	DEFAULT
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. One of AUTO, ON, OFF	AUTO
style_type	string	No	Style to apply. One of AUTO, GENERAL, REALISTIC, DESIGN, FICTION	AUTO
style_preset	string	No	Predefined artistic style. Mutually exclusive with style_reference_images. 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. 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, or 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	-
seed	number	No	Random seed for reproducibility (0–2147483647)	-

Image Requirements

• 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_VARIATOR",
"model": "ideogram-3",
"promptObject": {
  "prompt": "A photo of a dog sleeping on a couch",
  "imageUrl": "development/images/cat_on_couch.png",
  "num_images": 1,
  "image_weight": 50,
  "rendering_speed": "DEFAULT",
  "aspect_ratio": "1x1",
  "magic_prompt": "AUTO",
  "style_type": "AUTO"
}
}'

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_VARIATOR',
  model: 'ideogram-3',
  promptObject: {
    prompt: 'A photo of a dog sleeping on a couch',
    imageUrl: 'development/images/cat_on_couch.png',
    num_images: 1,
    image_weight: 50,
    rendering_speed: 'DEFAULT',
    aspect_ratio: '1x1',
    magic_prompt: 'AUTO',
    style_type: 'AUTO'
  }
})
})

Python

import requests

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

data = {
"type": "IMAGE_VARIATOR",
"model": "ideogram-3",
"promptObject": {
  "prompt": "A photo of a dog sleeping on a couch",
  "imageUrl": "development/images/cat_on_couch.png",
  "num_images": 1,
  "image_weight": 50,
  "rendering_speed": "DEFAULT",
  "aspect_ratio": "1x1",
  "magic_prompt": "AUTO",
  "style_type": "AUTO"
}
}

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

Interactive Playground

API Playground

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

AI Model *Ideogram 3.0

Prompt *A photo of a dog sleeping on a couch

Source Image *

Asset path to the source image

Number of Images

1–8

Image Weight

0 = ignore source, 100 = copy source

Rendering Speed Flash (Fastest)TurboDefaultQuality (Best)

Aspect Ratio

Mutually exclusive with Resolution

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

Resolution

Mutually exclusive with Aspect Ratio

Magic Prompt AutoOnOff

Style Type 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.

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

Seed

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_VARIATOR",
  "model": "ideogram-3",
  "promptObject": {
    "prompt": "A photo of a dog sleeping on a couch",
    "imageUrl": "development/images/cat_on_couch.png",
    "num_images": 1,
    "image_weight": 50,
    "rendering_speed": "DEFAULT",
    "aspect_ratio": "1x1",
    "magic_prompt": "AUTO",
    "style_type": "AUTO"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "e40dd9ef-0944-4ce5-bc90-1edd2548619a",
  "model": "ideogram-3",
  "type": "IMAGE_VARIATOR",
  "status": "SUCCESS",
  "aiRecordDetail": {
    "promptObject": {
      "prompt": "A photo of a dog sleeping on a couch",
      "imageUrl": "development/images/cat_on_couch.png",
      "num_images": 1,
      "image_weight": 50,
      "rendering_speed": "DEFAULT",
      "aspect_ratio": "1x1",
      "style_type": "AUTO",
      "magic_prompt": "AUTO"
    },
    "resultObject": [
      "development/images/2026_04_15_remix_result.png"
    ],
    "responseObject": {
      "created": "2026-04-15T10:30:00Z",
      "data": [
        {
          "url": "https://ideogram.ai/.../remix.png",
          "prompt": "A photo of a dog sleeping on a couch",
          "resolution": "1024x1024",
          "is_image_safe": true,
          "seed": 12345,
          "style_type": "AUTO"
        }
      ]
    }
  }
}
}