OpenAI-Compatible Image Generations

Generate images with Seedream, Wan, gpt-image-2, and GPT Image 2.5 via the standard POST /v1/images/generations endpoint. OpenAI-compatible request shape; Seedream routes require a minimum image size of 3,686,400 pixels (e.g., 1920×1920).

POST https://api.aisa.one/v1/images/generations

cURL

basic

curl --request POST \
  --url https://api.aisa.one/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedream-5-0-260128",
  "prompt": "A cute red panda, ultra-detailed, cinematic lighting"
}
'

200

{
  "model": "seedream-5-0-260128",
  "created": 1776495432,
  "data": [
    {
      "url": "https://cdn.aisa.one/images/seedream/20260418-abc.png",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384
  }
}

The standard OpenAI-compatible POST /v1/images/generations endpoint. As of September 30, 2026 it serves seedream-5-0-260128, wan2.7-image, wan2.7-image-pro, gpt-image-2, gpt-image-2.5-flare, and gpt-image-2.5-sunburst. No image model is served on POST /v1/chat/completions — image generation goes through this endpoint (and POST /v1/images/edits where noted).

Routing at a glance

Model	Endpoint
seedream-5-0-260128	POST /v1/images/generations (this page)
wan2.7-image / wan2.7-image-pro	POST /v1/images/generations (this page), POST /v1/images/edits
gpt-image-2	POST /v1/images/generations (this page), POST /v1/images/edits
gpt-image-2.5-flare / gpt-image-2.5-sunburst	POST /v1/images/generations (this page), POST /v1/images/edits
Gemini-compatible models	POST /v1beta/models/{model}:generateContent

Supported models

Model	Billed by	Notes
seedream-5-0-260128	Per request	Min image size 3,686,400 pixels (e.g., 1920×1920)
wan2.7-image	Per request	Also accepts POST /v1/images/edits
wan2.7-image-pro	Per request	Higher-quality Wan route
gpt-image-2	Per request or per image; token pricing also applies on some routes	See AI Model Pricing
gpt-image-2.5-flare	Per 1M tokens: input, output, cache read	GPT Image 2.5 route
gpt-image-2.5-sunburst	Per 1M tokens: input, output, cache read	GPT Image 2.5 route

Current prices are on aisa.one/models.

Size constraint ⚠️ (Seedream routes)

Seedream’s upstream enforces a minimum of 3,686,400 pixels. Requests below that are rejected with:

400 InvalidParameter: image size must be at least 3686400 pixels

Size	Pixels	Accepted?
1024x1024	1,048,576	❌
1536x1536	2,359,296	❌
1920x1920	3,686,400	✅ (exact threshold)
2048x2048	4,194,304	✅
2304x1600	3,686,400	✅
2560x1920	4,915,200	✅

Any aspect ratio works as long as width × height ≥ 3,686,400.

Request

curl

curl -sS -X POST "https://api.aisa.one/v1/images/generations" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-260128",
    "prompt": "A cute red panda, ultra-detailed, cinematic lighting",
    "n": 1,
    "size": "2048x2048"
  }'

Request fields

Field	Type	Required	Notes
model	string	yes	One of seedream-5-0-260128, wan2.7-image, wan2.7-image-pro, gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst
prompt	string	yes	Text description of the image to generate
n	integer	no	Number of images. Each is billed separately at the model’s per-request rate
size	string	no	WIDTHxHEIGHT. Seedream routes must satisfy width × height ≥ 3,686,400; wan2.7-image and gpt-image-2 accept smaller sizes (1024x1024 verified working)

Response

