---
title: Ideogram 2.0 Remix | Runware Docs
url: https://runware.ai/docs/models/ideogram-2-0-remix
description: Remix Ideogram 2.0 images with new moods and styles
---
# Ideogram 2.0 Remix

![Ideogram 2.0 Remix](https://assets.runware.ai/covers/ideogram-2-0-remix.jpg)

Ideogram 2.0 Remix lets you rework existing images while preserving structure and layout. Change styles or mood, adjust composition, and iterate quickly from a reference image. Ideal for designers who need fast visual variants and style exploration from prior outputs.

- **Status**: live
- **ID**: `ideogram:3@2`
- Try in Playground
- **Creator**: Ideogram
- **Release Date**: October 23, 2024
- **Zero Data Retention**: Yes
- **Capabilities**: Image to Image, Checkpoint

## Pricing

$0.05 from, per run · ~14s per request

**Rates** (per run)

- Turbo: `$0.05`
- Default: `$0.08`

**2 example generations**

- [reference-to-image](https://runware.ai/docs/models/ideogram-2-0-remix/examples#example-antarctic-station-winter-editorial): `$0.08` (~10s)
- [reference-to-image](https://runware.ai/docs/models/ideogram-2-0-remix/examples#example-heritage-telescope-tourism-hero-image): `$0.08` (~18s)

times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Compatibility & Validation

`width` and `height` must be used together.

---

The following dimension combinations are supported:

| Configuration | Dimensions |
| --- | --- |
| `1K (3:1)` | `1536x512` |
| `1K (~21:9)` | `1536x576` |
| `1K (~21:9)` | `1472x576` |
| `1K (~21:9)` | `1408x576` |
| `1K (~21:9)` | `1536x640` |
| `1K (~21:9)` | `1472x640` |
| `1K (~21:9)` | `1408x640` |
| `1K (~2:1)` | `1344x640` |
| `1K (~2:1)` | `1472x704` |
| `1K (2:1)` | `1408x704` |
| `1K (~2:1)` | `1344x704` |
| `1K (~16:9)` | `1280x704` |
| `1K (16:9)` | `1312x736` |
| `1K (16:9)` | `1280x720` |
| `1K (~16:9)` | `1344x768` |
| `1K (~16:9)` | `1216x704` |
| `1K (5:3)` | `1280x768` |
| `1K (~5:3)` | `1152x704` |
| `1K (16:10)` | `1232x768` |
| `1K (16:10)` | `1024x640` |
| `1K (~16:10)` | `1216x768` |
| `1K (3:2)` | `1248x832` |
| `1K (~3:2)` | `1216x832` |
| `1K (~3:2)` | `1088x768` |
| `1K (~4:3)` | `1152x832` |
| `1K (4:3)` | `1152x864` |
| `1K (~4:3)` | `1088x832` |
| `1K (~5:4)` | `1152x896` |
| `1K (5:4)` | `1120x896` |
| `1K (~5:4)` | `1024x832` |
| `1K (~5:4)` | `1088x896` |
| `1K (~5:4)` | `960x832` |
| `1K (~5:4)` | `1024x896` |
| `1K (~5:4)` | `1088x960` |
| `1K (~1:1)` | `960x896` |
| `1K (~1:1)` | `1024x960` |
| `1K (1:1)` | `1024x1024` |
| `1K (~1:1)` | `960x1024` |
| `1K (~1:1)` | `896x960` |
| `1K (~4:5)` | `960x1088` |
| `1K (~4:5)` | `896x1024` |
| `1K (~4:5)` | `832x960` |
| `1K (~4:5)` | `896x1088` |
| `1K (~4:5)` | `832x1024` |
| `1K (4:5)` | `896x1120` |
| `1K (~4:5)` | `896x1152` |
| `1K (~3:4)` | `832x1088` |
| `1K (3:4)` | `864x1152` |
| `1K (~3:4)` | `832x1152` |
| `1K (~2:3)` | `768x1088` |
| `1K (~2:3)` | `832x1216` |
| `1K (2:3)` | `832x1248` |
| `1K (~10:16)` | `768x1216` |
| `1K (10:16)` | `640x1024` |
| `1K (10:16)` | `768x1232` |
| `1K (~3:5)` | `704x1152` |
| `1K (3:5)` | `768x1280` |
| `1K (~9:16)` | `704x1216` |
| `1K (~9:16)` | `768x1344` |
| `1K (9:16)` | `720x1280` |
| `1K (9:16)` | `736x1312` |
| `1K (~9:16)` | `704x1280` |
| `1K (~1:2)` | `704x1344` |
| `1K (1:2)` | `704x1408` |
| `1K (~1:2)` | `704x1472` |
| `1K (~1:2)` | `640x1344` |
| `1K (~9:21)` | `640x1408` |
| `1K (~9:21)` | `640x1472` |
| `1K (~9:21)` | `640x1536` |
| `1K (~9:21)` | `576x1408` |
| `1K (~9:21)` | `576x1472` |
| `1K (~1:3)` | `576x1536` |
| `1K (1:3)` | `512x1536` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/ideogram-2-0-remix#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/ideogram-2-0-remix#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/ideogram-2-0-remix#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Image output type.

**Allowed values**: `URL` `base64Data` `dataURI`

### [outputFormat](https://runware.ai/docs/models/ideogram-2-0-remix#request-outputformat)

- **Type**: `string`
- **Default**: `JPG`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`JPG\`: Best for photorealistic images with smaller file sizes (no transparency).
- \`PNG\`: Lossless compression, supports high quality and transparency (alpha channel).
- \`WEBP\`: Modern format providing superior compression and transparency support.

> [!NOTE]
> \*\*Transparency\*\*: If you are using features like background removal or LayerDiffuse that require transparency, you must select a format that supports an alpha channel (e.g., \`PNG\`, \`WEBP\`, \`TIFF\`). \`JPG\` does not support transparency.

**Allowed values**: `JPG` `PNG` `WEBP`

### [outputQuality](https://runware.ai/docs/models/ideogram-2-0-remix#request-outputquality)

- **Type**: `integer`
- **Min**: `20`
- **Max**: `99`
- **Default**: `95`

Compression quality of the output. Higher values preserve quality but increase file size.

### [webhookURL](https://runware.ai/docs/models/ideogram-2-0-remix#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/ideogram-2-0-remix#request-deliverymethod)

- **Type**: `string`
- **Default**: `sync`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/ideogram-2-0-remix#request-uploadendpoint)

- **Type**: `string`
- **Format**: `uri`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [safety](https://runware.ai/docs/models/ideogram-2-0-remix#request-safety)

- **Path**: `safety.checkContent`
- **Type**: `object (1 property)`

Content safety checking configuration for image generation.

#### [checkContent](https://runware.ai/docs/models/ideogram-2-0-remix#request-safety-checkcontent)

- **Path**: `safety.checkContent`
- **Type**: `boolean`

Enable or disable content safety checking. Increases total generation time and adds a small charge on top of the generation cost.

### [ttl](https://runware.ai/docs/models/ideogram-2-0-remix#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/ideogram-2-0-remix#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/ideogram-2-0-remix#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `20`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [referenceImages](https://runware.ai/docs/models/ideogram-2-0-remix#request-inputs-referenceimages)

- **Path**: `inputs.referenceImages`
- **Type**: `array of strings`
- **Required**: true
- **Min items**: `items: 1`

List of reference images (UUID, URL, Data URI, or Base64).

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/ideogram-2-0-remix#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `ideogram:3@2`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/ideogram-2-0-remix#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `1`
- **Max**: `2000`

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [negativePrompt](https://runware.ai/docs/models/ideogram-2-0-remix#request-negativeprompt)

- **Type**: `string`
- **Min**: `1`
- **Max**: `2000`

Prompt to guide what to exclude from generation. Ignored when guidance is disabled (CFGScale ≤ 1).

**Learn more** (1 resource):

- [Prompts: Negative Prompts](https://runware.ai/docs/learn/prompts#negative-prompts) (learn)

### [width](https://runware.ai/docs/models/ideogram-2-0-remix#request-width)

- **Type**: `integer`
- **Required**: true
- **Paired with**: height

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [height](https://runware.ai/docs/models/ideogram-2-0-remix#request-height)

- **Type**: `integer`
- **Required**: true
- **Paired with**: width

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

**Features**

Standalone addons and post-processing features.

### [watermark](https://runware.ai/docs/models/ideogram-2-0-remix#request-advancedfeatures-watermark)

- **Path**: `advancedFeatures.watermark`
- **Type**: `object (6 properties)`

Configuration object for adding watermarks to generated videos. Watermarks can be applied using either text or image content with customizable positioning and appearance. You must provide either `text` or `image` content for the watermark, but not both.

**Text watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "© 2025 Company",
    "displayPosition": "bottom-right",
    "opacity": 0.6,
    "fontColor": "#ffffff",
    "bgColor": "#000000"
  }
}
```

**Image watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "image": "c64351d5-4c59-42f7-95e1-eace013eddab",
    "displayPosition": "top-left",
    "opacity": 0.6
  }
}
```

**Tiled watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "PREVIEW",
    "tiled": true,
    "opacity": 0.4,
    "fontColor": "#cccccc"
  }
}
```

#### [text](https://runware.ai/docs/models/ideogram-2-0-remix#request-advancedfeatures-watermark-text)

- **Path**: `advancedFeatures.watermark.text`
- **Type**: `string`
- **Min**: `2`
- **Max**: `32`

Watermark text.

#### [image](https://runware.ai/docs/models/ideogram-2-0-remix#request-advancedfeatures-watermark-image)

- **Path**: `advancedFeatures.watermark.image`
- **Type**: `string`

Watermark image (UUID, URL, Data URI, or Base64).

#### [displayPosition](https://runware.ai/docs/models/ideogram-2-0-remix#request-advancedfeatures-watermark-displayposition)

- **Path**: `advancedFeatures.watermark.displayPosition`
- **Type**: `string`

Watermark position.

**Allowed values**: `top-left` `top-center` `top-right` `center-left` `center-center` `center-right` `bottom-left` `bottom-center` `bottom-right` `tiled`

#### [opacity](https://runware.ai/docs/models/ideogram-2-0-remix#request-advancedfeatures-watermark-opacity)

- **Path**: `advancedFeatures.watermark.opacity`
- **Type**: `float`
- **Min**: `0.1`
- **Max**: `1`
- **Step**: `0.01`

Watermark opacity.

#### [fontColor](https://runware.ai/docs/models/ideogram-2-0-remix#request-advancedfeatures-watermark-fontcolor)

- **Path**: `advancedFeatures.watermark.fontColor`
- **Type**: `string`

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/ideogram-2-0-remix#request-advancedfeatures-watermark-bgcolor)

- **Path**: `advancedFeatures.watermark.bgColor`
- **Type**: `string`

Background color in hex format.

**Provider Settings**

Parameters specific to this model provider. These must be nested inside the \`providerSettings.ideogram\` object.

### [magicPrompt](https://runware.ai/docs/models/ideogram-2-0-remix#request-providersettings-ideogram-magicprompt)

- **Path**: `providerSettings.ideogram.magicPrompt`
- **Type**: `string`
- **Default**: `AUTO`

Automatic prompt enhancement.

**Allowed values**:

- `AUTO` Content-based enhancement.
- `ON` Always enhance.
- `OFF` No enhancement.

### [styleType](https://runware.ai/docs/models/ideogram-2-0-remix#request-providersettings-ideogram-styletype)

- **Path**: `providerSettings.ideogram.styleType`
- **Type**: `string`
- **Default**: `AUTO`

Visual style and rendering approach.

**Allowed values**:

- `AUTO` Automatically selects the most appropriate style.
- `GENERAL` Versatile style suitable for most content types.
- `REALISTIC` Photorealistic rendering with natural lighting and textures.
- `DESIGN` Optimized for graphic design, logos, and typography.
- `RENDER_3D` Three-dimensional rendering with depth and modeling effects.
- `ANIME` Anime/manga visual style.
- `FICTION` Stylized rendering for fictional and fantasy content.

## Response Parameters

### [taskType](https://runware.ai/docs/models/ideogram-2-0-remix#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/ideogram-2-0-remix#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [imageUUID](https://runware.ai/docs/models/ideogram-2-0-remix#response-imageuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/ideogram-2-0-remix#response-imageurl)

- **Type**: `string`
- **Format**: `uri`

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/ideogram-2-0-remix#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/ideogram-2-0-remix#response-imagedatauri)

- **Type**: `string`
- **Format**: `uri`

Data URI of the output image.

### [NSFWContent](https://runware.ai/docs/models/ideogram-2-0-remix#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/ideogram-2-0-remix#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

## Examples

### reference-to-image (reference-to-image)

![Antarctic Station Winter Editorial](https://assets.runware.ai/examples/ideogram-2-0-remix/9594ae80-57a3-47c3-bce1-9042697ca7ee.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "84c89a94-436d-4d41-bc99-e62a86c80503",
  "model": "ideogram:3@2",
  "positivePrompt": "Remix the source photograph into a photorealistic Antarctic research station during the depths of austral winter polar night. Preserve the exact camera position, square framing, terrain contours, arrangement and geometry of all three red elevated modules, enclosed walkways, satellite dome, antenna mast, parked orange snowcat, crates and tracks so the facility remains immediately recognizable. Replace the bright summer sky with deep cobalt darkness and a restrained green aurora low across the horizon. Relight the scene with warm amber window light, practical safety lamps and cold moonlit snow; create believable pools of illumination, long soft shadows and subtle reflections on wind-polished ice. Add fresh windblown snow gathered around supports and tracks, delicate frost on metal edges and faint airborne ice crystals, without hiding architectural details. High-end polar documentary photography for an institutional annual report, natural exposure, crisp material texture, quiet operational mood, scientifically credible environment, no added text or branding.",
  "negativePrompt": "Changed viewpoint, altered building design, moved structures, extra buildings, missing snowcat, buried facility, dramatic fantasy sky, oversized aurora, daytime sunlight, tropical elements, people, illustration, CGI appearance, excessive bloom, illegible details, text, captions, logos, watermark, border or mockup.",
  "width": 1024,
  "height": 1024,
  "providerSettings": {
    "ideogram": {
      "magicPrompt": "AUTO"
    }
  },
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/5407353b-7661-4e75-a005-6b6306cddab1.jpg"
    ]
  }
}
```

---

### reference-to-image (reference-to-image)

![Heritage Telescope Tourism Hero Image](https://assets.runware.ai/examples/ideogram-2-0-remix/14d85376-2721-4c81-abca-f82332fd06f2.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "6ff79560-e95e-42a0-8cce-ec29083aeca9",
  "model": "ideogram:3@2",
  "positivePrompt": "Replace the plain studio background with an atmospheric Art Deco seaside pier at blue hour while preserving the reference telescope as the unmistakable hero subject. Keep its exact silhouette, proportions, navy cast-iron pedestal, cream enamel head, chrome controls, weathering, and viewing direction. Position it naturally on rain-darkened timber boards near the pier railing, with physically accurate contact shadows and a few subtle reflections from warm globe lamps. Beyond the railing, show a calm deep-cobalt sea, a thin coral sunset at the horizon, distant coastal lights, and faint mist. Premium photorealistic tourism campaign photography, cinematic yet believable, cool blue environment contrasted by restrained amber practical lighting, crisp detail on the telescope, shallow atmospheric depth, eye-level three-quarter composition, square crop, generous breathing room, no typography.",
  "negativePrompt": "Extra telescopes, duplicated parts, altered product design, floating subject, incorrect scale, warped pedestal, people, crowds, boats dominating the frame, logos, captions, signage, readable text, fantasy elements, heavy fog obscuring the subject, oversaturated colors, illustration, CGI appearance.",
  "width": 1024,
  "height": 1024,
  "providerSettings": {
    "ideogram": {
      "magicPrompt": "AUTO"
    }
  },
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/99584063-d3ba-4b8c-b23a-0e552238a960.jpg"
    ]
  }
}
```