流式与 WebSocket

Codex Relay 支持普通 HTTP、SSE 流式响应，以及兼容客户端使用的 Responses WebSocket 入口。

SSE 流式响应

在请求体中设置：

{
  "stream": true
}

使用 curl 时加 -N，避免本地缓冲：

curl -N https://codexapi.asia/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "input": "Count from one to five.",
    "stream": true
  }'

流式模式能更早显示首批内容，但不会降低模型本身的计算时间。

WebSocket

Responses WebSocket 使用：

wss://codexapi.asia/v1/responses

仅在客户端明确支持 Responses WebSocket 时开启。普通 OpenAI SDK 和 Chat Completions 客户端通常使用 HTTP/SSE，不需要手动改成 WebSocket。

代理注意事项

• Cloudflare 和反向代理必须允许长连接与 WebSocket Upgrade。
• 客户端超时应覆盖模型排队、推理和工具调用时间。
• 不要缓存 /v1/* API 响应。
• 连接中断后，只对幂等或可安全重放的请求重试。

如何选择

模式	适合场景
非流式 HTTP	脚本、短请求、需要一次性 JSON
SSE	聊天、Codex、OpenAI SDK 与长文本生成
WebSocket	明确实现 Responses WS 的客户端与连续会话