gpt-image-2.5-flare@pro

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

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

Model summary

Model ID	gpt-image-2.5-flare@pro
Mode	Pro
Pricing	View live pricing

gpt-image-2.5-flare Pro mode.

Production guidance

Calling notes

Put model at the top level and parameters inside input.
callback.url must be an HTTPS terminal notification URL; when=final notifies on both success and failure.

Best suited for

Pro

Call Pro with gpt-image-2.5-flare@pro.

image_urlspromptaspect_ratioqualitybackgroundoutput_format

Request parameters

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

# Create an async task — returns taskId immediately (generation runs async)
# Replace YOUR_API_KEY with your account API key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2.5-flare@pro",
  "input": {
    "prompt": "Create a premium square editorial lifestyle photograph in a sunlit Mediterranean creative studio.",
    "aspect_ratio": "1:1",
    "background": "auto",
    "quality": "medium",
    "output_format": "webp"
  }
}'

import requests, json

# Business params — fields vary by model (see the model page)
payload = json.loads(r'''
{
  "model": "gpt-image-2.5-flare@pro",
  "input": {
    "prompt": "Create a premium square editorial lifestyle photograph in a sunlit Mediterranean creative studio.",
    "aspect_ratio": "1:1",
    "background": "auto",
    "quality": "medium",
    "output_format": "webp"
  }
}
''')

# Create an async task — returns taskId immediately (generation runs async)
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # Returns { code, message, data: { taskId } }

// Create an async task — returns taskId immediately (generation runs async)
// Replace YOUR_API_KEY with your account API key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "gpt-image-2.5-flare@pro",
  "input": {
    "prompt": "Create a premium square editorial lifestyle photograph in a sunlit Mediterranean creative studio.",
    "aspect_ratio": "1:1",
    "background": "auto",
    "quality": "medium",
    "output_format": "webp"
  }
}),
});
console.log(await resp.json()); // Returns { code, message, data: { taskId } }

model string required

Use exactly gpt-image-2.5-flare@pro.

example gpt-image-2.5-flare@pro

input object required

Mode parameters.

image_urls string[] optional

Optional reference image URLs, with 1–16 JPEG, PNG, or WebP images. SVG, GIF, and other formats are unsupported. Each image must be at most 20 megapixels and 30 MB, served from a publicly reachable, directly downloadable http(s) URL.

prompt string required

Prompt length: 1–32,000 characters.

aspect_ratio enum optional

Output aspect ratio.

default 1:1 enum: 1:13:22:34:33:416:99:16auto1024x10241536x10241024x15361536x11521152x15362048x20482048x11521152x20483840x21602160x3840

quality enum optional

Quality tier.

default medium enum: lowmediumhighxhighmaxauto

background enum optional

Background treatment: transparent, opaque, or auto. Use PNG or WebP for transparent backgrounds.

default auto enum: transparentopaqueauto

output_format enum optional

Output format.

default webp enum: pngjpegwebp

callback object optional

Optional terminal-state callback.

url string required

HTTPS URL that receives success or failure terminal notifications.

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

when enum optional

Notify when the task succeeds or fails.

default final enum: final

Example requests

Pro example

Replace the prompt with your description; no reference image is needed for this mode.

Request body

{
  "model": "gpt-image-2.5-flare@pro",
  "input": {
    "prompt": "Create a premium square editorial lifestyle photograph in a sunlit Mediterranean creative studio.",
    "aspect_ratio": "1:1",
    "background": "auto",
    "quality": "medium",
    "output_format": "webp"
  }
}

Getting the result

Receive a taskId after submission.
Poll GET /v1/tasks/:id or wait for the terminal callback.
When status=success, download the image from data.output[].url before expireAt.
When status=fail, inspect data.error, correct the request, and resubmit.

FAQ

Where can I check pricing?

Use the live pricing page. https://www.hiapi.ai/en/pricing#model-pricing

Next steps

View live pricing