Ideogram modelsimage generation api

ideogram-ai/ideogram-v3/reframe

Ideogram V3 Reframe is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Input

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The image URL to reframe

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format
The rendering speed to use. Allowed values: TURBO, BALANCED, QUALITY.
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
Seed for the random number generator
Idle

Example output — click Run to generate your own

API README

Ideogram V3 Reframe

ideogram-ai/ideogram-v3/reframe expands or recomposes an existing image for a new aspect ratio while preserving its important subject and visual intent. Ideogram V3 Reframe generates plausible content beyond the original boundaries and adjusts composition so the result feels authored for the new canvas rather than merely padded. This combination makes the model a practical choice when the creative outcome depends on those qualities rather than on a generic media conversion.

For production work with ideogram-ai/ideogram-v3/reframe, it suits adapting campaign art, posters, product visuals, and social assets across wide, square, and portrait placements without rebuilding every version. The result is most reliable when the source material and creative brief clearly describe the intended subject, progression, visual or sonic character, and the qualities that must remain unchanged.

Highlights

Generative reframing adapts an existing image to a different canvas and aspect ratio.

Content-aware expansion creates plausible scenery and detail beyond the original boundaries.

Subject preservation keeps important people, products, text, and style recognizable.

Composition adaptation rebalances placement so the new format feels intentionally designed.

Pricing

Rendering speedPrice per image
Turbo$0.030
Balanced$0.060
Quality$0.090

When to Use

✅ Good fit❌ Consider alternatives
The model's named workflow matches the source material and intended outputA different input modality or model route is required
A managed asynchronous result is suitable for the production pipelineA synchronous, interactive editor is essential
The documented controls cover the required duration, framing, or formatThe project needs controls outside this endpoint's schema
Creative iteration benefits from a repeatable request structureExact deterministic pixels, frames, geometry, or samples are mandatory
A finished downloadable media asset is the desired deliverableEditable source layers or a native project file are required

Prompt Guide

For image-conditioned generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.

{
  "aspect_ratio": "21:9",
  "image": "https://static.sandbase.ai/examples/ideogram-ai/ideogram-v3/reframe/input_image_0.png",
  "images": [
    [
      "https://example.com/reference.png"
    ]
  ]
}

Technical Specs

SpecValue
Model IDideogram-ai/ideogram-v3/reframe
Inputsaspect_ratio, image, images, rendering_speed, seed
Required inputsimage, aspect_ratio
Output fieldscontent_type, url
ExecutionAsync (submit, then poll for result)
Aspect Ratio21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16

Related Models

Related Models

ideogram-ai/ideogram-v33.0 is Ideogram's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.ideogram-ai/ideogram-v3/characterIdeogram V3 Character is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v3/character/editIdeogram V3 Character Edit by ideogram-ai - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.ideogram-ai/ideogram-v3/character/remixIdeogram V3 Character Remix is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v3/editIdeogram V3 Edit by ideogram-ai - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.ideogram-ai/ideogram-v3/layerize-textIdeogram V3 Layerize Text is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v3/remixIdeogram V3 Remix is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v3/replace-backgroundIdeogram V3 Replace Background by ideogram-ai - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.