GPT Image 1 Mini Edit

Name: OpenAI GPT Image 1 Mini Edit
Price: 0.038 USD
Availability: InStock
Author: OpenAI

openai/gpt-image-1-mini/edit

Gpt Image 1 Mini Edit is OpenAI's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Try the model

Playground

Open playground

Input

Prompt(string)

The prompt for image generation

Additional Settings More

Customize your input with more control.

Image URLs(array)

Upload

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

The URLs of the images to use as a reference for the generation.

Output Format(string)

Output format for the images Allowed values: jpeg, png.

Background(string)

Background for the generated image Allowed values: auto, transparent, opaque.

Quality(string)

Quality for the generated image Allowed values: auto, low, medium, high.

Aspect Ratio(string)

Output aspect ratio: 1:1 (1024x1024), 3:2 (1536x1024) or 2:3 (1024x1536). Allowed values: 1:1, 3:2, 2:3.

Result

Example

What would you like to do next?
Open original

Examples

Select an example to load its inputs and result into the playground.

Input

{
  "aspect_ratio": "1:1",
  "images": [
    "https://static.sandbase.ai/examples/e4b5996b-021e-4360-bd2f-959dbdf45f4b/input/5c513255-9c78-4e10-a29a-358eb27f85e4.jpg"
  ],
  "prompt": "make it watercolor",
  "quality": "low"
}

Open result ↗

Input
```
{
  "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building."
}
```
Open result ↗

Human preference

Arena

Elo ratings from blind side-by-side votes, compared with other image and video models.

Rankings sourced from Artificial Analysis Arena

Leaderboard: Image Editing
Rank: #64 of 77
Elo: 934 ±19
Gap to #1: −265

Image-editing arena: people pick the better of two edits of the same image and instruction, without seeing the model names.

#59HiDream-O1-ImageHiDream954±14
#60Kling Image 3.0 OmniKlingAIOn SandBase952±14
#61Vidu Q2Vidu951±18
#62Kling Image O1KlingAI944±14
#63FLUX.2 [klein] 4BBlack Forest LabsOn SandBase938±17
#64GPT Image 1 Mini (medium)OpenAIThis model934±19
#65FLUX.1 Kontext [max]Black Forest Labs932±19
#66FLUX.1 Kontext [pro]Black Forest Labs916±19
#67FIBO EditBria915±19
#68SeedEdit 3.0ByteDance Seed901±20

GPT Image 1 Mini Edit

GPT Image 1 Mini edit: the low-cost GPT Image tier for quick edits and background swaps.

Fields

Field	Type	Default	Notes
`prompt`	string, required	—	Text instruction.
`images`	image URL[]	—	Images to edit, Image 1, Image 2, …
`output_format`	`jpeg` / `png`	`png`	Output file format.
`background`	`auto` / `transparent` / `opaque`	`auto`	`transparent` returns a PNG with alpha.
`quality`	`auto` / `low` / `medium` / `high`	`auto`	`auto` lets the model pick; billed as high.
`aspect_ratio`	`1:1` / `3:2` / `2:3`	`1:1`	1:1, 3:2, or 2:3; non-square sizes cost more.

Billing

Price depends on quality and shape, plus $0.002 per started 1,000 prompt characters:

Quality, short prompt	1:1	3:2 or 2:3
low	$0.007	$0.008
medium	$0.013	$0.017
high	$0.038	$0.054

Failed runs are not charged.

Prompting

State the change and what must stay the same.

Limits

Three shapes only: 1:1, 3:2, 2:3.

Also on SandBase

Related: openai/gpt-image-2/edit (higher quality).

Start building

Send your first request

Submit this model through the SandBase Unified Run API.

Production API

Unified Run API endpoint

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

Model ID

openai/gpt-image-1-mini/edit

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "openai/gpt-image-1-mini/edit",
  "images": [
    "https://static.sandbase.ai/examples/openai/gpt-image-1-mini/edit/input_images_0.png",
    "https://static.sandbase.ai/examples/openai/gpt-image-1-mini/edit/input_images_1.png",
    "https://static.sandbase.ai/examples/openai/gpt-image-1-mini/edit/input_images_2.png",
    "https://static.sandbase.ai/examples/openai/gpt-image-1-mini/edit/input_images_3.png"
  ],
  "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
  "quality": "auto",
  "background": "auto",
  "aspect_ratio": "1:1",
  "output_format": "png"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

2. Authentication

Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.

API key environment variable

export SANDBASE_API_KEY="YOUR_API_KEY"

Keep the key on your server. Do not expose it in browser code or commit it to a repository.

3. Queue

Submit a request

POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.

Fetch request status and result

Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.

Poll run status

curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

4. Files

Hosted files

Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.

Uploading images

Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.

5. Schema

Input

`images`array

The URLs of the images to use as a reference for the generation.

`prompt`stringrequired

The prompt for image generation

`quality`string

Quality for the generated image

Default: "auto"

Possible values: "auto", "low", "medium", "high"

`background`string

Background for the generated image

Default: "auto"

Possible values: "auto", "transparent", "opaque"

`aspect_ratio`string

Output aspect ratio: 1:1 (1024x1024), 3:2 (1536x1024) or 2:3 (1024x1536).

Default: "1:1"

Possible values: "1:1", "3:2", "2:3"

`output_format`string

Output format for the images

Default: "png"

Possible values: "jpeg", "png"

Request body

{
  "model": "openai/gpt-image-1-mini/edit",
  "images": [
    "https://static.sandbase.ai/examples/openai/gpt-image-1-mini/edit/input_images_0.png",
    "https://static.sandbase.ai/examples/openai/gpt-image-1-mini/edit/input_images_1.png",
    "https://static.sandbase.ai/examples/openai/gpt-image-1-mini/edit/input_images_2.png",
    "https://static.sandbase.ai/examples/openai/gpt-image-1-mini/edit/input_images_3.png"
  ],
  "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
  "quality": "auto",
  "background": "auto",
  "aspect_ratio": "1:1",
  "output_format": "png"
}

Output

A completed run exposes its result in output. The following is the model’s saved example, not a new generation.

Example output JSON

[
  {
    "source": "Self organization completed prediction",
    "source_url": "https://www.sandbase.ai",
    "url": "https://static.sandbase.ai/examples/e4b5996b-021e-4360-bd2f-959dbdf45f4b/output/bac76e9d-c669-4acc-acf0-6499e3e7a2f3.png"
  }
]

GPT Image 1 Mini Edit

Playground

Examples

Arena

GPT Image 1 Mini Edit

Fields

Billing

Prompting

Limits

Also on SandBase

Send your first request

2. Authentication

3. Queue

Submit a request

Fetch request status and result

4. Files

Hosted files

Uploading images

5. Schema

Input

imagesarray

promptstringrequired

qualitystring

backgroundstring

aspect_ratiostring

output_formatstring

Output

GPT Image 1.5 Edit ↗

GPT Image 2.5 Flare Edit ↗

GPT Image 2.5 Sunburst Edit ↗

GPT Image 2 Edit ↗

GPT Image 1.5 Text to Image ↗

GPT Image 2 Text to Image ↗

`images`array

`prompt`stringrequired

`quality`string

`background`string

`aspect_ratio`string

`output_format`string