OpenAI 兼容的图像生成

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

{
  "created": 1776495432,
  "data": [
    {
      "size": "2048x2048",
      "url": "https://cdn.aisa.one/images/seedream/20260418-abc.png"
    }
  ],
  "model": "seedream-5-0-260128",
  "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"
}
'

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

标准的 OpenAI 兼容 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 路由

当前价格见 aisa.one/models。

尺寸限制 ⚠️（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
  }
}

AIsa 的响应在原生 OpenAI schema 之上增加了几处扩展：

根层级回显 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 技能。

请求规范

方法与路径: POST /images/generations
请求 URL 模板: https://api.aisa.one/v1/images/generations

完整 OpenAPI 定义有效请求与价格声明（包括认证和引用的 schema）：

{
  "operationId": "createImageGeneration",
  "method": "POST",
  "path": "/images/generations",
  "servers": [
    {
      "url": "https://api.aisa.one/v1"
    }
  ],
  "parameters": [],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "examples": {
          "basic": {
            "summary": "Single 2K image",
            "value": {
              "model": "seedream-5-0-260128",
              "n": 1,
              "prompt": "A cute red panda, ultra-detailed, cinematic lighting",
              "size": "2048x2048"
            }
          },
          "batch": {
            "summary": "Four candidates for selection",
            "value": {
              "model": "seedream-5-0-260128",
              "n": 4,
              "prompt": "Oil painting of a rolling hillside at sunset",
              "size": "2048x2048"
            }
          },
          "minimum_size": {
            "summary": "Exactly at minimum allowed size (1920×1920)",
            "value": {
              "model": "seedream-5-0-260128",
              "n": 1,
              "prompt": "A futuristic cyberpunk city, neon lights, rainy night, 8k",
              "size": "1920x1920"
            }
          }
        },
        "schema": {
          "properties": {
            "model": {
              "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`.",
              "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"
              ],
              "type": "string"
            },
            "n": {
              "default": 1,
              "description": "Number of images to generate. Each image is billed separately at the per-image rate.",
              "minimum": 1,
              "type": "integer"
            },
            "prompt": {
              "description": "Text description of the image to generate.",
              "type": "string"
            },
            "size": {
              "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",
              "type": "string"
            }
          },
          "required": [
            "model",
            "prompt"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "bearerFormat": "AISA API Key",
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

授权

Authorization

string

header

必填

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

请求体

application/json

model

enum<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。

可用选项:

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

必填

要生成的图像的文本描述。

integer

默认值:1

要生成的图像数量。每张图像均按单张图像费率单独计费。

必填范围: x >= 1

size

string

图像尺寸，格式为 宽x高。Seedream 路由要求 宽 × 高 ≥ 3,686,400（例如 1920x1920、2048x2048）；Wan 和 gpt-image-2 可接受更小尺寸，如 1024x1024。

示例:

"2048x2048"

响应

图像生成成功。

created

integer

示例:

1776495432

data

object[]

每张生成的图像对应一个条目。

Show child attributes

model

string

示例:

"seedream-5-0-260128"

usage

object

Show child attributes

概览

模型

搜索与研究

金融与加密

社交与媒体

SEO 与网站情报

销售与邮件

出行与其他

OpenAI 兼容的图像生成

路由速览

支持的模型

尺寸限制 ⚠️（Seedream 路由）

请求

请求字段

响应

常见 4xx 原因

相关

模型目录

Gemini generateContent

Media Gen skill

请求规范

授权

请求体

响应

​路由速览

​支持的模型

​尺寸限制 ⚠️（Seedream 路由）

​请求

​请求字段

​响应

​常见 4xx 原因

​相关

模型目录

Gemini generateContent

Media Gen skill

​请求规范

授权

请求体

响应

路由速览

支持的模型

尺寸限制 ⚠️（Seedream 路由）

请求

请求字段

响应

常见 4xx 原因

相关

请求规范