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
}
}Chat API
OpenAI-Compatible Image Generations
Generate images with Seedream, Wan, and gpt-image-2 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 --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
Any aspect ratio works as long as
AIsa’s response adds a few extensions over the vanilla OpenAI schema:
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 | ✅ |
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
}
}
modelechoed at the rootdata[].size— actual dimensions of each returned imageusage— includesgenerated_images(drives billing), plusoutput_tokens/total_tokensfor 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—sizewas too small. Use1920x1920or 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— malformedsizestring (e.g.,1024instead of1024x1024).
Related
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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
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 Text description of the image to generate.
Number of images to generate. Each image is billed separately at the per-image rate.
Required range:
x >= 1Image 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"