OpenAI-Compatible Image Generations

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",
  "n": 1,
  "size": "2048x2048"
}
'

{
  "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
  }
}

POST

https://api.aisa.one/v1

images

generations

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",
  "n": 1,
  "size": "2048x2048"
}
'

{
  "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 July 28, 2026 it serves seedream-5-0-260128, wan2.7-image, wan2.7-image-pro, and gpt-image-2. The older seedream-4-5-251128 route is reached through Image Generation via Chat instead.

Routing at a glance

Model	Endpoint
`seedream-5-0-260128`	`POST /v1/images/generations` (this page), also `POST /v1/chat/completions`
`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`
`seedream-4-5-251128`	`POST /v1/chat/completions`
Gemini-compatible models	`POST /v1beta/models/{model}:generateContent`

Supported models

Model	Cost	Notes
`seedream-5-0-260128`	$0.035 / request	Min image size 3,686,400 pixels (e.g., 1920×1920)
`wan2.7-image`	$0.030 / request	Also accepts `POST /v1/images/edits`
`wan2.7-image-pro`	$0.075 / request	Higher-quality Wan route
`gpt-image-2`	$0.03 / request or $0.05 / image (1024×1024)	Token pricing also applies on some routes — see AI Model Pricing

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 -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"
  }'

from openai import OpenAI

client = OpenAI(base_url="https://api.aisa.one/v1", api_key="sk-aisa-...")

resp = client.images.generate(
    model="seedream-5-0-260128",
    prompt="A cute red panda, ultra-detailed, cinematic lighting",
    n=1,
    size="2048x2048",
)

for item in resp.data:
    print(item.url)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.aisa.one/v1",
  apiKey: process.env.AISA_API_KEY,
});

const resp = await client.images.generate({
  model: "seedream-5-0-260128",
  prompt: "A cute red panda, ultra-detailed, cinematic lighting",
  n: 1,
  size: "2048x2048",
});

for (const item of resp.data) {
  console.log(item.url);
}

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`
`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.
404 openai_error — you passed a model that isn’t routed through this endpoint (e.g., wan2.7-image). Use the chat-based route instead.
400 invalid_request — malformed size string (e.g., 1024 instead of 1024x1024).

See Error Codes and Rate Limits for more.

Image Generation via Chat

The /v1/chat/completions route for the Wan 2.7 family.

Gemini generateContent

Gemini-compatible generateContent endpoint.

Media Gen skill

Agent skill that wraps image + video generation.

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 ($0.035/request), wan2.7-image ($0.030/request), wan2.7-image-pro ($0.075/request), or gpt-image-2 ($0.03/request or $0.05 per 1024×1024 image).

Available options:

seedream-5-0-260128,

wan2.7-image,

wan2.7-image-pro,

gpt-image-2

prompt

string

required

Text description of the image to generate.

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

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

Overview

Chat API

Embeddings & Rerank

Search API

Perplexity API

Financial API

Twitter API

Reddit API

Instagram API

Pinterest API

Scholar API

WaveInflu API

Prediction Market API

CoinGecko

DataForSEO

AgentMail

Apollo

Ahrefs API

Semrush API

SimilarWeb API

Essentials

OpenAI-Compatible Image Generations

Routing at a glance

Supported models

Size constraint ⚠️ (Seedream routes)

Request

Request fields

Response

Common 4xx causes

Image Generation via Chat

Gemini generateContent

Media Gen skill

Authorizations

Body

Response

​Routing at a glance

​Supported models

​Size constraint ⚠️ (Seedream routes)

​Request

​Request fields

​Response

​Common 4xx causes

​Related

Image Generation via Chat

Gemini generateContent

Media Gen skill

Authorizations

Body

Response

Routing at a glance

Supported models

Size constraint ⚠️ (Seedream routes)

Request

Request fields

Response

Common 4xx causes

Related