---
title: GPT Image 1 Mini | Runware Docs
url: https://runware.ai/docs/models/openai-gpt-image-1-mini
description: Cost-effective GPT Image 1 variant optimized for speed and efficiency
---
# GPT Image 1 Mini

![GPT Image 1 Mini](https://assets.runware.ai/covers/openai-gpt-image-1-mini.jpg)

GPT Image 1 Mini is a lighter variant of OpenAI's GPT Image 1 model. It offers faster generation at a lower cost while retaining core capabilities including text-to-image generation, image editing, and text rendering. It is suited for high-volume workflows, rapid prototyping, and cost-sensitive applications where the full GPT Image 1 model may be excessive.

- **Status**: deprecated
- **ID**: `openai:1@2`
- Try in Playground
- **Creator**: OpenAI
- **Release Date**: April 23, 2025
- **Capabilities**: Text to Image, Image to Image, Edit, Checkpoint, Transparency

## Pricing

$0.036 per run · ~44s per request

**4 example generations**

- [transparent-background](https://runware.ai/docs/models/openai-gpt-image-1-mini/examples#example-battery-safety-book-character-sticker) · 1024×1024: `$0.036` (~41s)
- [inpaint](https://runware.ai/docs/models/openai-gpt-image-1-mini/examples#example-observatory-architecture-square-outpaint) · 1024×1024: `$0.036` (~34s)
- [text-to-image](https://runware.ai/docs/models/openai-gpt-image-1-mini/examples#example-polar-research-vessel-christening-invitation) · 1536×1024: `$0.052` (~47s)
- [reference-to-image](https://runware.ai/docs/models/openai-gpt-image-1-mini/examples#example-pipe-organ-workshop-cover) · 1024×1536: `$0.052` (~50s)

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

## Compatibility & Validation

When `inputs.maskImage` is provided, `inputs.referenceImages` is required.

---

When `settings.background` is `transparent`, `outputFormat` is limited to `PNG`, `WEBP`.

---

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

---

The following dimension combinations are supported:

| Configuration | Dimensions |
| --- | --- |
| `1K (1:1)` | `1024x1024` |
| `1K (3:2)` | `1536x1024` |
| `1K (2:3)` | `1024x1536` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/openai-gpt-image-1-mini#request-tasktype)

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

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/openai-gpt-image-1-mini#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/openai-gpt-image-1-mini#request-outputtype)

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

Image output type.

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

### [outputFormat](https://runware.ai/docs/models/openai-gpt-image-1-mini#request-outputformat)

- **Type**: `string`
- **Required**: conditional — Required when settings.background is provided
- **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/openai-gpt-image-1-mini#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/openai-gpt-image-1-mini#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/openai-gpt-image-1-mini#request-deliverymethod)

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

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns complete results directly in the API response.
- `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/openai-gpt-image-1-mini#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/openai-gpt-image-1-mini#request-safety)

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

Content safety checking configuration for image generation.

#### [checkContent](https://runware.ai/docs/models/openai-gpt-image-1-mini#request-safety-checkcontent)

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

Enable or disable content safety checking. Increases total generation time.

### [ttl](https://runware.ai/docs/models/openai-gpt-image-1-mini#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/openai-gpt-image-1-mini#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/openai-gpt-image-1-mini#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.

### [maskImage](https://runware.ai/docs/models/openai-gpt-image-1-mini#request-inputs-maskimage)

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

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. The model treats the mask as guidance rather than a hard boundary, so edits can extend past its shape. With several reference images the mask applies to the first.

### [referenceImages](https://runware.ai/docs/models/openai-gpt-image-1-mini#request-inputs-referenceimages)

- **Path**: `inputs.referenceImages`
- **Type**: `array of strings`
- **Min items**: `1`
- **Max items**: `16`

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/openai-gpt-image-1-mini#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `openai:1@2`

Identifier of the model to use for generation.

**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/openai-gpt-image-1-mini#request-positiveprompt)

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

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

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

### [width](https://runware.ai/docs/models/openai-gpt-image-1-mini#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/openai-gpt-image-1-mini#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)

**Settings**

Technical parameters to fine-tune the inference process. These must be nested inside the \`settings\` object.

### [background](https://runware.ai/docs/models/openai-gpt-image-1-mini#request-settings-background)

- **Path**: `settings.background`
- **Type**: `string`
- **Default**: `auto`

Background handling in generated images.

**Allowed values**:

- `auto` Automatically determines the most appropriate background based on content.
- `opaque` Solid background, no transparency.
- `transparent` Transparent background areas where applicable.

**Features**

Standalone addons and post-processing features.

### [watermark](https://runware.ai/docs/models/openai-gpt-image-1-mini#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/openai-gpt-image-1-mini#request-advancedfeatures-watermark-text)

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

Watermark text.

#### [image](https://runware.ai/docs/models/openai-gpt-image-1-mini#request-advancedfeatures-watermark-image)

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

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

#### [displayPosition](https://runware.ai/docs/models/openai-gpt-image-1-mini#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/openai-gpt-image-1-mini#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/openai-gpt-image-1-mini#request-advancedfeatures-watermark-fontcolor)

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

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/openai-gpt-image-1-mini#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.openai\` object.

### [moderation](https://runware.ai/docs/models/openai-gpt-image-1-mini#request-providersettings-openai-moderation)

- **Path**: `providerSettings.openai.moderation`
- **Type**: `string`
- **Default**: `auto`

Content moderation level.

**Allowed values**:

- `auto` Standard filtering that limits creating certain categories of potentially age-inappropriate content.
- `low` Less restrictive filtering.

### [quality](https://runware.ai/docs/models/openai-gpt-image-1-mini#request-providersettings-openai-quality)

- **Path**: `providerSettings.openai.quality`
- **Type**: `string`
- **Default**: `auto`

Image quality level.

**Allowed values**: `auto` `high` `medium` `low`

## Response Parameters

### [taskType](https://runware.ai/docs/models/openai-gpt-image-1-mini#response-tasktype)

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

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/openai-gpt-image-1-mini#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/openai-gpt-image-1-mini#response-imageuuid)

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

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/openai-gpt-image-1-mini#response-imageurl)

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

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/openai-gpt-image-1-mini#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/openai-gpt-image-1-mini#response-imagedatauri)

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

Data URI of the output image.

### [seed](https://runware.ai/docs/models/openai-gpt-image-1-mini#response-seed)

- **Type**: `integer`

The seed used for generation. If none was provided, shows the randomly generated seed.

### [NSFWContent](https://runware.ai/docs/models/openai-gpt-image-1-mini#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/openai-gpt-image-1-mini#response-cost)

- **Type**: `float`

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

## Examples

### text-to-image (text-to-image)

![Polar Research Vessel Christening Invitation](https://assets.runware.ai/examples/openai-gpt-image-1-mini/4421875b-b32b-48d8-b868-798da4abf7a7.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "e723eee8-fd21-448a-b11b-752fb218461a",
  "model": "openai:1@2",
  "positivePrompt": "Create a finished landscape invitation card for the christening of a polar climate research vessel, composed edge-to-edge at a 3:2 ratio. This is the flat invitation artwork itself, not a photograph, mockup, envelope, or card displayed on a table. Sophisticated contemporary Nordic art direction combining precise nautical technical drawing with bold screen-printed shapes. On the left two-thirds, show the research vessel R/V Aurora Vale in crisp side profile moving through a dark Arctic harbor at blue hour, with a white angular hull, small illuminated bridge windows, scientific cranes, antenna arrays, and a single safety-orange stripe. Beneath the waterline, include elegant contour lines suggesting ocean-depth mapping; above, use sparse geometric snow and a pale arc of aurora. On the right third, create a calm warm-ivory typography panel separated by a thin safety-orange vertical rule. Strong visual hierarchy, generous margins, refined condensed sans-serif capitals paired with a highly legible modern serif for details. Palette limited to midnight navy, glacier blue, warm ivory, and vivid safety orange. Premium cultural-institution print design, subtle paper grain, clean registration, restrained celebratory mood, crisp professional typography.\n\nRender the following invitation copy exactly, with correct spelling, punctuation, capitalization, and line breaks, and include no other words:\n\nYOU ARE INVITED\n\nCHRISTENING OF\nR/V AURORA VALE\n\nSATURDAY 17 OCTOBER 2026 · 16:00\nNORTH QUAY · TROMSØ\n\nCEREMONY, SHIP TOUR\n& HARBOR SUPPER\n\nRSVP BY 25 SEPTEMBER\nAURORAVALE.NO/RSVP\n\nKeep every line fully readable and unobstructed. No logos, QR codes, borders, hands, envelopes, photographic props, UI elements, or extra decorative lettering.",
  "width": 1536,
  "height": 1024
}
```

---

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

![Pipe Organ Workshop Cover](https://assets.runware.ai/examples/openai-gpt-image-1-mini/96823d60-7c8a-438f-ad0c-3d329e7eb282.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "168f68cc-c180-43ff-aa70-24e95763bb2e",
  "model": "openai:1@2",
  "positivePrompt": "Create a seamless portrait outpaint of the first reference image for a premium pipe-organ building trade-journal cover. Preserve the artisan from reference image 1 exactly as the central subject: same identity, face, hands, navy apron, pose, voicing tool, organ pipe, bench, documentary realism, lighting direction, color, perspective, and photographic grain. Do not redesign or replace the existing central scene. Expand the canvas substantially above and below to reach a 2:3 portrait composition. Use reference image 2 only to guide the surrounding workshop architecture, materials, pipe storage, tools, and atmosphere. Above the artisan, reveal tall orderly ranks of silver organ pipes rising toward dark timber rafters and a softly glowing high workshop window, with a calm area of low-detail shadow near the upper edge suitable for a magazine masthead. Below, continue the worn oak workbench, apron, drawers, shavings, and a few precise organ-making tools naturally toward the bottom edge. Match all seams, lens perspective, depth of field, scale, north-window illumination, muted walnut brown, oxidized silver, charcoal blue, and dusty cream tones. Quiet, exacting, tactile editorial photography; dignified European craft workshop; realistic metal reflections and aged wood. One finished full-bleed photograph only, no border, no masthead, no typography, no logos, no watermark, no duplicated person, no extra hands.",
  "width": 1024,
  "height": 1536,
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/80f79d00-9fa5-43e0-8f5e-0e92260ec2ff.jpg",
      "https://assets.runware.ai/assets/inputs/421442ab-f3bd-4b41-9d4e-4554738537e2.jpg"
    ]
  }
}
```

---

### inpaint (inpaint)

![Observatory Architecture Square Outpaint](https://assets.runware.ai/examples/openai-gpt-image-1-mini/c5d9b7bc-7919-4a49-aac0-002dac49bc99.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "1baa9431-164f-4f2a-8d4a-50ab96ddcba9",
  "model": "openai:1@2",
  "positivePrompt": "Create a finished square architectural tourism photograph from the supplied observatory image. Remove the entire orange boom lift and reconstruct the white concrete wall, paving, shadows, and subtle surface weathering naturally behind it. Expand the scene laterally into a balanced 1:1 composition, revealing more of the observatory complex on both sides while preserving the original dome, perspective, materials, blue-hour light, and realistic mountain atmosphere. Add restrained peripheral details such as low concrete terraces, dark volcanic gravel, and distant ridgelines beneath a deep cobalt sky. Premium large-format architectural photography, crisp geometry, cool white and blue palette, quiet scientific mood, physically plausible lighting, seamless continuity, no people, no vehicles, no text, no logos.",
  "width": 1024,
  "height": 1024,
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/0d6051e1-5f99-480e-aa18-7200a785638b.jpg"
    ],
    "maskImage": "https://assets.runware.ai/assets/inputs/f0e35714-3fca-4d9b-b1cb-734905cfa24f.png"
  }
}
```

---

### transparent-background (transparent-background)

![Battery Safety Book Character Sticker](https://assets.runware.ai/examples/openai-gpt-image-1-mini/dbf223e8-08dc-4d3f-b72c-e23ed4c28c63.png)

```json
{
  "taskType": "imageInference",
  "taskUUID": "9e097459-850d-4640-abf7-5bf526f7eb67",
  "outputFormat": "PNG",
  "model": "openai:1@2",
  "positivePrompt": "Create one isolated children’s-book character: a friendly spectacled flying fox acting as a battery-safety helper, standing upright and wearing oversized orange insulated gloves and a small aqua utility vest. The bat carefully holds a single AA battery with both terminals visibly covered by neat cream-colored safety tape. Warm, reassuring expression, large expressive ears, clear silhouette, anatomically readable wings folded like arms. Contemporary editorial children’s illustration combining opaque gouache shapes, subtle wax-crayon texture, and crisp screen-printed edges. Limited palette of deep aubergine, safety orange, aqua, and warm cream. Full-body centered composition with generous clear space around the character, suitable as a reusable sticker or spot illustration in an educational activity book. No words, letters, symbols, border, ground plane, cast shadow, scenery, backdrop, frame, or additional objects. Clean transparent surroundings and fully transparent background.",
  "width": 1024,
  "height": 1024,
  "settings": {
    "background": "transparent"
  }
}
```