GPT Image 2.5 Flare

POST Base URL: https://api.hiapi.ai /v1/tasks

Copy Page

Image, video, and audio models are called through the Unified Async API POST /v1/tasks endpoint; only the input fields differ (see input parameters below).

Model summary

Model name	gpt-image-2.5-flare
Type	Text-to-image / Image editing
Output	One image per request
Pricing	View current pricing

GPT Image 2.5 Flare supports text-to-image and image editing through one model ID, with up to 16 reference images, six quality settings, and aspect-ratio or pixel-size selection.

Production guidance

Image inputs and outputs

• Omit image_urls for prompt-only generation. Supply image URLs for editing or references, and do not send an empty array.
• Each request generates one image. Download or copy the result to your storage before its temporary URL expires.
• Use PNG or WebP for transparency and describe the subject and background requirements in your prompt.

Best suited for

Product and scene visuals

Describe the subject, material, composition, and lighting to generate a complete image from text.

promptaspect_ratio

Editing and multiple references

Supply subjects or style through reference images and specify what to change and preserve.

promptimage_urls

Request parameters

</> Generate example code

model string required

Select this model.

example gpt-image-2.5-flare

input object required

Image generation or editing parameters.

prompt string required

Describe the image to generate; for edits, specify what to change and preserve. Use 1–32000 characters.

image_urls string[] optional

Image URLs for editing or visual reference. When provided, include 1–16 images. Omit this field for text-to-image; for multiple images, explain each image’s role in array order.

aspect_ratio enum optional

Choose an output aspect ratio or an explicit width-by-height pixel size. auto lets the model choose a suitable composition; pixel sizes use a lowercase x separator.

default 1:1

Aspect ratio presets

1:13:22:34:33:416:99:16auto

Pixel dimensions

1024x10241536x10241024x15361536x11521152x15362048x20482048x11521152x20483840x21602160x3840

quality enum optional

Choose image quality. low, medium, high, xhigh, and max provide different detail levels; auto lets the model decide.

default medium enum: lowmediumhighxhighmaxauto

background enum optional

Background treatment: auto chooses automatically, transparent requests transparency, and opaque requests a nontransparent background.

default auto enum: autotransparentopaque

output_format enum optional

File format for the result. Choose PNG or WebP for transparent backgrounds; JPEG does not support transparency.

default webp enum: pngjpegwebp

callback object optional

Configure a notification when the task finishes.

url string required

HTTPS URL that receives terminal task notifications.

example https://your-domain.com/hiapi/callback

when enum optional

Notify when the task succeeds or fails.

default final enum: final

Example requests

Mediterranean Poolside Creative Studio

Describe a poolside designer, bold print samples, and Mediterranean midday light without a reference image.

Request body⧉

{
  "model": "gpt-image-2.5-flare",
  "input": {
    "prompt": "Create a premium square editorial lifestyle photograph set at a sunlit 1960s Mediterranean poolside creative studio. One stylish young adult designer in an ivory linen shirt and cobalt shorts is arranging bold ultramarine, tangerine, and cream print samples on a white travertine table. Behind them: a cobalt-blue swimming pool, one sculptural orange parasol, a chrome tubular chair, a compact analog camera, and a few geometric paper mockups lifting slightly in a warm sea breeze. Crisp midday sunlight, elegant hard-edged shadows, natural skin, tactile paper and linen, subtle film grain, refined Italian resort color palette, sophisticated magazine art direction, balanced negative space, photorealistic, no cyberpunk, no neon, no logos, no watermark, no readable text.",
    "aspect_ratio": "1:1",
    "quality": "high",
    "background": "opaque",
    "output_format": "webp"
  }
}

Poolside Parasol Color Edit

Replace the example URL with your poolside image, change only the parasol color, and preserve the designer, print samples, and lighting.

Request body⧉

{
  "model": "gpt-image-2.5-flare",
  "input": {
    "prompt": "Change only the orange parasol fabric to warm cream in this Mediterranean poolside creative studio. Preserve the designer, print samples, swimming pool, chair, camera, paper mockups, table, sunlight, shadows, and framing. Do not add text, logos, or other objects.",
    "image_urls": [
      "https://example.com/reference.webp"
    ],
    "aspect_ratio": "1:1",
    "quality": "high",
    "background": "opaque",
    "output_format": "webp"
  }
}

Getting the result

1. Submission returns a taskId while the image is generated asynchronously.
2. Poll GET /v1/tasks/:id or wait for the terminal notification at callback.url.
3. When status=success, save the image from data.output[].url before expireAt.
4. When status=fail, inspect data.error and correct the request before deciding whether to submit again.

FAQ

Do generation and editing use different model IDs?

No. Use the model ID on this page. Omit image_urls for text-to-image, or provide images for editing or visual reference.

How should I organize multiple references?

Describe each image’s role in image_urls order, such as the first for the product and the second for the scene, and specify which elements should remain unchanged.

How do I choose dimensions?

Choose an aspect ratio for common layouts, or select an explicit pixel size from the width-by-height values listed under aspect_ratio. Other custom dimensions are not accepted.

Do I need a separate API key for each model?

Use an API key created in your HiAPI dashboard and send it as a Bearer token. Keep the key on your server.

Next steps

• Get an API key
• View current pricing
• GPT Image 2.5 Sunburst