Source: https://ailoot.ai/models/en/gpt-image-2-5-flare/
Canonical: https://ailoot.ai/models/en/gpt-image-2-5-flare/
Language: en

# OpenAI: GPT Image 2.5 Flare

[Markdown](https://ailoot.ai/models/en/gpt-image-2-5-flare/index.md) · [JSON](https://ailoot.ai/models/en/gpt-image-2-5-flare/facts.json)

## [OpenAI: GPT Image 2.5 Flare](https://ailoot.ai/models/en/gpt-image-2-5-flare/)

GPT Image 2.5 Flare generates and edits images from text and references, with a focus on fast everyday visual creation. It supports custom sizes, transparent backgrounds, masks and quality levels up to max for drafts, illustrations and campaign assets.

- [**Ailoot · Images** `POST /v1/images/generations` `gpt-image-2.5-flare`](https://ailoot.ai/models/en/gpt-image-2-5-flare/#method-0)
- [**Ailoot Ultra · Images** `POST /v1/images/generations` `gpt-image-2.5-flare`](https://ailoot.ai/models/en/gpt-image-2-5-flare/#method-1)
- [**Ailoot Ultra · Images** `POST /v1/images/generations` `openai/gpt-image-2.5-flare`](https://ailoot.ai/models/en/gpt-image-2-5-flare/#method-2)

About the model

This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.

GPT Image 2.5 Flare is OpenAI’s image-generation and editing edition positioned for fast, high-quality everyday work. It accepts text and images and returns image results. Use it for visual drafts, illustrations, product concepts and recurring creative tasks where a brief needs to become a usable image promptly. Flare is separate from Sunburst, whose positioning emphasises editing precision. Choose Flare for routine image creation and Sunburst when precise editing is the priority.

Start with the main subject, action, environment, composition and visual treatment. For a campaign illustration, request a cyclist crossing a small bridge in warm evening light, with a bold silhouette and open sky for later text. A concise exploration brief can leave aesthetic decisions open; a production brief should name the details and placement that matter. The direct generation and editing workflows allow prompts up to 32,000 characters and one to ten results, making it useful to compare a few variations against the same purpose.

Editing can supply up to sixteen reference images. Assign each reference a clear role rather than expecting the model to decide whether an image represents subject identity, scenery or style. A mask can guide a change to a region; with multiple images it applies to the first. The image and mask need matching format and dimensions, and the mask must contain an alpha channel. The guide requires the source and mask to be below 50 MB. A mask is guidance rather than a promise of exact boundary preservation, so state both the desired modification and what should remain recognisable.

Flare supports low, medium, high, xhigh, max and automatic quality, with auto as the default. Lower quality can serve a quick visual draft; higher settings can be compared for a final asset’s detail. Quality is independent of size and output compression. Standard sizes include 1024 × 1024, 1536 × 1024 and 1024 × 1536, with automatic or custom dimensions also available. Choose the orientation around the final placement and the scene’s useful space.

Custom width and height must be multiples of sixteen, with neither edge above 3840 pixels. The allowed ratio runs from 1:3 to 3:1, and total area must be at least 655,360 and at most 8,294,400 pixels. All four conditions apply together. The guide identifies resolutions above 2560 × 1440 as experimental. Use a valid frame that suits the composition, and include any crop-sensitive details in the brief rather than treating a larger resolution as an automatic layout improvement.

The result format is PNG by default, with JPEG and WebP alternatives. JPEG and WebP allow compression from 0 to 100. For a transparent background, select PNG or WebP; opaque and automatic backgrounds are also supported. A transparent asset can be placed into a later layout, while an opaque image includes its own backdrop. Select format, background and compression according to the actual delivery need, and keep the completed file with the brief and chosen settings.

The producer documents direct image generation and edits, plus a conversational image tool that can retain selected results for follow-up changes. In that workflow, action can be automatic, forced generation or forced editing when an image is in context. Streaming can show up to three partial images before the final result. Those previews provide progress rather than additional finished deliverables. For iterative work, continue from the chosen image and describe a visible change, such as moving one object or adjusting the colour treatment. The manufacturer interface also supports batch processing.

Inspect the image’s lettering, object placement, subject details and composition at the intended size. GPT Image can still struggle with exact text placement, structured layouts and repeated visual identity across generations. Keep an accepted variation as the next reference and narrow the following edit to the issue that matters. Flare’s everyday-generation role is useful for a clear sequence of brief, visual alternatives, selection and refinement, with the final asset judged against the actual creative purpose.

**Ailoot · Images** `POST /v1/images/generations` `gpt-image-2.5-flare`

[`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Core&caller=gpt-image-2.5-flare&fmt=images)

OpenAI /`gpt-image-2.5-flare`

### Overview

GPT Image 2.5 Flare generates and edits images from text and references, with a focus on fast everyday visual creation. It supports custom sizes, transparent backgrounds, masks and quality levels up to max for drafts, illustrations and campaign assets.

Accepted inputs

Text

Results

Images

### Available in Ailoot · inputs & methods

**Ailoot · Images** `POST /v1/images/generations`

Input types

`text`

Output types

`image`

Output format

Image file

| Field | Type | Requirement | Values & limits | Default |
| --- | --- | --- | --- | --- |
| Field`model` | Type`string` | RequirementRequired | Values & limits gpt-image-2.5-flare | Default— |
| Field`prompt` | Type`string` | RequirementRequired | Values & limits Minimum length: 1 | Default— |
| Field`n` | Type`integer` | RequirementOptional | Values & limits Minimum: 1 | Default1 |
| Field`response_format` | Type`string` | RequirementOptional | Values & limits url, b64\_json | Default— |
| Field`stream` | Type`boolean` | RequirementOptional | Values & limits | Defaultfalse |
| Field`size` | Type`string` | RequirementOptional | Values & limits Model-specific | Default— |
| Field`quality` | Type`string` | RequirementOptional | Values & limits Model-specific | Default— |
| Field`background` | Type`string` | RequirementOptional | Values & limits Model-specific | Default— |
| Field`output_format` | Type`string` | RequirementOptional | Values & limits Model-specific | Default— |
| Field`output_compression` | Type`integer` | RequirementOptional | Values & limits Model-specific | Default— |
| Field`moderation` | Type`string` | RequirementOptional | Values & limits Model-specific | Default— |
| Field`input_fidelity` | Type`string` | RequirementOptional | Values & limits Model-specific | Default— |
| Field`style` | Type`string` | RequirementOptional | Values & limits Model-specific | Default— |
| Field`partial_images` | Type`integer` | RequirementOptional | Values & limits Model-specific | Default— |

Input material combinations

**Text to image** · Required: prompt

Method parameters and lifecycle

| Parameter | Contract |
| --- | --- |
| Parameter`material_types` | Contracttext |
| Parameter`required` | Contractmodel, prompt |
| Parameter`optional_controls` | Contractnull |
| Parameter`content_type` | Contractapplication/json |

Lifecycle: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · actual returned task\_id or media library record

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

Method shapes and IDs are exact; supplier capability is separate from admission.

### Pricing

#### Ailoot method rates

Text input

$0.005 */ 1K*

Image input

$0.008 */ 1K tokens*

Image output

$0.03 */ 1K tokens*

Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. [How reservation and settlement work →](https://ailoot.ai/docs/en/billing/reserve/)

### Example requests

#### Ailoot · Images

curlPython SDKNode.js SDK

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
export AILOOT_API_KEY
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "gpt-image-2.5-flare", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
```

```python
from openai import OpenAI
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")

f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")
request={'model': 'gpt-image-2.5-flare', 'prompt': ''}
request["prompt"]=f.read_text(encoding="utf-8")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.images.generate(**request)
Path("sdk-result.txt").write_text(str(result),encoding="utf-8")
save_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])
```

```js
import OpenAI from "openai";
import { readFileSync, writeFileSync } from "node:fs";
const key=process.env.AILOOT_API_KEY;
if(!key) throw new Error("Set your actual Ailoot API key");
const client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});
const request={"model": "gpt-image-2.5-flare", "prompt": ""};
if(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");
request.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");
const result=await client.images.generate(request);
writeFileSync("sdk-result.json",JSON.stringify(result,null,2));
if(!result.data?.length) throw new Error("No completed images");
for(let index=0;index<result.data.length;index++) {
  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;
  if(!encoded && uri.startsWith("data:image/")) {
    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");
    encoded=uri.slice(comma+1);
  }
  if(encoded) {
    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");
    raw=Buffer.from(encoded,"base64");
  } else if(uri) {
    const u=new URL(uri,"https://api.ailoot.ai");
    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");
    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");
    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});
    if(!response.ok) throw new Error("Image content download failed: "+response.status);
    raw=Buffer.from(await response.arrayBuffer());
  } else throw new Error("Image has neither bytes nor URL");
  if(!raw.length) throw new Error("Empty image result");
  const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";
  writeFileSync(`image-${index}.${ext}`,raw);
}
console.log("Every returned image saved; sdk-result.json retains complete metadata");
```

### Receive and save results

#### Ailoot · Images

Download each returned image or save its Base64 contents

- `GET /v1/media/tasks/{task_id}`
- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

##### Keep all completed results

Save every completed image; retrieve each returned URL or decode its Base64 contents.

Save every data item. Decode each b64\_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.

##### If the original response needs checking

If an image generation or edit result requires a check, keep the original operation\_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task\_id or asset\_id values. Do not resubmit the generation/edit request or construct a polling URL from operation\_id.

Response fields

| Field | Type |
| --- | --- |
| Field`created` | Typeinteger |
| Field`data[].url` | Typestring |
| Field`data[].b64_json` | Typebase64 string |
| Field`usage` | Typeobject |

Errors and next steps

| Response | Condition | Next step |
| --- | --- | --- |
| Response400 · `invalid_request_error` | ConditionInvalid required fields, material representation or parameter value | Next stepCorrect the indicated fields before a new creation request. |
| Response`server_error` | ConditionThe returned response says the operation or result requires a check | Next stepKeep the original returned operation/task ID, request headers and response; continue supported reads of that original operation. Do not resubmit the creation request. |

### Aliases

#### Model aliases

<strong>Ailoot</strong> [`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Core&caller=gpt-image-2.5-flare&fmt=images)
**Ailoot Ultra** [`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=gpt-image-2.5-flare&fmt=images), [`openai/gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=openai%2Fgpt-image-2.5-flare&fmt=images)

#### Method path aliases

`/v1/images`

#### Related caller IDs

[`openai/gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=openai%2Fgpt-image-2.5-flare&fmt=images), [`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Core&caller=gpt-image-2.5-flare&fmt=images), [`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=gpt-image-2.5-flare&fmt=images)

**Ailoot Ultra · Images** `POST /v1/images/generations` `gpt-image-2.5-flare`

[`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=gpt-image-2.5-flare&fmt=images)

OpenAI /`gpt-image-2.5-flare`

Model ID

- `gpt-image-2.5-flare`
- `openai/gpt-image-2.5-flare`

### Overview

GPT Image 2.5 Flare generates and edits images from text and references, with a focus on fast everyday visual creation. It supports custom sizes, transparent backgrounds, masks and quality levels up to max for drafts, illustrations and campaign assets.

Accepted inputs

Text

Results

Images

### Available in Ailoot · inputs & methods

**Ailoot Ultra · Images** `POST /v1/images/generations`

Input types

`text`

Output types

`image`

| Field | Type | Requirement | Values & limits | Default |
| --- | --- | --- | --- | --- |
| Field`model` | Type`string` | RequirementRequired | Values & limits gpt-image-2.5-flare | Default— |
| Field`prompt` | Type`string` | RequirementRequired | Values & limits Maximum length: 32,000 | Default— |
| Field`size` | Type`string` | RequirementOptional | Values & limits Conditions: Use auto or WIDTHxHEIGHT with both dimensions divisible by 16. The longest side is at most 3,840 pixels and total size at most 8,300,000 pixels. | Defaultauto |
| Field`background` | Type`string` | RequirementOptional | Values & limits transparent, opaque, auto | Defaultauto |
| Field`moderation` | Type`string` | RequirementOptional | Values & limits low, auto Conditions: Use auto for standard content moderation. | Default— |
| Field`n` | Type`integer` | RequirementOptional | Values & limits Minimum: 1 Maximum: 10 | Default1 |
| Field`quality` | Type`string` | RequirementOptional | Values & limits auto, high, medium, low | Defaultauto |
| Field`output_compression` | Type`integer` | RequirementOptional | Values & limits Minimum: 0 Maximum: 100 Conditions: Applies to JPEG and WebP output; send the documented integer value. | Default100 |
| Field`output_format` | Type`string` | RequirementOptional | Values & limits webp, png, jpeg | Defaultpng |
| Field`stream` | Type`boolean` | RequirementOptional | Values & limits false Conditions: This route returns one completed JSON response. | Defaultfalse |

Method parameters and lifecycle

| Parameter | Contract |
| --- | --- |
| Parameter`content_type` | Contractapplication/json |
| Parameter`required` | Contractprompt, model |
| Parameter`material_types` | Contracttext |
| Parameter`optional` | Contractsize, background, moderation, n, quality, output\_compression, output\_format, stream |
| Parameter`conditions` | ContractA transparent background requires PNG or WebP., Output compression applies to JPEG or WebP., The selected method generates from text. Editing and streaming controls described for the manufacturer are separate capabilities. |

Lifecycle: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · actual returned task\_id or media library record

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

### Pricing

##### How the final charge is calculated

The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.

Tariff references do not add request options. Supported parameters are listed for the selected method.

Fast mode

Not specified When fast mode is selected

Flex mode

Not specified When flex mode is selected

Maximum reasoning effort

Not specified When maximum reasoning effort uses the default adjustment

#### Estimated rates for comparison

#### Prices by configuration

Match each charge to the conditions shown. Use one rate for each set of alternative configurations.

| Configuration | Rate schedule | Forecast quantity | Charge |
| --- | --- | --- | --- |
| ConfigurationBase token rates | Rate scheduleBase rate | Forecast quantity— | Charge Input · Input tokens · Estimate for comparison only **—** / 1K tokens Output · Output tokens · Estimate for comparison only **—** / 1K tokens Input · Cache read · Estimate for comparison only **—** / 1K tokens Input · Cache write · Estimate for comparison only **—** / 1K tokens Input · Cache write, 1 hour · Estimate for comparison only **—** / 1K tokens |
| ConfigurationEstimated generation cost | Rate schedule— | Forecast quantityone generation estimate | Charge Output · Estimated generation cost · Estimate for comparison only **$0.24576** estimate before generation This estimate is not an additional charge or a fixed rate for the completed generation. |

Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. [How reservation and settlement work →](https://ailoot.ai/docs/en/billing/reserve/)

### Example requests

#### Ailoot Ultra · Images

curl

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2.5-flare', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
```

### Receive and save results

#### Ailoot Ultra · Images

Download each returned image or save its Base64 contents

- `GET /v1/media/tasks/{task_id}`
- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

Other content reads

Read existing owned assets

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
```

##### Keep all completed results

Save every completed image; retrieve each returned URL or decode its Base64 contents.

Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.

##### If the original response needs checking

Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task\_id/asset\_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation.

Response fields

| Field | Type |
| --- | --- |
| Field`created` | Type |
| Field`data[].url` | Type |
| Field`data[].b64_json` | Type |
| Field`usage` | Type |

### Aliases

#### Model aliases

<strong>Ailoot</strong> [`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Core&caller=gpt-image-2.5-flare&fmt=images)
**Ailoot Ultra** [`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=gpt-image-2.5-flare&fmt=images), [`openai/gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=openai%2Fgpt-image-2.5-flare&fmt=images)

#### Method path aliases

`/v1/images`

#### Related caller IDs

[`openai/gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=openai%2Fgpt-image-2.5-flare&fmt=images), [`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Core&caller=gpt-image-2.5-flare&fmt=images), [`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=gpt-image-2.5-flare&fmt=images)

**Ailoot Ultra · Images** `POST /v1/images/generations` `openai/gpt-image-2.5-flare`

[`openai/gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=openai%2Fgpt-image-2.5-flare&fmt=images)

OpenAI /`openai/gpt-image-2.5-flare`

Model ID

- `gpt-image-2.5-flare`
- `openai/gpt-image-2.5-flare`

### Overview

GPT Image 2.5 Flare generates and edits images from text and references, with a focus on fast everyday visual creation. It supports custom sizes, transparent backgrounds, masks and quality levels up to max for drafts, illustrations and campaign assets.

Accepted inputs

Text · Images

Results

Images

### Available in Ailoot · inputs & methods

**Ailoot Ultra · Images** `POST /v1/images/generations`

Input types

`text`, `image`

Output types

`image`

| Field | Type | Requirement | Values & limits | Default |
| --- | --- | --- | --- | --- |
| Field`model` | Type`string` | RequirementRequired | Values & limits openai/gpt-image-2.5-flare | Default— |
| Field`prompt` | Type`string` | RequirementRequired | Values & limits Minimum length: 1 | Default— |
| Field`aspect_ratio` | Type`string` | RequirementOptional | Values & limits 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Default— |
| Field`quality` | Type`string` | RequirementOptional | Values & limits auto, low, medium, high, xhigh, max | Default— |
| Field`background` | Type`string` | RequirementOptional | Values & limits auto, transparent, opaque | Default— |
| Field`n` | Type`integer` | RequirementOptional | Values & limits Minimum: 1 Maximum: 10 | Default— |
| Field`input_references` | Type`array` | RequirementOptional | Values & limits Minimum items: 0 Maximum items: 16 | Default— |
| Field`output_compression` | Type`integer` | RequirementOptional | Values & limits Minimum: 0 Maximum: 100 | Default— |
| Field`provider` | Type`object` | RequirementOptional | Values & limits | Default— |

Method parameters and lifecycle

| Parameter | Contract |
| --- | --- |
| Parameter`content_type` | Contractapplication/json |
| Parameter`required` | Contractmodel, prompt |
| Parameter`material_types` | Contracttext, image |

Lifecycle: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · actual returned task\_id or media library record

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

### Pricing

##### How the final charge is calculated

The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.

Tariff references do not add request options. Supported parameters are listed for the selected method.

Fast mode

Not specified When fast mode is selected

Flex mode

Not specified When flex mode is selected

Maximum reasoning effort

Not specified When maximum reasoning effort uses the default adjustment

#### Estimated rates for comparison

#### Prices by configuration

Match each charge to the conditions shown. Use one rate for each set of alternative configurations.

| Configuration | Rate schedule | Forecast quantity | Charge |
| --- | --- | --- | --- |
| ConfigurationBase token rates | Rate scheduleBase rate | Forecast quantity— | Charge Input · Input tokens · Estimate for comparison only **—** / 1K tokens Output · Output tokens · Estimate for comparison only **—** / 1K tokens Input · Cache read · Estimate for comparison only **—** / 1K tokens Input · Cache write · Estimate for comparison only **—** / 1K tokens Input · Cache write, 1 hour · Estimate for comparison only **—** / 1K tokens |
| ConfigurationEstimated generation cost | Rate schedule— | Forecast quantityone generation estimate | Charge Output · Estimated generation cost · Estimate for comparison only **$0.24576** estimate before generation This estimate is not an additional charge or a fixed rate for the completed generation. |

Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. [How reservation and settlement work →](https://ailoot.ai/docs/en/billing/reserve/)

### Example requests

#### Ailoot Ultra · Images

curl

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'openai/gpt-image-2.5-flare', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
```

### Receive and save results

#### Ailoot Ultra · Images

Download each returned image or save its Base64 contents

- `GET /v1/media/tasks/{task_id}`
- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

Other content reads

Read existing owned assets

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
```

##### Keep all completed results

Save every completed image; retrieve each returned URL or decode its Base64 contents.

Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.

##### If the original response needs checking

Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task\_id/asset\_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation.

Response fields

| Field | Type |
| --- | --- |
| Field`created` | Type |
| Field`data[].url` | Type |
| Field`data[].b64_json` | Type |
| Field`usage` | Type |

### Aliases

#### Model aliases

<strong>Ailoot</strong> [`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Core&caller=gpt-image-2.5-flare&fmt=images)
**Ailoot Ultra** [`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=gpt-image-2.5-flare&fmt=images), [`openai/gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=openai%2Fgpt-image-2.5-flare&fmt=images)

#### Method path aliases

`/v1/images`

#### Related caller IDs

[`openai/gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=openai%2Fgpt-image-2.5-flare&fmt=images), [`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Core&caller=gpt-image-2.5-flare&fmt=images), [`gpt-image-2.5-flare`](https://ailoot.ai/models/en/#m=openai%2Fgpt-image-2.5-flare&route=Ultra&caller=gpt-image-2.5-flare&fmt=images)

FAQ · OpenAI: GPT Image 2.5 Flare

What inputs and results are available?

`POST /v1/images/generations` · `gpt-image-2.5-flare`: `text` → `image` `POST /v1/images/generations` · `gpt-image-2.5-flare`: `text` → `image` `POST /v1/images/generations` · `openai/gpt-image-2.5-flare`: `text`, `image` → `image`

Which fields does the request use?

`POST /v1/images/generations` · `gpt-image-2.5-flare`: `model`, `prompt`, `n`, `response_format`, `stream` `POST /v1/images/generations` · `gpt-image-2.5-flare`: `model`, `prompt`, `size`, `background`, `moderation`, `n`, `quality`, `output_compression`, `output_format`, `stream` `POST /v1/images/generations` · `openai/gpt-image-2.5-flare`: `model`, `prompt`, `aspect_ratio`, `quality`, `background`, `n`, `input_references`, `output_compression`, `provider`

What limits apply?

`POST /v1/images/generations` · `gpt-image-2.5-flare`: `n.minimum`: `1` `POST /v1/images/generations` · `gpt-image-2.5-flare`: `prompt.maximum_length`: `32000`; `n.minimum`: `1`; `n.maximum`: `10`; `output_compression.minimum`: `0`; `output_compression.maximum`: `100` `POST /v1/images/generations` · `openai/gpt-image-2.5-flare`: `n.minimum`: `1`; `n.maximum`: `10`; `output_compression.minimum`: `0`; `output_compression.maximum`: `100`

Connect Ailoot to Claude Code, OpenCode, Hermes or your own app.

## The company and its project portfolio

The company and its project portfolio: millions of customers; monthly sales in the billions.

## Buy tokens at a discount.

Subscription discounts for regular use. Promo codes offer up to 50% off token purchases.

Subscription

Choose a discounted plan for your regular requests.

Promo code: up to 50% off

Enter your code at checkout. The price updates to reflect the current promotion.

Spending in your history

The model, tokens and amount are recorded for each request.

[Choose a subscription](https://ailoot.ai/docs/en/billing/subscriptions/) · [View model prices](https://ailoot.ai/models/en/)

## Connect the API to a product you sell.

Use Ailoot in SaaS, apps and bots under its official service offer and licence agreement. Request a reseller licence for resale.

Commercial application

Add text, image, video and audio generation to paid features in your service.

Reseller licence

Send a description of your project and how you provide access. Request written terms for use and resale.

Documents on the website

The service offer, licence agreement and data processing policy are available before you connect.

[Request a reseller licence](mailto:support@ailoot.ai) · [Service offer and licence agreement](https://ailoot.ai/legal/offer?lang=en)

## Ailoot · The company and its project portfolio





Ailoot combines established operating experience, a large client base, stable service and ongoing KPI control.





The company and its project portfolio: millions of customers; monthly sales in the billions.





Ailoot brings that operating experience to API access for AI features in customer products, agents, applications and automations.