ideogram-ai/ideogram-v2/remix

Name: Ideogram V2 Remix
Author: Ideogram

Ideogram V2 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.

Input

Prompt(string)

The prompt to remix the image with

Image URL or upload(string)

Upload

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

The image URL to remix

This field is required.

Strength(number)

0.011

Strength of the input image in the remix Range: 0.01 to 1.

Aspect Ratio(string)

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(integer)

Seed for the random number generator

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDideogram-ai/ideogram-v2/remix

Input Schema

5 parameters · 2 required · 3 optional

Parameter	Type	Required	Description
`image`	string	Required	The image URL to remix
`prompt`	string	Required	The prompt to remix the image with
`seed`	integer	Optional	Seed for the random number generator
`strength`	number	Optional	Strength of the input image in the remix · Min: 0.01 · Max: 1 · Default: 0.8
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "ideogram-ai/ideogram-v2/remix",
  "image": "https://fal.media/files/lion/FHOx4y4a0ef7Sgmo-sOUR_image.png",
  "prompt": "An ice field in north atlantic",
  "strength": 0.8
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Ideogram V2 Remix

API README

Ideogram V2 Remix

ideogram-ai/ideogram-v2/remix creates a new variation from a supplied image, carrying forward its core visual idea while allowing broader changes in style, composition, and detail. Ideogram Remix balances reference influence against creative reinterpretation, preserving useful identity or layout cues without limiting the result to a narrow edit. 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-v2/remix, it supports campaign variants, alternative art directions, composition exploration, and style studies when the source should inspire a related but clearly new image. 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

Reference-led reinterpretation. Carries the source image's central idea into a visibly new composition rather than performing a narrow repair.

Adjustable visual continuity. Moves between close source fidelity and broader creative departure for controlled variation.

Typography-preserving remix. Retains or reimagines readable lettering as the surrounding scene and layout change.

Composition exploration. Produces alternative framing, atmosphere, detail, and style while keeping the reference recognizable.

Pricing

Billing unit	Price
Per request	$0.08

When to Use

✅ Good fit	❌ Consider alternatives
The model's named workflow matches the source material and intended output	A different input modality or model route is required
A managed asynchronous result is suitable for the production pipeline	A synchronous, interactive editor is essential
The documented controls cover the required duration, framing, or format	The project needs controls outside this endpoint's schema
Creative iteration benefits from a repeatable request structure	Exact deterministic pixels, frames, geometry, or samples are mandatory
A finished downloadable media asset is the desired deliverable	Editable 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://fal.media/files/lion/FHOx4y4a0ef7Sgmo-sOUR_image.png",
  "prompt": "An ice field in north atlantic"
}

Technical Specs

Spec	Value
Model ID	`ideogram-ai/ideogram-v2/remix`
Inputs	aspect_ratio, image, prompt, seed, strength
Required inputs	prompt, image
Output fields	content_type, url
Execution	Async (submit, then poll for result)
Aspect Ratio	21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16