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。