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

标准的 OpenAI 兼容 POST /v1/images/generations endpoint。截至 2026 年 7 月 28 日，它服务 seedream-5-0-260128、wan2.7-image、wan2.7-image-pro 和 gpt-image-2。较早的 seedream-4-5-251128 路由改为通过经由 Chat 的图像生成访问。

路由速览

模型	Endpoint
`seedream-5-0-260128`	`POST /v1/images/generations` (本页)，同时支持 `POST /v1/chat/completions`
`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`
`seedream-4-5-251128`	`POST /v1/chat/completions`
Gemini 兼容模型	`POST /v1beta/models/{model}:generateContent`

支持的模型

模型	费用	说明
`seedream-5-0-260128`	$0.035 / 次请求	图像最小尺寸 3,686,400 像素（例如 1920×1920）
`wan2.7-image`	$0.030 / 次请求	同时支持 `POST /v1/images/edits`
`wan2.7-image-pro`	$0.075 / 次请求	质量更高的 Wan 路由
`gpt-image-2`	$0.03 / 次请求，或 $0.05 / 张（1024×1024）	部分路由同时适用 token 计价——参见 AI 模型价格

尺寸限制 ⚠️（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` 之一
`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 或更大。
404 openai_error——传入的模型不走该 endpoint（例如 wan2.7-image）。请改用基于 chat 的路由。
400 invalid_request——size 字符串格式不正确（例如写成 1024 而不是 1024x1024）。

更多内容参见错误码和速率限制。

Image Generation via Chat

Wan 2.7 系列使用的 /v1/chat/completions 路由。

Gemini generateContent

Gemini 兼容的 generateContent endpoint。

Media Gen skill

封装图像与视频生成的 Agent 技能。

授权

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（$0.035/次请求）、wan2.7-image（$0.030/次请求）、wan2.7-image-pro（$0.075/次请求）或 gpt-image-2（$0.03/次请求，或 1024×1024 图像 $0.05/张）。

可用选项:

seedream-5-0-260128,

wan2.7-image,

wan2.7-image-pro,

gpt-image-2

prompt

string

必填

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

integer

默认值:1

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

必填范围: x >= 1

size

string

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

示例:

"2048x2048"

响应

图像生成成功。

model

string

示例:

"seedream-5-0-260128"

created

integer

示例:

1776495432

data

object[]

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

Show child attributes

usage

object

Show child attributes

概览

聊天 API

Embeddings 与重排序

搜索 API

Perplexity API

金融 API

Twitter API

Reddit API

Instagram API

Pinterest API

学术搜索 API

WaveInflu API

预测市场 API

CoinGecko

DataForSEO

AgentMail

Apollo

基础功能

OpenAI 兼容的图像生成

路由速览

支持的模型

尺寸限制 ⚠️（Seedream 路由）

请求

请求字段

响应

常见 4xx 原因

相关

Image Generation via Chat

Gemini generateContent

Media Gen skill

授权

请求体

响应

​路由速览

​支持的模型

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

​请求

​请求字段

​响应

​常见 4xx 原因

​相关

Image Generation via Chat

Gemini generateContent

Media Gen skill

授权

请求体

响应

路由速览

支持的模型

尺寸限制 ⚠️（Seedream 路由）

请求

请求字段

响应

常见 4xx 原因

相关