GPT Image 2 Edit API

OpenAI GPT Image 2 image editing — supply 1-8 reference images plus an edit instruction. Optional mask for inpainting. 4K-capable; pricing varies by quality + size. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare image models Use cases

Image Generation

Img2Img

Editing

Credit Cost

5 credits

Type

Image

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/gpt-image-2-edit/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/gpt-image-2-edit.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt` required	string	Edit instruction or composition prompt.	-
`image_urls` required	array	One to eight reference image URLs. Pass a single URL for a basic edit, or multiple URLs to compose / transfer attributes between them. items: url min items: 1 \| max items: 8	-
`mask_url`	string	Optional inpainting mask. PNG with transparent regions marking the area to edit (everything else is preserved). When supplied, the model only modifies pixels inside the masked region.	-
`image_size`	enum	Output dimensions. "auto" lets the model pick based on the input. `auto1024x7681024x10241024x15361920x1080`+2 more	`auto`
`quality`	enum	Generation quality tier. Higher tiers cost more credits. `lowmediumhigh`	`high`
`num_images`	integer	Number of images to generate (1-4). min: 1 \| max: 4	`1`
`output_format`	enum	Output image file format. `jpegpngwebp`	`png`

Example Outputs

Real outputs generated by this model

View Details

her hair is blue

5 credits

166.8s

Code Examples

Edit one image — copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/gpt-image-2-edit/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "give the subject a vintage film grain",
    "image_urls": [
      "https://..."
    ],
    "quality": "high"
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 5,
  "creditsRemaining": 95,
  "expiresAt": "2026-07-15T01:55:02Z"
}

Completed Response