{
  "model": "seedream-5-0-260128",
  "created": 1776495432,
  "data": [
    {
      "url": "https://cdn.aisa.one/images/seedream/...",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384
  }
}

AIsa’s response adds a few extensions over the vanilla OpenAI schema:

• model echoed at the root
• data[].size — actual dimensions of each returned image
• usage — includes generated_images (drives billing), plus output_tokens / total_tokens for token accounting

URLs in data[].url are short-lived. Download and persist the image to your own storage before it expires.

Common 4xx causes

• 400 InvalidParameter — image size must be at least 3686400 pixels — size was too small. Use 1920x1920 or larger.
• 400 model_route_not_supported — the model doesn’t serve this endpoint (e.g., a text model like gpt-4.1-mini). The error body’s supported_routes lists the routes it does serve.
• 404 model not found — the model ID doesn’t exist on the gateway (e.g., the retired seedream-4-5-251128). Check the model catalog.
• 400 invalid_request — malformed size string (e.g., 1024 instead of 1024x1024).

See Error Codes and Rate Limits for more.

Related

Model catalog

Current model IDs and the endpoints each one serves.

Gemini generateContent

Gemini-compatible generateContent endpoint.

Media Gen skill

Agent skill that wraps image + video generation.

Request contract

• Method and path: POST /images/generations
• Request URL template: https://api.aisa.one/v1/images/generations

Complete OpenAPI definition

Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "createImageGeneration",
  "method": "POST",
  "path": "/images/generations",
  "servers": [
    {
      "url": "https://api.aisa.one/v1"
    }
  ],
  "parameters": [],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "model",
            "prompt"
          ],
          "properties": {
            "model": {
              "type": "string",
              "enum": [
                "seedream-5-0-260128",
                "wan2.7-image",
                "wan2.7-image-pro",
                "gpt-image-2",
                "gpt-image-2.5-flare",
                "gpt-image-2.5-sunburst"
              ],
              "description": "Image generation model. `seedream-5-0-260128`, `wan2.7-image`, `wan2.7-image-pro`, `gpt-image-2`, `gpt-image-2.5-flare`, or `gpt-image-2.5-sunburst`."
            },
            "prompt": {
              "type": "string",
              "description": "Text description of the image to generate."
            },
            "n": {
              "type": "integer",
              "minimum": 1,
              "default": 1,
              "description": "Number of images to generate. Each image is billed separately at the per-image rate."
            },
            "size": {
              "type": "string",
              "description": "Image dimensions as `WIDTHxHEIGHT`. Seedream routes require `width × height ≥ 3,686,400` (e.g. `1920x1920`, `2048x2048`); Wan and `gpt-image-2` accept smaller sizes such as `1024x1024`.",
              "example": "2048x2048"
            }
          }
        },
        "examples": {
          "basic": {
            "summary": "Single 2K image",
            "value": {
              "model": "seedream-5-0-260128",
              "prompt": "A cute red panda, ultra-detailed, cinematic lighting",
              "n": 1,
              "size": "2048x2048"
            }
          },
          "minimum_size": {
            "summary": "Exactly at minimum allowed size (1920×1920)",
            "value": {
              "model": "seedream-5-0-260128",
              "prompt": "A futuristic cyberpunk city, neon lights, rainy night, 8k",
              "n": 1,
              "size": "1920x1920"
            }
          },
          "batch": {
            "summary": "Four candidates for selection",
            "value": {
              "model": "seedream-5-0-260128",
              "prompt": "Oil painting of a rolling hillside at sunset",
              "n": 4,
              "size": "2048x2048"
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "AISA API Key"
      }
    }
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

model · enum<string> · required

Image generation model. seedream-5-0-260128, wan2.7-image, wan2.7-image-pro, gpt-image-2, gpt-image-2.5-flare, or gpt-image-2.5-sunburst.

Available options: seedream-5-0-260128, wan2.7-image, wan2.7-image-pro, gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst

prompt · string · required

Text description of the image to generate.

n · integer · default: 1

Number of images to generate. Each image is billed separately at the per-image rate.

Required range: x >= 1

size · string

Image dimensions as WIDTHxHEIGHT. Seedream routes require width × height ≥ 3,686,400 (e.g. 1920x1920, 2048x2048); Wan and gpt-image-2 accept smaller sizes such as 1024x1024.

Example:

"2048x2048"

Response

200

application/json

Images generated successfully.

model · string

Example:

"seedream-5-0-260128"

created · integer

Example:

1776495432

data · object[]

One entry per generated image.

Show child attributes

usage · object

Show child attributes