图片生成

通过 OpenAI 的 Images API，根据提示词生成图片：Nano Banana、GPT Image、Grok Imagine 和 FLUX 3，各只需一次调用。

生成图片

import os
from openai import OpenAI
client = OpenAI(base_url="https://api.zurelay.com/v1", api_key=os.environ["ZURELAY_API_KEY"])
result = client.images.generate(
    model="nano-banana-pro",
    prompt="A red fox curled up asleep in fresh snow at dawn, soft golden light, 85mm photo",
    size="2K",
    extra_body={
      "aspect_ratio": "3:2"
    },
)
print(result.data[0].url)

{
  "created": 1790870400,
  "data": [
    { "url": "https://...signed link, valid for 24 hours..." }
  ]
}

参数

尺寸

Nano Banana 按分辨率计费，并严格按指定尺寸生成：如果返回的图片尺寸偏小，会重新尝试，不会交付。1K 对应的尺寸如下：

Grok Imagine 在 1K 下生成约 100 万像素的图片，在 2K 下约为 400 万像素，具体尺寸由模型决定（1K 下的 16:9 为 1280 × 720）；如果宽高比或分辨率不符，会重新尝试，不会交付。详见 Grok Imagine Image 指南。

FLUX 3 在 1K 下生成约 100 万像素的图片，2K 下约为 400 万像素，4K 下约为 1600 万像素，支持从 21:9 到 9:21 的 15 种宽高比；如果尺寸小于要求或宽高比不符，会重新尝试，不会交付。详见 FLUX 3 指南。

GPT Image 2 所有尺寸均为同一价格：1024x1024, 1536x1024, 1024x1536, 2048x2048, 3840x2160, 2160x3840。GPT Image 2.5 Flare 和 Sunburst 按尺寸计费：不超过 1024 × 1024 为 1K，不超过 2560 × 1440 为 2K，更大的尺寸为 4K。未指定尺寸或设为 auto 时，生成尺寸为 1024 × 1024。

链接与历史记录

• url 中的链接带有签名，有效期为 24 小时。需要保留的图片请及时下载。
• 以 url 返回的图片也会在控制台的素材库中保留 30 天，可在其中下载、删除或用作参考图片。以 b64_json 返回的图片不会存储。
• 每张存储的图片都会保留其生成提示词，并在控制台中显示在图片旁。图片和提示词均会在 30 天后删除。

耗时

大多数图片会在 10 到 60 秒内生成，4K 图片耗时更长。如果某次尝试停滞，请求会自动通过其他路径重试，因此请将客户端超时时间设为 10 分钟。也可以完全不用等待：添加 callback_url，图片生成后就会发送到你的服务器（详见回调）。

图片未生成时

如果模型拒绝某个提示词（例如因内容政策限制），会返回 400 image_not_generated 及模型给出的原因，且不收费。当 n 大于 1 时，会返回已生成的图片，并仅对这些图片收费。