curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2",
    "params": {
      "prompt": "An orange cat sitting on the windowsill watching the sunset, watercolor style",
      "aspect_ratio": "16:9"
    },
    "out_task_id": "my_task_123456"
  }'

{
    "statusCode": 200,
    "message": "",
    "data": {
        "out_task_id": "my_task_123456",
        "status": "pending",
        "estimated_credits": 100,
        "created_at": "2025-12-22T06:03:28.242Z"
    }
}

GPT-Image-2

GPT-Image-2 Image Generation

Asynchronous processing mode, returns a task ID for subsequent queries
Compatible with OpenAI Images protocol, supports text-to-image / image-to-image
Supports 13 image aspect ratios, passed through the aspect_ratio field
Added resolution tier field, supports 1K / 2K / 4K resolution selection (4K full aspect ratio supported)
Added size field, supports custom pixel dimensions (mutually exclusive with aspect_ratio / resolution, total pixels ≥ 2,088,960 required for precise generation)
Up to 10 reference images, supports mixed URL and base64 inputs
Submitted prompts will undergo platform sensitive word / security review, violating content will be directly rejected

POST

api

openapi

submit

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2",
    "params": {
      "prompt": "An orange cat sitting on the windowsill watching the sunset, watercolor style",
      "aspect_ratio": "16:9"
    },
    "out_task_id": "my_task_123456"
  }'

{
    "statusCode": 200,
    "message": "",
    "data": {
        "out_task_id": "my_task_123456",
        "status": "pending",
        "estimated_credits": 100,
        "created_at": "2025-12-22T06:03:28.242Z"
    }
}

Authorizations

Authorization

string

required

All endpoints require authentication using a Bearer Token.Get the API Key:Visit the API Key Management Page to obtain your API Key.Add the following header in the request:

Authorization: Bearer YOUR_API_KEY

Body

model

string

required

Model NameFixed value: "gpt_image_2"

params

object

required

Model Parameters Object

Show params Object Properties

prompt

string

required

Text Description for Image Generation

Supports Chinese and English; detailed descriptions are recommended
The prompt will undergo platform sensitive word / security review before submission; any violation will result in an error

image_url

string[]

Reference Image Array; when provided, image-to-image mode is used

Up to 10 reference images
Supports the following two formats:
1. Publicly accessible URLs
2. Base64 encoded format
  - Must use the full Data URI format: data:image/{format};base64,{base64 data}
  - Supported image formats: jpeg, png, webp
  - Example: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  - ⚠️ Note: Must include the data:image/jpeg;base64, prefix

aspect_ratio

string

default:"auto"

Image Generation Aspect RatioDefault value varies with resolution:

Defaults to auto when resolution is 1K / 2K
Defaults to 16:9 when resolution is 4K

Supported values:

auto - Automatically selects the most suitable ratio
1:1 - Square
16:9 / 9:16 - Wide horizontal / vertical
4:3 / 3:4 - Standard horizontal / vertical
3:2 / 2:3 - Classic horizontal / vertical
5:4 / 4:5 - Nearly square horizontal / vertical
2:1 / 1:2 - Wide horizontal / tall vertical
21:9 / 9:21 - Ultra-wide horizontal / ultra-tall vertical

Only aspect ratio strings or auto are supported; passing pixel dimensions (e.g., 1024x1024) will cause an error

resolution

string

default:"1K"

Resolution TierControls the actual output image clarity:

1K - 1024 baseline, cost-effective for daily use (default)
2K - 2048 baseline, suitable for posters / high-definition needs
4K - 3840 baseline, supports all 13 ratios

When passing size, resolution and aspect_ratio cannot be passed at the same time; otherwise, a 400 error will be returned.

size

string

Custom Pixel Dimensions (mutually exclusive with aspect_ratio / resolution)Format is widthxheight, e.g., 2048x1536, 3840x2160.Usage Limitations:

Format must match ^\d+x\d+$, such as 2048x1536; other formats are unsupported
Mutually exclusive with aspect_ratio and resolution; only one of the three can be chosen; passing both will return 400
Total pixels (width × height) must be within 655,360 ~ 8,294,400

