生成图片

根据文本提示词生成图片。接口定义以 OpenAI 官方 Create image 接口为准。

接口信息

模型选择

下方调用示例使用按次模型；如需使用官方模型，替换请求中的 model 参数即可。

调用示例

curl https://token.aiznt.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的aiznt密钥" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "A cute baby sea otter",
    "n": 1,
    "size": "1024x1024"
  }'

{
  "created": 1713833628,
  "data": [
    {
      "b64_json": "..."
    }
  ],
  "usage": {
    "total_tokens": 100,
    "input_tokens": 50,
    "output_tokens": 50,
    "input_tokens_details": {
      "text_tokens": 10,
      "image_tokens": 40
    }
  }
}

请求参数

基础参数

prompt

类型：string，必填

对所需图片的文本描述。GPT Image 模型最多支持 32,000 个字符，dall-e-2 最多支持 1,000 个字符，dall-e-3 最多支持 4,000 个字符。

background

类型："transparent" | "opaque" | "auto" | null，可选

设置生成图片的背景，仅 GPT Image 模型支持。transparent 表示透明背景，opaque 表示不透明背景，auto 表示由模型自动确定最佳背景（默认值）。

gpt-image-2.5-sunburst、gpt-image-2.5-flare 及其 2026-09-08 日期快照支持 opaque 和 transparent。其他支持透明背景的 GPT Image 模型也可以使用 transparent；gpt-image-2 和 gpt-image-2-2026-04-21 的透明背景功能目前处于预览阶段。使用透明背景时，须将 output_format 设置为 png 或 webp。

model

类型：string | ImageModel | null，可选

用于生成图片的模型。平台模型名称分为：

• 按次模型：gpt-image-2、gpt-image-2.5-sunburst、gpt-image-2.5-flare
• 官方模型：gpt-image-2-2026-04-21、gpt-image-2.5-sunburst-2026-09-08、gpt-image-2.5-flare-2026-09-08

moderation

类型："low" | "auto" | null，可选

控制 GPT Image 模型生成图片时的内容审核级别。low 表示限制较少，auto 为默认值。

n

类型：number | null，可选

要生成的图片数量，取值范围为 1 至 10。dall-e-3 仅支持 n=1。

输出控制

output_compression

类型：number | null，可选

生成图片的压缩级别，取值范围为 0 至 100（百分比），默认值为 100。仅 GPT Image 模型在输出格式为 webp 或 jpeg 时支持。

output_format

类型："png" | "jpeg" | "webp" | null，可选

生成图片的输出格式，仅 GPT Image 模型支持。可选值为 png、jpeg 或 webp。

partial_images

类型：number | null，可选

流式响应中要生成的部分图片数量，取值范围为 0 至 3。设为 0 时，响应只通过一个流式事件发送最终图片。如果完整图片生成得更快，服务端可能在达到指定的部分图片数量之前就返回最终图片。

quality

类型："standard" | "hd" | "low" | "medium" | "high" | "xhigh" | "max" | "auto" | null，可选

• auto：根据模型自动选择最佳质量，默认值
• high、medium、low：GPT Image 模型支持
• xhigh、max：gpt-image-2.5-sunburst、gpt-image-2.5-flare 及其 2026-09-08 日期快照支持
• hd、standard：dall-e-3 支持
• standard：dall-e-2 唯一支持的选项

流式与兼容参数

response_format

类型："url" | "b64_json" | null，可选

设置 dall-e-2 和 dall-e-3 生成图片的返回格式。可选值为 url 或 b64_json，图片 URL 生成后仅在 60 分钟内有效。

GPT Image 模型不支持此参数，始终返回 Base64 编码的图片。

size

类型：string | "auto" | null，可选

• GPT Image 模型支持标准尺寸 1024x1024、1536x1024 和 1024x1536；允许自动选择尺寸的模型还支持 auto
• gpt-image-2、gpt-image-2-2026-04-21、两种 GPT Image 2.5 模型及其 2026-09-08 日期快照支持 宽x高 格式的任意分辨率，例如 1536x864
• dall-e-2 支持 256x256、512x512 和 1024x1024
• dall-e-3 支持 1024x1024、1792x1024 和 1024x1792

使用上述支持任意分辨率的模型时，宽和高都必须是 16 的倍数，宽高比必须在 1:3 至 3:1 之间，并且还须满足模型当前的像素数和边长限制。高于 2560x1440 的分辨率属于实验性功能，最高支持 3840x2160。

stream

类型：boolean | null，可选

是否使用流式模式生成图片，默认值为 false。仅 GPT Image 模型支持。

style

类型："vivid" | "natural" | null，可选

设置生成图片的风格，仅 dall-e-3 支持。vivid 倾向于生成超现实、戏剧化的图片；natural 倾向于生成更自然、较少超现实感的图片。

user

类型：string，可选

代表最终用户的唯一标识，可用于监控和检测滥用行为。

返回结果

接口返回 ImagesResponse 对象。

data 图片字段

usage 用量字段