Skip to main content

为什么提交异步任务返回 404?

2026-09-10 对 /v1/images/generations/async 和 /v1/images/edits/async 的真实请求均返回 404,错误为 async image tasks are not enabled。当前文档提供同步生成、同步编辑和连接内流式返回。

开启流式为什么没有预览图?

已观测到请求 partial_images: 1 或 2 时只有完成事件的结果,也观测到预览先到、完成随后到的结果。按完成事件保存最终图片,不把预览数量当作成功条件。

为什么生成返回 403?

无图片权限的文本 Key 请求 Images 时实测返回 Image generation is not enabled for this group。使用图片 Key 后,同一入口已成功返回有效图片。

为什么编辑返回 400?

已复现缺少参考图、images[].file_id、mask.file_id 的错误。JSON 使用 images[].image_url;文件上传使用 image 或 image[],示例见图像编辑。

怎样确认透明图片有效?

本次 Flare、Sunburst 的 PNG 和 WebP 透明组合均检查到 alpha 通道中的透明像素。按已测参数组合填写,并保存 base64 解码后的原文件。

Nano Banana 2.1 用 /v1/images/generations 为什么返回 404?

2026-10-08 用「Nano Banana 2.1 画图」分组 Key 请求 /v1/images/generations,模型填 gemini-nano-banana-2.1 或旧 ID gemini-3.1-flash-image 都返回 404:Images API is not supported for this platform。Nano Banana 2.1 使用 Gemini 原生接口,见 Nano Banana 2.1 图像生成。

Nano Banana 2.1 返回什么格式、多大尺寸?

本次所有返回都是 JPEG。尺寸由 aspectRatio 和 imageSize 决定,实际像素见尺寸表。谷歌官方说明不填比例时由模型决定、有参考图时参照参考图;本次完全不填 imageConfig 实测返回 1376×768,带参考图且不填比例时沿用了参考图比例。需要固定比例请显式填写。

Nano Banana 2.1 为什么返回 400?

已复现:不支持的比例(如 5:3)、不支持的清晰度(512 即 0.5K、8K 等;可用 1K、2K、4K,请用大写 K)、不支持的思考档位(low;可用 minimal、medium、high)、缺少 contents。错误信息会列出可用的取值。不提供 Key 返回 401,请求本分组不支持的模型返回 404。

Nano Banana 2.1 的响应为什么很大?

图片旁边会附带模型的思考签名 thoughtSignature,单次生成用不到,可以忽略。实测 1K 响应约 1.5~2.4 MB,2K 约 5.8 MB,14 张参考图约 7 MB,4K 约 18 MB;请按 20 MB 以上预留内存,并设置足够的超时。

默认尺寸是 1024×1024 吗?

本次省略尺寸的测试返回 1254×1254。需要 1024×1024 时,显式发送 size: "1024x1024"。