跳转到主要内容
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-4-5-251128",
  "prompt": "A cute red panda, ultra-detailed, cinematic lighting",
  "n": 1,
  "size": "2048x2048"
}
'
{
  "model": "seedream-4-5-251128",
  "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 端点。目前路由到 ByteDance Seedream（seedream-4-5-251128）。Wan 2.7 模型不使用此路径——请参阅通过 Chat 生成图像。

​
路由概览

模型端点
seedream-4-5-251128POST /v1/images/generations （本页）
wan2.7-image / wan2.7-image-proPOST /v1/chat/completions
兼容 Gemini 的模型POST /v1beta/models/{model}:generateContent

​
支持的模型

模型每张图像费用说明
seedream-4-5-251128$0.040最小图像尺寸为 3,686,400 像素（例如 1920×1920）

​
尺寸限制 ⚠️

Seedream 的上游服务要求图像至少包含 3,686,400 像素。低于该值的请求将被拒绝，并返回： 
400 InvalidParameter: image size must be at least 3686400 pixels
尺寸像素数是否接受？
1024x10241,048,576❌
1536x15362,359,296❌
1920x19203,686,400✅（恰好达到阈值）
2048x20484,194,304✅
2304x16003,686,400✅
2560x19204,915,200✅
只要满足 width × height ≥ 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-4-5-251128",
    "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-4-5-251128",
    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-4-5-251128",
  prompt: "A cute red panda, ultra-detailed, cinematic lighting",
  n: 1,
  size: "2048x2048",
});

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

​
请求字段

字段类型必填说明
modelstring是seedream-4-5-251128
promptstring是对要生成的图像进行文本描述
ninteger否图像数量。每张图像单独按 $0.040 计费
sizestring是WIDTHxHEIGHT。必须满足 width × height ≥ 3,686,400

​
响应

{
  "model": "seedream-4-5-251128",
  "created": 1776495432,
  "data": [
    {
      "url": "https://cdn.aisa.one/images/seedream/...",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384
  }
}
与原生 OpenAI 架构相比，AIsa 的响应增加了一些扩展字段：
  • 根级别回显的 model
  • data[].size——每张返回图像的实际尺寸
  • usage——包含用于计费的 generated_images，以及用于词元统计的 output_tokens / total_tokens
data[].url 中的 URL 短期有效。请在过期前下载图像并将其持久化到你自己的存储中。

​
常见 4xx 原因

  • 400 InvalidParameter — image size must be at least 3686400 pixels——size 太小。请使用 1920x1920 或更大的尺寸。
  • 404 openai_error——传入的模型未通过此端点路由（例如 wan2.7-image）。请改用基于 Chat 的路由。
  • 400 invalid_request——size 字符串格式错误（例如使用 1024，而不是 1024x1024）。
更多信息请参阅错误代码和速率限制。

​
相关内容

通过 Chat 生成图像

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

Gemini generateContent

兼容 Gemini 的 generateContent 端点。

媒体生成技能

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

授权

​
Authorization
string
header
必填

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

请求体

application/json
​
model
enum<string>
必填

图像生成模型。目前只有 seedream-4-5-251128 通过此端点路由。Wan 2.7 模型使用 /v1/chat/completions。

可用选项:
seedream-4-5-251128
​
prompt
string
必填

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

​
n
integer
默认值:1

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

必填范围: x >= 1
​
size
string

图像尺寸，格式为 WIDTHxHEIGHT。必须满足 width × height ≥ 3,686,400。常见有效值：1920x1920、2048x2048、2304x1600、2560x1920。

示例:

"2048x2048"

响应

图像生成成功。

​
model
string
示例:

"seedream-4-5-251128"

​
created
integer
示例:

1776495432

​
data
object[]

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

​
usage
object