更新日志

参考图：仅支持 PNG、JPEG 和 WebP

无论是通过 POST /uploads 上传，还是通过 image_urls 中的链接提供，都不再接受 GIF 和 BMP 文件。这类请求会在扣费前收到 400 ERR_INVALID_REQUEST，文本为“Unsupported image format. Supported formats: PNG, JPEG, WebP.”。

• 格式按文件内容判断，而不是按扩展名。
• 自 10月1日起，不再接受 ICO。
• 此前上传的文件不受影响。

移除了放大和删除背景的端点

端点 POST /images/upscale 和 POST /images/remove-background 不再存在：对它们的请求会收到 404，和对任何未知地址的请求一样。

API 中的 Nano Banana 2.1

Google 推出的最新 Nano Banana 系列模型：画面逼真，严格遵循提示词，角色稳定，文字清晰。

• 分辨率为 1K、2K 和 4K。未指定分辨率时，默认为 2K。
• aspect_ratio 有十五个值：十种常规宽高比，细长的 1:4、4:1、1:8 和 8:1，以及 auto。
• 单个请求最多 14 张参考图。

空提示词会在扣费前被拒绝

没有提示词的生成请求（字段缺失、值为 null、空字符串或只有空格）会收到 400 ERR_INVALID_REQUEST。哪个字段未填写，可在 details.fields 中看到。这类请求不会扣费。

{
  "error": {
    "code": "ERR_INVALID_REQUEST",
    "message": "A prompt is required. Describe the image to generate in the prompt.",
    "details": { "fields": ["prompt"] }
  }
}

两个错误码的 422 和 500 状态码

两个错误码有了各自的 HTTP 状态。没有任何 API 错误码使用 502 或 504 状态。

• 422 ERR_INPUT_FETCH_FAILED：无法下载或检查参考图。该请求未扣费。
• 500 ERR_GENERATION_FAILED：无法启动或完成生成。已扣除的费用会自动退回。

GPT Image 2.5 Sunburst 和 Flare 支持 1K、2K 和 4K

GPT Image 2.5 系列的两款模型，用于高分辨率图片。两款模型均支持 1K、2K 和 4K，并支持八种宽高比。

• 模型在 model 字段中选择，分辨率在 resolution 字段中指定。未指定分辨率时，默认为 1K。
• GPT Image 2.5 Sunburst 的特点是细节处理精准。

失败任务中的 failure 字段

失败任务的 error 文本旁新增了 failure 对象，出现在轮询任务的响应和 creation.failed Webhook 中。通过它可以看出请求是被拒绝（declined）还是发生了错误（error），以及是否值得重试（retryable）。

"failure": { "type": "declined", "code": "content_policy", "retryable": false }