---
title: Ideogram 3.0 Edit | Runware Docs
url: https://runware.ai/docs/models/ideogram-3-0-edit
description: High precision Ideogram 3.0 image inpainting model
---
# Ideogram 3.0 Edit

![Ideogram 3.0 Edit](https://assets.runware.ai/covers/ideogram-3-0-edit.jpg)

Ideogram 3.0 Edit lets you inpaint images with surgical control. Upload an image, mask a region, then refine layout or text while the rest stays intact. Ideal for typography fixes, layout tweaks, brand updates, and production safe visual polish in existing assets.

- **Status**: live
- **ID**: `ideogram:4@3`
- Try in Playground
- **Creator**: Ideogram
- **Release Date**: May 1, 2025
- **Zero Data Retention**: Yes
- **Capabilities**: Image to Image, Checkpoint

## Pricing

$0.03 from, per run · ~24s per request

**Rates** (per run)

- Turbo: `$0.03`
- Default: `$0.06`
- Quality: `$0.09`

**3 example generations**

- [masked-identity-preservation](https://runware.ai/docs/models/ideogram-3-0-edit/examples#example-synchronized-swim-roster-portrait): `$0.06` (~24s)
- [identity-preservation](https://runware.ai/docs/models/ideogram-3-0-edit/examples#example-volcanologist-field-report-portrait): `$0.06` (~26s)
- [inpaint](https://runware.ai/docs/models/ideogram-3-0-edit/examples#example-railway-signalwoman-portrait-restoration): `$0.06` (~17s)

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

## Compatibility & Validation

When `providerSettings.ideogram.characterReferenceImages` is provided, `providerSettings.ideogram.styleType` is limited to `AUTO`, `REALISTIC`, `FICTION`.

---

When `providerSettings.ideogram.characterReferenceImagesMask` is provided, `providerSettings.ideogram.characterReferenceImages` requires at least 1 item.

---

When `providerSettings.ideogram.styleType` is `FICTION`, `providerSettings.ideogram.characterReferenceImages` is required.

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

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

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

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/ideogram-3-0-edit#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-3-0-edit#request-outputtype)

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

Image output type.

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

### [outputFormat](https://runware.ai/docs/models/ideogram-3-0-edit#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-3-0-edit#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-3-0-edit#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-3-0-edit#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-3-0-edit#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-3-0-edit#request-safety)

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

Content safety checking configuration for image generation.

#### [checkContent](https://runware.ai/docs/models/ideogram-3-0-edit#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-3-0-edit#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-3-0-edit#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/ideogram-3-0-edit#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.

### [seedImage](https://runware.ai/docs/models/ideogram-3-0-edit#request-inputs-seedimage)

- **Path**: `inputs.seedImage`
- **Type**: `string`
- **Required**: true

Image used as a starting point for the generation (UUID, URL, Data URI, or Base64).

**Learn more** (3 resources):

- [Image To Image: Seed Image The Foundation](https://runware.ai/docs/learn/image-to-image#seed-image-the-foundation) (learn)
- [Image Inpainting: Seed And Mask Image The Foundation](https://runware.ai/docs/learn/image-inpainting#seed-and-mask-image-the-foundation) (learn)
- [Image Outpainting: Seed Image The Starting Point](https://runware.ai/docs/learn/image-outpainting#seed-image-the-starting-point) (learn)

### [maskImage](https://runware.ai/docs/models/ideogram-3-0-edit#request-inputs-maskimage)

- **Path**: `inputs.maskImage`
- **Type**: `string`
- **Required**: true

Image used to specify which areas of the input image should be edited (UUID, URL, Data URI, or Base64). White marks the area to edit, black is preserved.

**Learn more** (1 resource):

- [Image Inpainting: Seed And Mask Image The Foundation](https://runware.ai/docs/learn/image-inpainting#seed-and-mask-image-the-foundation) (learn)

**Core Parameters**

Primary parameters that define the task output.

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

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

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-3-0-edit#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)

**Features**

Standalone addons and post-processing features.

### [watermark](https://runware.ai/docs/models/ideogram-3-0-edit#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-3-0-edit#request-advancedfeatures-watermark-text)

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

Watermark text.

#### [image](https://runware.ai/docs/models/ideogram-3-0-edit#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-3-0-edit#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-3-0-edit#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-3-0-edit#request-advancedfeatures-watermark-fontcolor)

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

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/ideogram-3-0-edit#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.

### [characterReferenceImages](https://runware.ai/docs/models/ideogram-3-0-edit#request-providersettings-ideogram-characterreferenceimages)

- **Path**: `providerSettings.ideogram.characterReferenceImages`
- **Type**: `array of strings`
- **Min items**: `items: 1`

Character reference images to preserve consistent facial and body traits across generations.

### [characterReferenceImagesMask](https://runware.ai/docs/models/ideogram-3-0-edit#request-providersettings-ideogram-characterreferenceimagesmask)

- **Path**: `providerSettings.ideogram.characterReferenceImagesMask`
- **Type**: `array of strings`
- **Min items**: `items: 1`

Mask images for character reference images. Must match the number of character reference images.

### [magicPrompt](https://runware.ai/docs/models/ideogram-3-0-edit#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.

### [renderingSpeed](https://runware.ai/docs/models/ideogram-3-0-edit#request-providersettings-ideogram-renderingspeed)

- **Path**: `providerSettings.ideogram.renderingSpeed`
- **Type**: `string`
- **Default**: `DEFAULT`

Generation speed/quality tradeoff.

**Allowed values**:

- `TURBO` Fastest generation.
- `DEFAULT` Balanced speed and quality.
- `QUALITY` Best quality.

### [stylePreset](https://runware.ai/docs/models/ideogram-3-0-edit#request-providersettings-ideogram-stylepreset)

- **Path**: `providerSettings.ideogram.stylePreset`
- **Type**: `string`

Artistic style preset.

**Allowed 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`

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

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

Visual style and rendering approach.

**Allowed values**: `AUTO` `GENERAL` `REALISTIC` `DESIGN` `FICTION`

## Response Parameters

### [taskType](https://runware.ai/docs/models/ideogram-3-0-edit#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-3-0-edit#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-3-0-edit#response-imageuuid)

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

UUID of the output image.

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

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

URL of the output image.

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

- **Type**: `string`

Base64-encoded image data.

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

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

Data URI of the output image.

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

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

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

- **Type**: `float`

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

## Examples

### inpaint (inpaint)

![Railway Signalwoman Portrait Restoration](https://assets.runware.ai/examples/ideogram-3-0-edit/f18ae37e-d7f1-45b3-a9c9-38390e18499c.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "2b82ec32-9123-4b4e-9edc-77174e37b8f6",
  "model": "ideogram:4@3",
  "positivePrompt": "Restore and colorize the entire masked railway signalwoman as a museum-quality archival photograph while preserving her exact identity, facial structure, expression, pose, proportions, uniform design, and silhouette. Repair scratches, creases, fading, silvering, dust, and missing emulsion across her face, hands, clothing, cap, and shoes. Reconstruct damaged details conservatively from the surviving photograph, with natural skin texture and no beauty retouching. Apply restrained, historically plausible 1943 color: navy-blue wool railway jacket and skirt, off-white blouse, black leather shoes, dark navy cap, subtle brass insignia, and realistic muted skin tones. Retain authentic 1940s studio lighting, modest tonal range, fine monochrome-era film grain, and the physical character of a carefully conserved vintage print. Keep edges clean and anatomically accurate. Do not alter, replace, colorize, or clean the unmasked gray studio backdrop; preserve the surrounding scene and its original scan texture exactly. No modern styling, jewelry, props, text, borders, or invented scenery.",
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/45efdc44-ad12-4f98-8a70-7888a37c5de5.jpg",
    "maskImage": "https://assets.runware.ai/assets/inputs/954a9282-f4d9-49a5-bf53-f30105c76f3f.png"
  }
}
```

---

### masked-identity-preservation (masked-identity-preservation)

![Synchronized Swim Roster Portrait](https://assets.runware.ai/examples/ideogram-3-0-edit/247ffb18-a948-4f33-8dc8-99d64a9fb12a.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "b0a01b83-ba6d-4b74-884c-3241a28b7c92",
  "model": "ideogram:4@3",
  "positivePrompt": "Replace only the masked stand-in at the far right of this synchronized swimming team group portrait with the athlete shown in the character reference image. Preserve her recognizable facial structure, hairstyle, skin tone, body proportions, and athletic build. Dress her in the same cobalt-blue warm-up jacket with burnt-orange piping and cream trousers worn by the team. Match the original subject's full-length standing pose, scale, camera perspective, spacing, crisp midday illumination, shadow direction, and contact with the pool deck so she belongs naturally in the lineup. Keep every unmasked teammate, expression, pose, garment, pool detail, pale aqua tiled wall, composition, 1970s aquatic editorial palette, and photographic texture unchanged. The finished image should read as one authentic, professionally photographed official season roster portrait, with realistic anatomy, clean garment details, natural hands, and no text.",
  "providerSettings": {
    "ideogram": {
      "characterReferenceImages": [
        "https://assets.runware.ai/assets/inputs/10a43554-9a16-407d-97cf-fb7df07fae8a.jpg"
      ],
      "characterReferenceImagesMask": [
        "https://assets.runware.ai/assets/inputs/4d8e04c7-24d1-4210-b469-d79b1401aa72.png"
      ],
      "styleType": "REALISTIC"
    }
  },
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/2b2f5f8e-a21f-4bb9-8741-618a6136b47b.jpg",
    "maskImage": "https://assets.runware.ai/assets/inputs/ea1619bc-51d8-4d3a-b072-a2a0a78194e1.png"
  }
}
```

---

### identity-preservation (identity-preservation)

![Volcanologist Field Report Portrait](https://assets.runware.ai/examples/ideogram-3-0-edit/5b94bf72-f7f5-42e8-b4d5-f4436b60340f.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "4bc845a8-ebb8-49b4-ba79-2f1a9d432a10",
  "model": "ideogram:4@3",
  "positivePrompt": "Replace only the masked field technician with the woman from the character reference, placing her naturally into this exact volcanic survey scene. Preserve her recognizable facial structure, copper-brown complexion, dark almond-shaped eyes, black-and-silver braid, age and compact sturdy body proportions. Match the original subject's full-length stance and hand position, with her holding the same portable gas meter at waist height. Dress her in the same sulfur-yellow weatherproof survey jacket, dark field trousers and hiking boots. Keep every unmasked element unchanged: the charcoal ash plain, pale mist, horizon, framing, overcast light and muted mineral palette. Integrate realistic edge detail, atmospheric perspective, garment folds, boot contact and a soft ground shadow consistent with the existing light. Polished documentary editorial photography for a professional volcanic hazard report, natural and credible, no text.",
  "providerSettings": {
    "ideogram": {
      "characterReferenceImages": [
        "https://assets.runware.ai/assets/inputs/82575f39-5b7d-4a35-bdb8-75529c5dbade.jpg"
      ],
      "styleType": "REALISTIC"
    }
  },
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/9c7fbb09-6a8d-4ad9-9216-eeb6634a16a5.jpg",
    "maskImage": "https://assets.runware.ai/assets/inputs/d800ae07-82a2-42e8-91d4-5cd9c631f0c0.png"
  }
}
```