Ideogram - Image Upscaler

Upscale an existing image with Ideogram's AI upscaler. Fine-tune the output with resemblance (how close to the original) and detail (how much fine detail to add). Optionally provide a guiding prompt.

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

Prompt Object Parameters

Parameter	Type	Required	Description	Default
imageUrl	string	Yes	Asset path to the source image to upscale	-
prompt	string	No	Optional guiding prompt to steer the upscale	-
num_images	number	Yes	Number of variations to generate (1–8)	-
magic_prompt_option	string	No	Automatically enhance the guiding prompt. One of AUTO, ON, OFF	AUTO
resemblance	number	No	How closely the upscaled image should match the original (0–100)	50
detail	number	No	Level of fine detail to add during upscaling (0–100)	50
seed	number	No	Random seed for reproducibility (0–2147483647)	-

Image Requirements

• Per-file maximum size: 10 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_UPSCALER",
"model": "ideogram-3",
"promptObject": {
  "imageUrl": "development/images/low_res_photo.png",
  "num_images": 1,
  "magic_prompt_option": "AUTO",
  "resemblance": 50,
  "detail": 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_UPSCALER',
  model: 'ideogram-3',
  promptObject: {
    imageUrl: 'development/images/low_res_photo.png',
    num_images: 1,
    magic_prompt_option: 'AUTO',
    resemblance: 50,
    detail: 50
  }
})
})

Python

import requests

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

data = {
"type": "IMAGE_UPSCALER",
"model": "ideogram-3",
"promptObject": {
  "imageUrl": "development/images/low_res_photo.png",
  "num_images": 1,
  "magic_prompt_option": "AUTO",
  "resemblance": 50,
  "detail": 50
}
}

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

Interactive Playground

API Playground

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

AI Model *Ideogram 3.0

Source Image *

Asset path to the image to upscale

Guiding Prompt (optional)

Number of Images

1–8

Magic Prompt AutoOnOff

Resemblance

How closely to match the original (0–100)

Detail

Level of fine detail to add (0–100)

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_UPSCALER",
  "model": "ideogram-3",
  "promptObject": {
    "imageUrl": "development/images/low_res_photo.png",
    "num_images": 1,
    "magic_prompt_option": "AUTO",
    "resemblance": 50,
    "detail": 50
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "e40dd9ef-0944-4ce5-bc90-1edd2548619a",
  "model": "ideogram-3",
  "type": "IMAGE_UPSCALER",
  "status": "SUCCESS",
  "aiRecordDetail": {
    "promptObject": {
      "imageUrl": "development/images/low_res_photo.png",
      "num_images": 1,
      "magic_prompt_option": "AUTO",
      "resemblance": 50,
      "detail": 50
    },
    "resultObject": [
      "development/images/2026_04_15_upscale_result.png"
    ],
    "responseObject": {
      "created": "2026-04-15T10:30:00Z",
      "data": [
        {
          "url": "https://ideogram.ai/.../upscale.png",
          "prompt": "",
          "resolution": "1024x1024",
          "upscaled_resolution": "2048x2048",
          "is_image_safe": true,
          "seed": 12345
        }
      ]
    }
  }
}
}