成本查询限窗过滤;桶级 PAR 放开列举

docs/AI网关.md

@@ -196,7 +196,9 @@ Codex 工具兼容现状：
 > 同一请求改为非流式实测可正常完成；单独扩大 `input` 未触发该限制。
 
 该问题于 2026-07-13 通过字节级二分定位，2026-07-16 在 Chicago 复测仍存在：
-`70.4 KB` 断流、`59.7 KB` 正常，API Key 与签名鉴权表现一致。本文及设置页中的
+`70.4 KB` 断流、`59.7 KB` 正常，API Key 与签名鉴权表现一致。2026-07-21
+再次复测（Chicago 签名路径）仍未修复：`70,463 B` 两次均在数个推理 delta 后纯
+EOF，同时段 `59,651 B` 对照正常 `completed`。本文及设置页中的
 `KB` 均按 `1024 B` 计算。
 
 | 协议 | 网关保护 | 客户端表现 |
@@ -221,13 +223,25 @@ Responses 合成的最小事件序列为：`response.created` →
 ### `multi-agent` 加密推理内容流式断流
 
 > [!WARNING]
-> 当 `multi-agent` 请求同时启用 `stream: true` 与
-> `include: ["reasoning.encrypted_content"]` 时，上游可能在序列化大体量
-> `encrypted_content` 事件期间静默断开连接，且不返回 `error` 或终态事件。
->
-> 已复现场景中的断点位于 `output_index: 8` 附近：第三次搜索结束后，上游准备
-> 发送较大的加密推理块时连接被中止。`multi-agent` 产生的加密推理内容体积较大，
-> 因而更容易暴露该上游流式序列化缺陷。
+> `xai.grok-4.20-multi-agent` 请求同时启用 `stream: true` 与
+> `include: ["reasoning.encrypted_content"]` 时，上游高概率在序列化大体量
+> `encrypted_content` 事件期间静默断开连接，不返回 `error` 或终态事件。
+> 断点常见于 `output_index: 8` 附近（第三次搜索结束后的大加密推理块），
+> 也观测到更早（推理起始阶段）与更晚（15 块之后的文本输出阶段）断开。
+
+2026-07-21 复测仍存在，并进一步定界：
+
+- 网关(Phoenix 渠道 API Key)四次全断：两次断于 `output_index: 8` 搜索阶段
+  （此前 8 块加密内容累计约 `364 KB`），一次收满 15 块约 `762 KB` 后断于文本
+  输出；Chicago 签名直发同样可断（亦有一次仅 2 块 `35 KB` 的小规模会话正常
+  完成）——与区域、鉴权方式无关，与加密块规模相关。
+- 该模型单块 `encrypted_content` 约 `47 KB`，比 `xai.grok-4.3`（约
+  `2-10 KB`）大一个量级；`grok-4.3` + `web_search` + 同 `include` 在累计
+  `148 KB` 加密内容、`output_index: 15` 下流式完整——断流特定于
+  `multi-agent` 模型的大加密块序列化。
+- 对照：同请求仅改 `include: ["web_search_call.action.sources"]`（不含加密
+  推理）正常完成。规避方式：该模型流式时不请求
+  `reasoning.encrypted_content`。
 
 ### ZDR 与文件输入
 

docs/docs.go

@@ -2682,7 +2682,7 @@ const docTemplate = `{
                     },
                     {
                         "type": "string",
-                        "description": "起始时间 RFC3339,缺省为 endTime-30 天",
+                        "description": "起始时间 RFC3339,缺省为 endTime-30 天;返回行严格限于 [startTime, endTime) 窗口(Usage API HOURLY 粒度会把起点下扩到 UTC 日零点,越界行已在服务端过滤)",
                         "name": "startTime",
                         "in": "query"
                     },

docs/swagger.json

@@ -2675,7 +2675,7 @@
                     },
                     {
                         "type": "string",
-                        "description": "起始时间 RFC3339,缺省为 endTime-30 天",
+                        "description": "起始时间 RFC3339,缺省为 endTime-30 天;返回行严格限于 [startTime, endTime) 窗口(Usage API HOURLY 粒度会把起点下扩到 UTC 日零点,越界行已在服务端过滤)",
                         "name": "startTime",
                         "in": "query"
                     },

docs/swagger.yaml

@@ -4587,7 +4587,8 @@ paths:
         name: id
         required: true
         type: integer
-      - description: 起始时间 RFC3339,缺省为 endTime-30 天
+      - description: 起始时间 RFC3339,缺省为 endTime-30 天;返回行严格限于 [startTime, endTime) 窗口(Usage
+          API HOURLY 粒度会把起点下扩到 UTC 日零点,越界行已在服务端过滤)
         in: query
         name: startTime
         type: string