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
}
}聊天 API
OpenAI 兼容的图像生成
通过标准的 POST /v1/images/generations endpoint,使用 Seedream、Wan、gpt-image-2 和 GPT Image 2.5 生成图像。请求结构为 OpenAI 兼容;Seedream 路由要求图像最小尺寸为 3,686,400 像素(例如 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
}
}标准的 OpenAI 兼容
当前价格见 aisa.one/models。
只要
AIsa 的响应在原生 OpenAI schema 之上增加了几处扩展:
POST /v1/images/generations endpoint。截至 2026 年 9 月 30 日,它服务 seedream-5-0-260128、wan2.7-image、wan2.7-image-pro、gpt-image-2、gpt-image-2.5-flare 和 gpt-image-2.5-sunburst。POST /v1/chat/completions 上没有可用的图像模型——图像生成统一走本 endpoint(标注处另支持 POST /v1/images/edits)。
路由速览
| 模型 | Endpoint |
|---|---|
seedream-5-0-260128 | POST /v1/images/generations (本页) |
wan2.7-image / wan2.7-image-pro | POST /v1/images/generations (本页)、POST /v1/images/edits |
gpt-image-2 | POST /v1/images/generations (本页)、POST /v1/images/edits |
gpt-image-2.5-flare / gpt-image-2.5-sunburst | POST /v1/images/generations (本页)、POST /v1/images/edits |
| Gemini 兼容模型 | POST /v1beta/models/{model}:generateContent |
支持的模型
| 模型 | 计费方式 | 说明 |
|---|---|---|
seedream-5-0-260128 | 按次请求 | 图像最小尺寸 3,686,400 像素(例如 1920×1920) |
wan2.7-image | 按次请求 | 同时支持 POST /v1/images/edits |
wan2.7-image-pro | 按次请求 | 质量更高的 Wan 路由 |
gpt-image-2 | 按次请求或按张图片;部分路由同时适用 token 计价 | 参见 AI 模型价格 |
gpt-image-2.5-flare | 按 1M Token:输入、输出、缓存读取 | GPT Image 2.5 路由 |
gpt-image-2.5-sunburst | 按 1M Token:输入、输出、缓存读取 | GPT Image 2.5 路由 |
尺寸限制 ⚠️(Seedream 路由)
Seedream 上游强制要求最少 3,686,400 像素。低于该值的请求会被拒绝:400 InvalidParameter: image size must be at least 3686400 pixels
| 尺寸 | 像素数 | 是否接受? |
|---|---|---|
1024x1024 | 1,048,576 | ❌ |
1536x1536 | 2,359,296 | ❌ |
1920x1920 | 3,686,400 | ✅(正好达到阈值) |
2048x2048 | 4,194,304 | ✅ |
2304x1600 | 3,686,400 | ✅ |
2560x1920 | 4,915,200 | ✅ |
宽 × 高 ≥ 3,686,400,任意宽高比都可以。
请求
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);
}
请求字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 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 | 是 | 要生成图像的文字描述 |
n | integer | 否 | 生成图像数量。每张按该模型的单次请求费率单独计费 |
size | string | 否 | 宽x高。Seedream 路由必须满足 宽 × 高 ≥ 3,686,400;wan2.7-image 和 gpt-image-2 可接受更小尺寸(已验证 1024x1024 可用) |
响应
{
"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
}
}
- 根层级回显
model data[].size——每张返回图像的实际尺寸usage——包含generated_images(用于计费),以及用于 token 核算的output_tokens/total_tokens
data[].url 中的 URL 有效期很短。请在过期前下载并保存到你自己的存储中。常见 4xx 原因
400 InvalidParameter — image size must be at least 3686400 pixels——size太小。请使用1920x1920或更大。400 model_route_not_supported——该模型不走本 endpoint(例如文本模型gpt-4.1-mini)。错误体中的supported_routes会列出它支持的路由。404 model not found——网关上不存在该模型 ID(例如已下线的seedream-4-5-251128)。请查阅模型目录。400 invalid_request——size字符串格式不正确(例如写成1024而不是1024x1024)。
相关
模型目录
当前模型 ID 及各自支持的 endpoint。
Gemini generateContent
Gemini 兼容的 generateContent endpoint。
Media Gen skill
封装图像与视频生成的 Agent 技能。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json
图像生成模型。seedream-5-0-260128、wan2.7-image、wan2.7-image-pro、gpt-image-2、gpt-image-2.5-flare 或 gpt-image-2.5-sunburst。
可用选项:
seedream-5-0-260128, wan2.7-image, wan2.7-image-pro, gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst 要生成的图像的文本描述。
要生成的图像数量。每张图像均按单张图像费率单独计费。
必填范围:
x >= 1图像尺寸,格式为 宽x高。Seedream 路由要求 宽 × 高 ≥ 3,686,400(例如 1920x1920、2048x2048);Wan 和 gpt-image-2 可接受更小尺寸,如 1024x1024。
示例:
"2048x2048"