# GPT Image 1 Mini

> OpenAI's cost-effective image generation model for when image quality isn't the top priority

## Quick Reference

- Model ID: gpt-image-1-mini
- Creator: OpenAI
- Status: active
- Family: gpt-image
- Base URL: https://api.lumenfall.ai/openai/v1

## Specifications

- Max Resolution: 1536x1536
- Max Output Images: 1
- Max Input Images: 10
- Input Modalities: text, image
- Output Modalities: image
- Supported Modes: Text to Image, Image Edit

## API Parameters

The compiled parameter schema for this model is available via the API: `GET /v1/models/gpt-image-1-mini?schema=true`.

### Core Parameters

- `prompt` (string) — REQUIRED: Text prompt for image generation. Modes: Text to Image, Image Edit
- `quality` (string): Image quality level. Values: high, low, medium. Modes: Text to Image

### Size & Layout

- `size` (string): Image dimensions as WxH pixels (e.g. "1024x1024") or aspect ratio (e.g. "16:9"). Values: 1024x1024, 1536x1024, 1024x1536. Modes: Text to Image, Image Edit
- `aspect_ratio` (string): Aspect ratio of the output image (e.g. "16:9", "1:1"). Values: 2:3, 1:1, 3:2. Modes: Text to Image, Image Edit
- `resolution` (string): Output resolution tier (e.g. "1K", "4K"). Values: 1K. Modes: Text to Image, Image Edit

### Media Inputs

- `image` (file) — REQUIRED: Input image(s) to edit. Modes: Image Edit

### Output & Format

- `response_format` (string): How to return the image. Default: url. Values: url, b64_json. Modes: Text to Image, Image Edit
- `output_format` (string): Output image format. Values: png, jpeg, gif, webp, avif. Modes: Text to Image, Image Edit
- `output_compression` (integer): Compression level for lossy formats (JPEG, WebP, AVIF). Modes: Text to Image, Image Edit
- `n` (integer): Number of images to generate. Default: 1. Modes: Text to Image, Image Edit

### Additional Parameters

- `background` (string): Background for the generated image. Values: opaque, transparent. Modes: Text to Image, Image Edit
- `moderation` (string): Content moderation strictness for GPT image models.. Values: low. Modes: Text to Image, Image Edit. Only available via openai
- `sync_mode` (boolean): If `True`, the media will be returned as a data URI and the output data won't be available in the request history.. Modes: Text to Image, Image Edit. Only available via fal
- `user` (string): Stable end-user identifier used by OpenAI abuse monitoring.. Modes: Text to Image, Image Edit. Only available via openai


## Model Identifiers

- Primary Slug: gpt-image-1-mini

## Dates

- Released: October 2025

## Tags

image-generation, text-to-image, image-editing

## Available Providers

### fal.ai

- Config Key: fal/gpt-image-1-mini
- Provider Model ID: fal-ai/gpt-image-1-mini
- Pricing: $0.020/image
  - Source: https://fal.ai/models/fal-ai/gpt-image-1-mini

### fal.ai

- Config Key: fal/gpt-image-1-mini-edit
- Provider Model ID: fal-ai/gpt-image-1-mini/edit
- Pricing: $0.020/image
  - Source: https://fal.ai/models/fal-ai/gpt-image-1-mini

### OpenAI

- Config Key: openai/gpt-image-1-mini
- Provider Model ID: gpt-image-1-mini
- Pricing: $2.00/M input tokens, $0.200/M input tokens, $2.50/M input tokens (image), $0.250/M input tokens (image), $8.00/M output tokens (image), $0.0050/image, $0.0060/image, $0.0060/image, $0.011/image, $0.015/image, $0.015/image, $0.036/image, $0.052/image, $0.052/image
  - Note: Pricing available in both token-based and per-image formats
  - Note: Per-image prices vary by quality (low/medium/high) and size
  - Note: Cost-effective option when image quality isn't the top priority
  - Source: https://platform.openai.com/docs/pricing


## Performance Metrics

Provider performance over the last 30 days.

### openai

- Median Generation Time (p50): 21516ms
- 95th Percentile Generation Time (p95): 43317ms
- Average Generation Time: 26625ms
- Success Rate: 51.7%
- Total Requests: 29
- Time to First Byte (p50): 20098ms
- Time to First Byte (p95): 37303ms

