Add grok-superimage support, server-side image config and resilient streaming/error handling

[lijirou12]

Motivation

• Introduce a server-controlled image model (grok-superimage-1.0) with centralized n/size/response_format so clients cannot override those params.
• Improve streaming reliability by converting transport 5xx/exception failures into SSE error events for streaming endpoints and returning one-shot SSE error payloads for immediate stream errors.
• Make token retry logic more robust by retrying on transient upstream errors when alternative tokens exist and improve reverse proxy handling for SOCKS proxies.

Description

• Added new model entry grok-superimage-1.0 in ModelService and default config section [superimage] in config.defaults.toml with n, size, and response_format keys, and updated readme.md and admin UI (app/static/admin/js/config.js) to expose these options.
• Enforced server-side image config for grok-superimage-1.0 via _superimage_server_image_config() and used it during request validation instead of client-provided image_config when that model is selected.
• Implemented _safe_sse_stream() and _streaming_error_response() in the chat route to catch exceptions during async streams and emit SSE error events (and [DONE]), and wrapped streaming returns from ImageGenerationService, ImageEditService, ChatService, and VideoService accordingly; also added try/except around non-image ChatService/VideoService calls to return SSE error responses when stream is not explicitly false.
• Image streaming processors (image.py and image_edit.py) now suppress intermediate partial previews for chat-format streams, track whether any chat chunk was emitted, and always emit a final empty chat chunk plus data: [DONE] if no final chunk was produced.
• Added transient_upstream() detection in app/services/grok/utils/retry.py and used it in ChatService to attempt alternative tokens on transient upstream failures; exported the symbol from the module.
• Improved reverse app chat proxy handling in app/services/reverse/app_chat.py to detect SOCKS schemes and pass them via proxy to curl_cffi while using proxies for HTTP(S) proxies, and adjusted timeout selection logic.
• Small API surface/rename cleanup in admin config route to avoid shadowing get_storage by renaming the local resolver import to resolve_storage and the route to get_storage_mode.

Testing

• Ran the project test suite with pytest and all tests passed.
• Ran static checks/linter (flake8/format checks) and they succeeded.

---

Codex Task

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
grok2api	Building	Preview, Comment	Feb 26, 2026 0:28am

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.