stream: true,实际响应为 text/event-stream。流式完成与预览数量是两件事:收到可解码的完成图片,才能确认本次生成或编辑完成。
验证日期:2026-09-10。测试参数为 n: 1、size: "1024x1024"、quality: "low"、output_format: "png"。
真实观测
下表列出partial_images: 1 的四次调用;时间从发送请求开始计算,供理解事件先后顺序。
进一步测试
partial_images: 2 时,Flare 生成返回一张预览,Sunburst 生成只返回完成图片。因此,客户端需要处理零张或少于请求值的预览。上表是实测耗时记录,不是响应时间承诺。
partial_images 的 0、1、2、3 已分别验证;0 的调用只收到完成图片,-1 和 4 返回 400。最终张数由 n 指定,本页流式示例使用 n: 1。
cURL 保存原始事件流
stream.sse,不能把整个文件当作一个 JSON 文档读取。
Python SDK 保存预览和最终图片
以下完整代码已用openai==2.32.0 实际运行,并检查生成的 PNG 文件。预览和完成事件的 b64_json 分别保存。
编辑流式
在JSON 编辑请求中加入stream: true 和 partial_images: 1,保留参考图数组。Flare、Sunburst 的这组请求均已验证。
编辑使用 image_edit.partial_image / image_edit.completed,生成使用 image_generation.partial_image / image_generation.completed。原始 SSE 以空行分隔事件,data: 为事件 JSON;接收端应持续读取到流结束并保存最终图片。未收到完成图片时,应记录响应并排查。