OpenAI's fastest model for high-quality, everyday image generation. Generate images from text or edit existing images with strong instruction following and sharp text rendering โ tuned for high-volume work where speed matters. For the most precise edits, use GPT Image 2.5 Sunburst.
Test this model instantly in the Console Playground โ no code required
Copy usage instructions for Claude, ChatGPT, or other AI
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "openai/gpt-image-2.5-flare",
"input": {
"prompt": "A cozy bookstore cafe interior at golden hour, warm lighting, photorealistic",
"quality": "high",
"aspect_ratio": "3:2"
}
}'| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | - | What you want to generate, or how to edit the input images. Put exact text in "quotes". |
input_images | array | No | - | Reference images for editing or composition. Pass one image to edit it, or several to combine subjects and styles. Processed at high fidelity automatically. |
quality | string | No | auto | Quality tier. Higher tiers take longer and cost more per image: low 28, medium 109, high 298, xhigh 581, max 1,163 credits. auto is billed at the xhigh rate. lowmediumhighxhighmaxauto |
aspect_ratio | string | No | 1:1 | Named ratio, explicit size, or auto to let the model pick. Sizes above 2560x1440 are experimental and may give more variable results. 1:13:22:34:33:416:99:16auto1024x10241536x10241024x15361536x11521152x15362048x20482048x11521152x20483840x21602160x3840 |
number_of_images | integer | No | 1 | Number of images to generate (1-10). Billed per image. |
background | string | No | auto | Background mode. For a transparent background use png or webp output. autotransparentopaque |
output_format | string | No | webp | Output image format pngjpegwebp |
output_compression | integer | No | 90 | Compression level (0-100) for webp/jpeg output |
moderation | string | No | auto | Content moderation level โ low applies less strict filtering autolow |
user_id | string | No | - | An optional unique identifier representing your end-user. This helps OpenAI monitor and detect abuse. |
openai_api_key | string | No | - | Your own OpenAI API key (optional โ leave empty to use the gateway) |
There are 3 ways to provide files for the input_images parameter:
Pass a publicly accessible URL directly. With the Storage API (POST /v1/files/upload-url) the file uploads straight to S3 (50MB per file) and you pass the returned file_url.
{
"model": "openai/gpt-image-2.5-flare",
"input": {
"prompt": "your prompt here",
"input_images": ["https://example.com/image.jpg"]
}
}Attach files directly to POST /v1/predictions/upload. No separate upload step, but the bytes pass through the API server so the whole request is capped at 10MB.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=openai/gpt-image-2.5-flare" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:input_images=@your_file.png"Common parameters used when calling POST /v1/predictions.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Yes | - | Model identifier |
input | object | Yes | - | Object containing the model-specific parameters from the table above |
output_folder | string | No | - | Folder path for output files (max 256 chars, '..' not allowed) |
webhook_url | string | No | - | Webhook URL to call on completion |
is_public | boolean | No | false | If true, output files are also available via permanent public URLs |
Warm, photorealistic scene at the high quality tier
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "openai/gpt-image-2.5-flare",
"input": {
"prompt": "A cozy bookstore cafe interior at golden hour, warm lighting, photorealistic",
"quality": "high",
"aspect_ratio": "3:2"
}
}'Exact copy in quotes plus a typography description
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "openai/gpt-image-2.5-flare",
"input": {
"prompt": "A clean summer sale banner for a coffee brand. Large bold sans-serif headline \"SUMMER COLD BREW\" and smaller text \"20% OFF ยท Aug 1-31\" below, iced coffee glass on a pastel blue background, minimal flat style",
"quality": "high",
"aspect_ratio": "16:9",
"output_format": "png"
}
}'Pass input_images and state what must stay the same
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "openai/gpt-image-2.5-flare",
"input": {
"prompt": "Change only the background to a snowy mountain cabin at dusk. Preserve the person's face, pose, clothing and lighting direction.",
"input_images": [
"https://example.com/your-photo.jpg"
],
"quality": "high"
}
}'Explore 4 variations at the low tier (28 credits each)
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "openai/gpt-image-2.5-flare",
"input": {
"prompt": "Minimal flat logo concept for a bakery named \"Crumb\", warm brown and cream palette",
"quality": "low",
"number_of_images": 4
}
}'POST /v1/predictions