Practical Pixel Lower Limit:

Total Pixel Range	Upstream Behavior
≥ 2,088,960 (approx. 2.0M)	Exact output according to the passed `size` ✅
< 2,088,960	Silently replaced with a similar ratio (~1.57M) (equivalent to not passing `size`) ⚠️

When total pixels are below approximately 2,088,960, upstream does not report an error but silently replaces output size. For precise control, it is recommended to have total pixels ≥ 2,088,960.For small size needs, please use the combination of aspect_ratio + resolution=1K.

Recommendations:

Requirement	Recommended Method
Precise pixel size control	`size` with total pixels ≥ 2,088,960
Small size (< 2M pixels)	`aspect_ratio` + `resolution=1K`
Medium to large sizes with any ratio	`size`; 2K / 4K range supports precise output for any ratio

out_task_id

string

required

Initiator Task IDUser-defined task identifier, required

Size × Resolution Mapping Table

aspect_ratio × resolution → Actual Pixels (13 ratios × 3 levels):

aspect_ratio	`1K`	`2K`	`4K`
`1:1`	1024×1024 / 1254×1254	2048×2048	2880×2880
`3:2`	1536×1024	2048×1360	3520×2336
`2:3`	1024×1536	1360×2048	2336×3520
`4:3`	1024×768	2048×1536	3312×2480
`3:4`	768×1024	1536×2048	2480×3312
`5:4`	1280×1024 / 1448×1086	2560×2048	3216×2576
`4:5`	1024×1280 / 1122×1402	2048×2560	2576×3216
`16:9`	1536×864 / 1672×941	2048×1152	3840×2160
`9:16`	864×1536 / 941×1672	1152×2048	2160×3840
`2:1`	2048×1024 / 1774×887	2688×1344	3840×1920
`1:2`	1024×2048 / 887×1774	1344×2688	1920×3840
`21:9`	2016×864 / 1915×821	2688×1152	3840×1648
`9:21`	864×2016 / 821×1915	1152×2688	1648×3840

3:2 / 2:3 @ 2K is actually 2048×1360 (approximate ratio, error < 0.5%); 4K now supports all 13 ratios.

Custom Size (size parameter)

When you need precise control over pixel dimensions, use the size parameter instead of the aspect_ratio + resolution combination. Valid range: Total pixels 655,360 ~ 8,294,400 (upstream official limit) Tested effective lower limit: Total pixels ≥ 2,088,960 (approximately 1440×1452 or 2048×1020 equivalent area) Below this lower limit, the upstream does not report an error but silently replaces it with a close proportion size of about 1.57M pixels.

Common size examples

size value	Total pixels	Recommended use
`2048x2048`	4,194,304	Square HD
`2048x1536`	3,145,728	4:3 landscape
`1536x2048`	3,145,728	3:4 portrait
`2048x1152`	2,359,296	16:9 landscape
`1152x2048`	2,359,296	9:16 portrait
`3840x2160`	8,294,400	4K 16:9 (highest quality)
`2688x1344`	3,612,672	2:1 wide landscape

Do not pass together with aspect_ratio or resolution, otherwise a 400 will be returned.

Response

out_task_id

string

Initiator task ID, which can be used to query the result

status

string

Initial status, fixed to "pending"

estimated_credits

number

Estimated consumed credits

created_at

string

Creation time (ISO format)

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2",
    "params": {
      "prompt": "An orange cat sitting on the windowsill watching the sunset, watercolor style",
      "aspect_ratio": "16:9"
    },
    "out_task_id": "my_task_123456"
  }'

{
    "statusCode": 200,
    "message": "",
    "data": {
        "out_task_id": "my_task_123456",
        "status": "pending",
        "estimated_credits": 100,
        "created_at": "2025-12-22T06:03:28.242Z"
    }
}

GPT-4o Image Generation GPT-Image-2 Official Channel Image Generation

Documentation Index

​Authorizations

​Body

​Size × Resolution Mapping Table

​Custom Size (size parameter)

​Common size examples

​Response

Authorizations

Body

Size × Resolution Mapping Table

Custom Size (size parameter)

Common size examples

Response