Merge pull request #4219 from zh239ns/codex/fix-openai-images-nonstream-keepalive

fix(images): add opt-in non-stream JSON keepalive

deploy/.env.example

@@ -319,13 +319,15 @@ GATEWAY_SCHEDULING_OUTBOX_BACKLOG_REBUILD_ROWS=10000
 GATEWAY_SCHEDULING_FULL_REBUILD_INTERVAL_SECONDS=300
 
 # -----------------------------------------------------------------------------
-# Image Generation Stream & Concurrency (Optional)
-# 图片生成流式与并发隔离配置（可选）
+# Image Generation Keepalive & Concurrency (Optional)
+# 图片生成保活与并发隔离配置（可选）
 # -----------------------------------------------------------------------------
 # 图片流式上游数据间隔超时（秒）。0 表示禁用；非 0 时必须为 60-1800。
 GATEWAY_IMAGE_STREAM_DATA_INTERVAL_TIMEOUT=900
 # 图片流式 keepalive 间隔（秒）。0 表示禁用；非 0 时必须为 5-60。
 GATEWAY_IMAGE_STREAM_KEEPALIVE_INTERVAL=10
+# 图片非流式 JSON keepalive 间隔（秒）。默认 0 禁用；首个心跳后 HTTP 状态会固化为 200。
+GATEWAY_IMAGE_NONSTREAM_KEEPALIVE_INTERVAL=0
 # 是否启用进程级图片生成并发限制。默认 false，保持历史行为。
 GATEWAY_IMAGE_CONCURRENCY_ENABLED=false
 # 当前进程允许同时处理的图片生成请求数。0 表示不限制。

deploy/config.example.yaml

@@ -390,6 +390,9 @@ gateway:
   # Image stream keepalive interval (seconds), 0=disable; independent from ordinary text streams
   # 图片流式 keepalive 间隔（秒），0=禁用；独立于普通文本流式
   image_stream_keepalive_interval: 10
+  # Non-streaming Images JSON keepalive interval (seconds), 0=disable; commits HTTP 200 after the first heartbeat
+  # 图片非流式 JSON keepalive 间隔（秒），0=禁用；首个心跳后 HTTP 状态会固化为 200
+  image_nonstream_keepalive_interval: 0
   # Image generation independent concurrency limiter (process-local, default disabled)
   # 图片生成独立并发限制（进程级，默认关闭；多实例总上限约为实例数×该值）
   image_concurrency: