Skip to main content
Nano Banana 2.1 支持 Gemini 原生流式接口:POST https://code.heihuzi.ai/v1beta/models/gemini-nano-banana-2.1:streamGenerateContent?alt=sse,请求体与图像生成相同。验证日期:2026-10-08。

真实观测

两次都只收到一个事件,里面同时包含完整图片、finishReason 和 usageMetadata;没有预览图或分段图片。流式的作用是在等待期间保持连接,不会更早拿到图片。上表是实测耗时记录,不是响应时间承诺。

cURL 保存原始事件流

完整事件流保存到 stream.sse。每个事件是一行 data: {...},{...} 的结构与非流式响应相同,不能把整个文件当作一个 JSON 读取。 实测的事件流格式:data: 后面是一整行 JSON,接着一个空行;换行符为 \n;没有 [DONE] 之类的结束标记,事件发完后连接结束。边收边解析时按标准 SSE 处理即可。图片在这一行里,1K 时这一行实测约 2 MB,2K 实测约 6 MB,逐行读取时不要设过小的单行长度上限。 请求参数有误时(例如比例写成 5:3),实测直接返回 HTTP 400:响应体是一段普通 JSON 错误(格式见错误响应),没有 data: 前缀,但 Content-Type 仍为 text/event-stream。请先判断 HTTP 状态码,只在 200 时按事件流解析。下面的命令取出其中的图片,保存为 stream.jpg:

Python SDK 流式保存图片

官方工具包从 google-genai 1.49.0 起才有 image_size 参数,1.47.0 实测会报错。这段代码已用 google-genai==2.28.0(需要 Python 3.10 及以上)真实执行,收到一个事件并保存 1024×1024 JPEG 到 stream-1.jpg。
以收到可解码的图片为成功依据,不要假设一定会先收到预览。