### fal

- Median Generation Time (p50): 30444ms
- 95th Percentile Generation Time (p95): 53296ms
- Average Generation Time: 32951ms
- Success Rate: 100.0%
- Total Requests: 14
- Time to First Byte (p50): 25812ms
- Time to First Byte (p95): 46449ms


## Arena Benchmarks

### Candid Street Photography

- Elo: 1251
- Record: 14W / 9L / 0T (23 battles)
- Rank: #2 of 68

### Geometric Composition

- Elo: 1240
- Record: 7W / 19L / 6T (32 battles)
- Rank: #6 of 70

### Adorable Baby Animals in Sunny Meadow

- Elo: 1201
- Record: 11W / 5L / 1T (17 battles)
- Rank: #15 of 72

### Pose & Character Mashup

- Elo: 1199
- Record: 6W / 2L / 0T (8 battles)
- Rank: #3 of 33

### Fantasy Warrior

- Elo: 1194
- Record: 21W / 15L / 1T (37 battles)
- Rank: #16 of 71

### Chalkboard Menu

- Elo: 1151
- Record: 3W / 3L / 0T (6 battles)
- Rank: #12 of 69

### The Capybara Taxi Driver

- Elo: 1141
- Record: 3W / 2L / 1T (6 battles)
- Rank: #14 of 69

### Outfit Transfer Challenge

- Elo: 1082
- Record: 3W / 1L / 1T (5 battles)
- Rank: #9 of 33

### Fantasy Warrior

- Elo: 1069
- Record: 2W / 3L / 0T (5 battles)
- Rank: #9 of 14


## Use Cases & Category Performance

### Photorealism (Text-to-Image)

- Rank: #14 of 62
- Elo: 1210
- Record: 61W / 56L / 9T (126 battles)
- Win Rate: 48.4%

### Aesthetics (Text-to-Image)

- Rank: #14 of 62
- Elo: 1244
- Record: 61W / 53L / 9T (123 battles)
- Win Rate: 49.6%

### Prompt Adherence (Image Editing)

- Rank: #8 of 24
- Elo: 1209
- Record: 10W / 3L / 1T (14 battles)
- Win Rate: 71.4%

### 3D Imaging & Modeling (Text-to-Image)

- Rank: #14 of 45
- Elo: 1219
- Record: 7W / 19L / 6T (32 battles)
- Win Rate: 21.9%

### Creativity (Text-to-Image)

- Rank: #19 of 62
- Elo: 1222
- Record: 27W / 18L / 1T (46 battles)
- Win Rate: 58.7%

### Preservation (Image Editing)

- Rank: #11 of 33
- Elo: 1207
- Record: 12W / 5L / 1T (18 battles)
- Win Rate: 66.7%

### Prompt Adherence (Text-to-Image)

- Rank: #21 of 61
- Elo: 1230
- Record: 25W / 29L / 8T (62 battles)
- Win Rate: 40.3%

### People & Poses (Image Editing)

- Rank: #8 of 18
- Elo: 1204
- Record: 6W / 2L / 0T (8 battles)
- Win Rate: 75.0%

### Portraits (Text-to-Image)

- Rank: #13 of 29
- Elo: 1206
- Record: 23W / 18L / 1T (42 battles)
- Win Rate: 54.8%

### Cartoon, Anime & Fantasy (Text-to-Image)

- Rank: #13 of 29
- Elo: 1206
- Record: 23W / 18L / 1T (42 battles)
- Win Rate: 54.8%

### Product, Branding & Commercial (Text-to-Image)

- Rank: #31 of 61
- Elo: 1200
- Record: 7W / 3L / 0T (10 battles)
- Win Rate: 70.0%

### Text Rendering (Text-to-Image)

- Rank: #35 of 61
- Elo: 1193
- Record: 7W / 3L / 0T (10 battles)
- Win Rate: 70.0%

### Lighting, Shadows & Materials (Image Editing)

- Rank: #18 of 30
- Elo: 1207
- Record: 10W / 5L / 1T (16 battles)
- Win Rate: 62.5%

### Photorealism (Image Editing)

