response_format and offering a lower price point. Unlike the official gpt-image-2, it does not support the n parameter (one image per request).
Key capabilities
- Text-to-Image — Generate images from natural language descriptions
- Image editing — Edit an existing image with a text prompt via
/v1/images/edits - Flexible resolution — Any custom size up to 4K (3840px), edges must be multiples of 16
- Near-perfect text rendering — ~99% character-level accuracy across 12+ languages
response_formatsupport — Return generated/edited images as a pre-signedurlor base64 (b64_json)- Cost-effective — A lower-cost alternative to
gpt-image-2
gpt-image-2-cdoes not support thenparameter — each request returns a single image. For multi-image output (n), usegpt-image-2.
Output specifications
| Property | Value |
|---|---|
| Sizes | Flexible resolution (e.g. 1024x1024, 2048x2048, 3840x2160) |
| Size constraints | Edges: multiples of 16, aspect ratio ≤ 3:1, total pixels 655,360–8,294,400 |
| Quality | low, medium, high |
| Output formats | png, jpeg |
| Input formats (edits) | png, jpeg |
Quick example
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Must be gpt-image-2-c |
prompt | string | Yes | Text description of the desired image |
size | string | No | {width}x{height} format. Edges must be multiples of 16, aspect ratio ≤ 3:1, total pixels 655,360–8,294,400, max edge 3,840px. Default: 1024x1024 |
quality | string | No | low, medium, high. Default: medium |
output_format | string | No | png, jpeg. Default: png |
moderation | string | No | auto or low. Default: auto |
output_compression | integer | No | Compression level for jpeg (0–100). |
response_format | string | No | url, b64_json. Default: url |
gpt-image-2-c does not support the n parameter. To generate multiple images in one request, use gpt-image-2.Image editing
Edit an existing image with a text prompt viaPOST /v1/images/edits. Use multipart/form-data and pass images as file uploads.
Supports up to 16 input images per request (image[]).
Input image formats
Supported formats: PNG, JPEG. Images must be provided as multipart/form-data file uploads.Edit parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
image | file | Yes | Single source image (PNG or JPEG, multipart upload) |
image[] | file array | Yes* | Multiple source images — up to 16 images (PNG or JPEG). Use instead of image for multi-image input |
mask | file | No | Mask image with an alpha channel. Same format and size as source (< 50MB). Applied to the first image when multiple images are provided. Requires selecting the Direct group. |
model | string | Yes | Must be gpt-image-2-c |
prompt | string | Yes | Edit instruction text |
size | string | No | {width}x{height}. Default: 1024x1024 |
output_format | string | No | png, jpeg. Default: png |
output_compression | integer | No | Compression level for jpeg (0–100) |
response_format | string | No | url, b64_json. Default: url |
Use eitherimage(single file) orimage[](array) — not both.
Mask editing
Provide a mask image with an alpha channel to control which areas of the source image to edit. Pixels with white (opaque) alpha are preserved; pixels with black (transparent) alpha are edited. Requirements:- The mask must contain an Alpha channel
- Must be the same image format and same dimensions as the source image
- File size limit: < 50MB
Mask editing requires selecting the Direct group in the console.
cURL
Python
Generate API Reference
Interactive playground for
POST /v1/images/generations.Edit API Reference
Interactive playground for
POST /v1/images/edits.