Image models
GPT Image 2.5
On this page
OpenAI's most capable image model — for work where editing precision matters most, up to 4K.
| modelId | gpt-image-2-5-flare-text-to-image, gpt-image-2-5-flare-image-to-image, gpt-image-2-5-sunburst-text-to-image, gpt-image-2-5-sunburst-image-to-image |
| Modality | image |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Flare | gpt-image-2-5-flare-text-to-image | POST /api/v1/generate | prompt, aspect_ratio |
| Flare Edit | gpt-image-2-5-flare-image-to-image | POST /api/v1/generate | prompt, input_urls, aspect_ratio |
| Sunburst | gpt-image-2-5-sunburst-text-to-image | POST /api/v1/generate | prompt, aspect_ratio |
| Sunburst Edit | gpt-image-2-5-sunburst-image-to-image | POST /api/v1/generate | prompt, input_urls, aspect_ratio |
| Poll task | — | GET /api/v1/task/{id}?model=gpt-image-2-5-sunburst-text-to-image | — |
Flare — gpt-image-2-5-flare-text-to-image
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | Text value |
| aspect_ratio | string | Yes | Options: 1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 16:9 | 9:16 | 21:9 (default: 1:1) |
| resolution | string | No | Options: 1K | 2K | 4K (default: 1K) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"gpt-image-2-5-flare-text-to-image","input":{"prompt":"Create a realistic photo in the style of Asian cinema, featuring a raw, desaturated tone with shades of grey, green, and muted hues.\n\nA middle-aged Asian man with a lean build; his face shows slight wrinkles, and he has messy, unkempt long hair and light stubble. His expression is calm and stoic, yet hints at a dangerous nature.\n\nHe wears a kimono in a muted white with a cherry blossom pattern; the garment underneath features a traditional print and looks worn, showing signs of actual use.\n\nHe holds a katana casually—not in a formal stance—yet his demeanor naturally exudes danger.\n\nA cigarette hangs from his lips, with smoke swirling around him; the smoke is realistic—varying in density—and drifts through the light, adding depth to the image.\n\nThe background is a courtyard with blurred figures that do not distract from the subject; natural light streams in from the side or back.\n\nCamera angle is chest-to-waist level, focusing on the main character with a shallow depth of field, causing the background to blur slightly.\n\nCinematic lighting—natural and ambient rather than staged or flash-based. Soft shadows and muted colors create a movie-scene look rather than a studio photograph.\n\nThe overall mood is cool, composed, tense, and realistic—capturing a fleeting moment of a dangerous individual in the real world. No fantasy elements or special effects.\n\n⸻\n\nNEGATIVE PROMPT (Crucial—use as is)\n\nCGI, 3D render, digital art, illustration, fantasy, anime, cartoon, unreal engine, concept art, studio lighting, beauty lighting, smooth skin, plastic skin, over sharp, over contrast, dramatic fantasy light, glow, magical effect","aspect_ratio":"1:1","resolution":"1K"}}'Flare Edit — gpt-image-2-5-flare-image-to-image
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | Text value |
| input_urls | string[] | Yes | Image URL |
| aspect_ratio | string | Yes | Options: 1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 16:9 | 9:16 | 21:9 (default: 1:1) |
| resolution | string | No | Options: 1K | 2K | 4K (default: 1K) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"gpt-image-2-5-flare-image-to-image","input":{"prompt":"A photorealistic portrait of a red fox in a snowy forest, soft morning light, shallow depth of field, 85mm.","input_urls":["https://you.bot/examples/grok-imagine-text-to-image.jpg"],"aspect_ratio":"1:1","resolution":"1K"}}'Sunburst — gpt-image-2-5-sunburst-text-to-image
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | Text value |
| aspect_ratio | string | Yes | Options: 1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 16:9 | 9:16 | 21:9 (default: 1:1) |
| resolution | string | No | Options: 1K | 2K | 4K (default: 1K) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"gpt-image-2-5-sunburst-text-to-image","input":{"prompt":"This contemporary art masterpiece depicts a mysterious woman standing in a field of glowing flowers at night. She wears a black, art-style outfit that contrasts sharply with the vibrant backdrop. Her face is serene, her eyes deep and piercing, surrounded by neon butterflies and flower petals floating in the air. The backdrop features a gigantic moon in shades of pinkish-orange against an electric blue, deep purple, and turquoise sky, creating a striking color contrast. The composition is balanced, reminiscent of modern poster art, with a clean, uncluttered space.\nDetails of only key specific points; lighting style cinematic glow, vibrant color harmony, bold contrast, surreal dreamscape, luxury art print, iconic composition, elegant negative space, ultra refined brushwork, artistic masterpiece, gallery quality, visually unforgettable, eye-catching from a distance, rich saturation, high-end contemporary art, unique visual identity, premium aesthetic, award-winning artwork, sharp focal point, depth and atmosphere, 8K\n\nNegative Prompt \n\ncluttered composition, excessive details, low contrast, dull colors, oversharpen, bad anatomy, extra fingers, text, watermark, logo, blurry, noisy, flat lighting, cheap CGI, amateur artwork, messy background, overdecorated scene","aspect_ratio":"1:1","resolution":"1K"}}'Sunburst Edit — gpt-image-2-5-sunburst-image-to-image
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | Text value |
| input_urls | string[] | Yes | Image URL |
| aspect_ratio | string | Yes | Options: 1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 16:9 | 9:16 | 21:9 (default: 1:1) |
| resolution | string | No | Options: 1K | 2K | 4K (default: 1K) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"gpt-image-2-5-sunburst-image-to-image","input":{"prompt":"A photorealistic portrait of a red fox in a snowy forest, soft morning light, shallow depth of field, 85mm.","input_urls":["https://you.bot/examples/grok-imagine-text-to-image.jpg"],"aspect_ratio":"1:1","resolution":"1K"}}'