- Rank: #23 of 28
- Elo: 1138
- Record: 4W / 3L / 1T (8 battles)
- Win Rate: 50.0%

### Adding & Editing Objects (Image Editing)

- Rank: #18 of 19
- Elo: 1106
- Record: 3W / 3L / 1T (7 battles)
- Win Rate: 42.9%


## Image Gallery

11 images available for this model. Browse all at https://lumenfall.ai/models/openai/gpt-image-1-mini/gallery

### Curated Examples

- [A wide, cinematic shot of a sophisticated, high-end perfume boutique during the golden hour. In t...](https://assets.lumenfall.ai/j4-PZ3uLADfpUW5sXJkY-yyqdOG_txS3Oaby6bwONbg/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/dgttn3m3eb56ttd9m72cjri9y6br@jpeg)
- [A cozy indie bookstore storefront with a large glass window displaying a gold leaf sign that says...](https://assets.lumenfall.ai/fpdEKFeqSU9axwakwb3idCbj8GlKq0LtC6HaIBTtP8E/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/ap84u74io5h5qjt0bpdl6i8kk3gj@jpeg)

### Arena Competition Results

- [Candid Street Photography](https://assets.lumenfall.ai/jgiRTWUNRVtcxfkXmC7xM9Vy8IiLAvnEddexHdNVXYw/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/0uepwb07c6pv9ppwlf8kuh8jijd9@jpeg): #2 of 68 (Elo 1251)
- [Geometric Composition](https://assets.lumenfall.ai/w-w7XzFXWaqh638vGleoEz_1qi7K-_rj9McazhwlfvA/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/mogmeifj4dsqdqdcr2szm4dmxldm@jpeg): #6 of 70 (Elo 1240)
- [Adorable Baby Animals in Sunny Meadow](https://assets.lumenfall.ai/LGAn1ZpAL2mZQvMErkcpg3A1CwMB5gAEA6nCz99pPXA/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/w0tvmj8acd6tunlkvy4j7hdsh0z6@jpeg): #15 of 72 (Elo 1201)
- [Pose & Character Mashup](https://assets.lumenfall.ai/fQ6dwSy6ZHY5ZPDbEYmHjpItelWPZkDI7PSYfinhp3o/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/ntqr7a5olwykx06z1tgyq5u6xpu1@jpeg): #3 of 33 (Elo 1199)
- [Fantasy Warrior](https://assets.lumenfall.ai/5YRj-8jZeJ5rdtCtvf0VY1Ss89cNiPOjo51-G05l7sQ/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/tsuz5v57lhwu2fa8j49uuib9y0kz@jpeg): #16 of 71 (Elo 1194)
- [Chalkboard Menu](https://assets.lumenfall.ai/52h2AmUOU6zg6XhqIxFo-7Alq1uRzC9uaSxvo5-Jk7A/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/j3usxm6o6anf8m6xr8rkrkrvl5u4@jpeg): #12 of 69 (Elo 1151)
- [The Capybara Taxi Driver](https://assets.lumenfall.ai/nGS6t8gxUKG9vCIy_N_r331z4uJVfNm86Zl0edC7e5I/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/cntj7twocf1okal5gzjsw8htg3c3@jpeg): #14 of 69 (Elo 1141)
- [Outfit Transfer Challenge](https://assets.lumenfall.ai/TZQhY-qptqDWVi-1uQDu44SL8Bxa879p6wJXk1yw8Bo/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/bqs8swefxyt918sqis035k1rlj95@jpeg): #9 of 33 (Elo 1082)
- [Fantasy Warrior](https://assets.lumenfall.ai/wI-NCaekZ5EIkvu8zDOSMOnRJoXo9_tLyWsB19MGb3E/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/28hig5qqsz3kqj4nxekweood6zri@jpeg): #9 of 14 (Elo 1069)

## Example Prompt

The following prompt was used to generate an example image in our playground:

A cozy indie bookstore storefront with a large glass window displaying a gold leaf sign that says "CHAPTER ONE". Inside the warm shop, a capybara is taking a nap on a rug near a bookshelf. High quality, cinematic lighting, 1:1 format.

## Code Examples

### Text to Image (/v1/images/generations)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1-mini",
    "prompt": "",
    "size": "1024x1024"
  }'

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.generate({
  model: 'gpt-image-1-mini',
  prompt: '',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.generate(
    model="gpt-image-1-mini",
    prompt="",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)

### Image Edit (/v1/images/edits)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/edits \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -F "model=gpt-image-1-mini" \
  -F "image=@source.png" \
  -F "prompt=Add a starry night sky to this image" \
  -F "size=1024x1024"

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.edit({
  model: 'gpt-image-1-mini',
  image: fs.createReadStream('source.png'),
  prompt: 'Add a starry night sky to this image',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.edit(
    model="gpt-image-1-mini",
    image=open("source.png", "rb"),
    prompt="Add a starry night sky to this image",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)


## About

## Overview
GPT Image 1 Mini is a lightweight image generation model developed by OpenAI, designed specifically for efficiency and high-speed throughput. It serves as a cost-effective alternative to larger, high-fidelity diffusion models, prioritizing rapid iteration and lower compute costs over photorealistic detail. The model belongs to the gpt-image family and supports both text-to-image generation and image-to-image editing tasks.

## Strengths
*   **Cost Efficiency:** With a starting price of $0.005 per generation, it is significantly more economical than flagship models for large-scale batch processing.
*   **Latency:** Optimized for speed, making it suitable for real-time applications where users expect near-instant visual feedback.
*   **Resource Management:** Minimal computational footprint allows for high-concurrency deployments without the overhead associated with larger generative models.
*   **Functional Prototyping:** Highly effective for generating placeholders, UI wireframes, or conceptual layouts where semantic accuracy is more important than visual texture or finish.

## Limitations
*   **Lower Aesthetic Fidelity:** The model is not designed for photorealism or high-definition artistic output; users may notice artifacts or lower detail in complex textures.
*   **Limited Fine Detail:** Struggles with intricate spatial relationships or the precise rendering of small, complex elements like human hands or background text.
*   **Reduced Stylistic Range:** While it follows prompts reliably, it lacks the creative breadth and nuanced stylistic mimicry found in its more robust counterparts.

## Technical Background
GPT Image 1 Mini utilizes a streamlined architecture within the OpenAI gpt-image lineage, likely employing a distilled version of larger diffusion or transformer-based generative frameworks. The training approach focuses on maximizing the ratio of prompt alignment to parameter count, allowing the model to interpret user intent accurately while reducing the floating-point operations required for each inference. This efficiency is achieved through architectural pruning and optimized sampling techniques.

## Best For
This model is ideal for developers building internal tools, automated placeholder generators, or rapid ideation features where "good enough" quality is sufficient. It is particularly effective for generating icons, simple vector-style graphics, or testing prompt engineering workflows at scale. 

GPT Image 1 Mini is available through Lumenfall’s unified API and playground, allowing you to integrate it into your pipeline alongside other generative models via a single interface.

## Frequently Asked Questions

### How much does GPT Image 1 Mini cost?

GPT Image 1 Mini starts at $0.005 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.

### How do I use GPT Image 1 Mini via API?

You can use GPT Image 1 Mini through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "gpt-image-1-mini". Code examples are available in Python, JavaScript, and cURL.

### Which providers offer GPT Image 1 Mini?

GPT Image 1 Mini is available through fal.ai and OpenAI on Lumenfall. Lumenfall automatically routes requests to the best available provider.

### What is the maximum resolution for GPT Image 1 Mini?

GPT Image 1 Mini supports images up to 1536x1536 resolution.

## Links

- Model Page: https://lumenfall.ai/models/openai/gpt-image-1-mini
- About: https://lumenfall.ai/models/openai/gpt-image-1-mini/about
- Providers, Pricing & Performance: https://lumenfall.ai/models/openai/gpt-image-1-mini/providers
- API Reference: https://lumenfall.ai/models/openai/gpt-image-1-mini/api
- Benchmarks: https://lumenfall.ai/models/openai/gpt-image-1-mini/benchmarks
- Use Cases: https://lumenfall.ai/models/openai/gpt-image-1-mini/use-cases
- Gallery: https://lumenfall.ai/models/openai/gpt-image-1-mini/gallery
- Playground: https://lumenfall.ai/models/openai/gpt-image-1-mini/playground
- API Documentation: https://docs.lumenfall.ai