Ideogram 4.0 - Image Variator

Create a new image guided by both an existing image and a text prompt using Ideogram 4.0's Remix. Control how closely the result follows the source image with image_weight.

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-4
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	-
rendering_speed	string	Yes	Speed vs quality tradeoff. One of TURBO, DEFAULT, QUALITY	-
image_weight	number	No	How closely the result follows the source image (integer 1–100). Higher keeps more of the source structure. Cannot be combined with resolution	-
resolution	string	No	Output resolution (width×height). See resolution values below. Cannot be combined with image_weight	-

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

Image Requirements

• Per-file maximum size: 25 MB
• Formats: JPEG, PNG, WebP

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-4",
"promptObject": {
  "prompt": "A photo of a dog sleeping on a couch",
  "imageUrl": "development/images/cat_on_couch.png",
  "rendering_speed": "DEFAULT",
  "image_weight": 50
}
}'

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-4',
  promptObject: {
    prompt: 'A photo of a dog sleeping on a couch',
    imageUrl: 'development/images/cat_on_couch.png',
    rendering_speed: 'DEFAULT',
    image_weight: 50
  }
})
})

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-4",
"promptObject": {
  "prompt": "A photo of a dog sleeping on a couch",
  "imageUrl": "development/images/cat_on_couch.png",
  "rendering_speed": "DEFAULT",
  "image_weight": 50
}
}

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 guiding the variation

A photo of a dog sleeping on a couch

Source Image *

Asset path to the source image

Rendering Speed *

Speed vs quality tradeoff

TurboDefaultQuality (Best)

Image Weight

Integer 1–100 (cannot be combined with Resolution)

Resolution

WIDTHxHEIGHT from the supported list (cannot be combined with Image Weight)

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-4",
  "promptObject": {
    "prompt": "A photo of a dog sleeping on a couch",
    "imageUrl": "development/images/cat_on_couch.png",
    "rendering_speed": "DEFAULT"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "e40dd9ef-0944-4ce5-bc90-1edd2548619a",
  "model": "ideogram-4",
  "type": "IMAGE_VARIATOR",
  "status": "SUCCESS",
  "aiRecordDetail": {
    "promptObject": {
      "prompt": "A photo of a dog sleeping on a couch",
      "imageUrl": "development/images/cat_on_couch.png",
      "rendering_speed": "DEFAULT",
      "image_weight": 50
    },
    "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 photo of a dog sleeping on a couch",
          "resolution": "1024x1024",
          "is_image_safe": true,
          "seed": 12345
        }
      ]
    }
  }
}
}