Ideogram - Image Extender

Extend (outpaint) an existing image to a new target resolution using Ideogram 3.0's Reframe. The original image content is preserved and the surrounding area is intelligently generated to fill the requested canvas.

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

Prompt Object Parameters

Parameter	Type	Required	Description	Default
imageUrl	string	Yes	Asset path to the source image to extend	-
resolution	string	Yes	Target output resolution (width×height)	-
num_images	number	Yes	Number of variations to generate (1–8)	-
rendering_speed	string	No	Speed vs quality tradeoff. One of FLASH, TURBO, DEFAULT, QUALITY	DEFAULT
style_preset	string	No	Predefined artistic style. Mutually exclusive with style_reference_images — providing both returns an error	-
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/WebP. Mutually exclusive with style_preset — providing both returns an error	-
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

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_EXTENDER",
"model": "ideogram-3",
"promptObject": {
  "imageUrl": "development/images/portrait.png",
  "resolution": "1280x768",
  "num_images": 1,
  "rendering_speed": "DEFAULT"
}
}'

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_EXTENDER',
  model: 'ideogram-3',
  promptObject: {
    imageUrl: 'development/images/portrait.png',
    resolution: '1280x768',
    num_images: 1,
    rendering_speed: 'DEFAULT'
  }
})
})

Python

import requests

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

data = {
"type": "IMAGE_EXTENDER",
"model": "ideogram-3",
"promptObject": {
  "imageUrl": "development/images/portrait.png",
  "resolution": "1280x768",
  "num_images": 1,
  "rendering_speed": "DEFAULT"
}
}

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 extend

Target Resolution *

WIDTHxHEIGHT

Number of Images

1–8

Rendering Speed Flash (Fastest)TurboDefaultQuality (Best)

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.

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_EXTENDER",
  "model": "ideogram-3",
  "promptObject": {
    "imageUrl": "development/images/portrait.png",
    "resolution": "1280x768",
    "num_images": 1,
    "rendering_speed": "DEFAULT"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "e40dd9ef-0944-4ce5-bc90-1edd2548619a",
  "model": "ideogram-3",
  "type": "IMAGE_EXTENDER",
  "status": "SUCCESS",
  "aiRecordDetail": {
    "promptObject": {
      "imageUrl": "development/images/portrait.png",
      "resolution": "1280x768",
      "num_images": 1,
      "rendering_speed": "DEFAULT"
    },
    "resultObject": [
      "development/images/2026_04_15_reframe_result.png"
    ],
    "responseObject": {
      "created": "2026-04-15T10:30:00Z",
      "data": [
        {
          "url": "https://ideogram.ai/.../reframe.png",
          "prompt": "",
          "resolution": "1280x768",
          "is_image_safe": true,
          "seed": 12345
        }
      ]
    }
  }
}
}