Skip to main content
POST

Authorizations

string
required
All endpoints require authentication using a Bearer Token.Get an API key:Visit the API Key Management page to get your API key.Add to the request header when using:

Body

string
required
Model name, choose one of two:
  • "gpt_image_2_5_flare" — Flare, faster for daily text-to-image / image editing
  • "gpt_image_2_5_sunburst" — Sunburst, more emphasis on editing fidelity (characters, layout, product appearance)
There is no bare gpt-image-2.5 ID. When comparing the two tiers, please keep the prompt, reference images, aspect ratio, and resolution unchanged.
object
required
Model parameter object
string
required
Caller Task IDUser-defined task identifier, required. Use the same value to call POST /api/openapi/query when querying results.

Size × Resolution Mapping Table

aspect_ratio × resolution → Actual pixels (auto is automatically selected by the model and is not listed in the table):
3:2 / 2:3 @ 2K is actually 2048×1360 (approximate ratio). If you need aspect ratios not listed in the table, please use size.

Response

string
Caller task ID, used for querying results
string
Initial status, fixed as "pending"
number
Estimated credit cost
string
Creation time (ISO format)
To query the completion status, use POST https://aireiter.com/api/openapi/query with the same out_task_id. Failed tasks will not deduct credits.