codex 内置网络检索不可用，客户端提示解码错误

[y-cruce]

codex使用内置的websearch工具进行检索出现：

Fatal error: stream error: failed to decode search response:
expected value at line 1 column 1

版本： 0.1.146
账号： 官方oauth

[zvensmoluya]

确实是。不知道是什么问题。5.6使用网络工具会失败

[y-cruce]

ps: 在codex-cli 141版本以及codex desktop macos 中使用 gpt-5.6-sol 进行了测试，都可以复现问题

[SilentFlower]

我的似乎不会调websearch了，只会curl查了

[y-cruce]

@Wei-Shaw 麻烦关注一下这个问题

[GordonChowkk]

我也遇到这个问题了，包括149的版本也一样会这样

[zvensmoluya]

5.6会有问题，解析失败。切换模型5.5马上就能成功，看了一下codex那边的代码好像最近没怎么动。websearch工具好像也主要是codex那边处理的，我估计是OpenAI的bug。

[sleshep]

gpt-5.6模型不走服务端web search了，改走单独的/alpha/search端点了。sub2api没实现这个转发，因此用不了。

[sleshep]

我查了，codex目前没有通过配置禁用这个新的/alpha/search的能力。

[fairrog]

补充定位：GPT-5.6 使用独立 alpha/search，sub2api 当前缺少转发

我对照了 Codex 和 sub2api 当前源码，并在 sub2api main 上做了路由回归测试。结论是：这个问题需要在 sub2api 服务端修复。

原因链

1. GPT-5.6 的 Codex 模型元数据启用了：

{
  "tool_mode": "code_mode_only",
  "use_responses_lite": true,
  "supports_search_tool": true
}

2. Codex 在 use_responses_lite = true 时，不会把 hosted web_search 放进 /responses 请求，而是启用 standalone web search extension。

3. standalone search 客户端使用固定相对路径：

fn path() -> &'static str {
    "alpha/search"
}

所以实际请求地址为 {provider_base_url}/alpha/search。

4. sub2api 当前没有注册对应路由。实测以下三个入口全部返回 404：

POST /v1/alpha/search
POST /alpha/search
POST /backend-api/codex/alpha/search

Gin 默认返回纯文本 404 page not found，而 Codex 会把响应按 JSON 解码，因此最终报错：

failed to decode search response: expected value at line 1 column 1

这也解释了为什么 GPT-5.5 可以搜索，而 GPT-5.6 失败：GPT-5.5 当前模型配置是 use_responses_lite: false，仍可走原有 hosted web search 路径。

建议修复

建议新增独立 handler，例如：

func (h *OpenAIGatewayHandler) AlphaSearch(c *gin.Context)

并注册：

POST /v1/alpha/search
POST /backend-api/codex/alpha/search
POST /alpha/search  // 可选兼容别名

不要接入现有 handleWebSearchEmulation。后者处理的是 /responses 请求体内的 hosted tool 仿真，这里是独立 HTTP 路径协议。

OAuth/Codex 账号

上游应转发到：

https://chatgpt.com/backend-api/codex/alpha/search

建议复用现有 Codex Responses 链路中的：

• OAuth access token 获取和刷新
• OpenAI 账号调度、代理和故障切换
• chatgpt-account-id / x-openai-fedramp
• Codex User-Agent / Originator / Version 身份头
• 限流及上游错误处理

OpenAI API Key 账号

默认上游应为：

https://api.openai.com/v1/alpha/search

自定义 base URL 应按现有 URL 规范化逻辑拼接。例如 base URL 为 https://example.com/v1，目标应为 https://example.com/v1/alpha/search。

请求和响应

• 请求 JSON 原样转发，避免绑定不稳定的 alpha schema
• 保留 query 参数
• 设置 Accept: application/json
• 响应 body、HTTP 状态码、Content-Type 原样返回
• 可透传 x-request-id 等诊断头
• 请求中的 model 用于账号能力筛选
• 请求中的 id 可作为粘性调度键，避免同一搜索会话切换账号

当前 Codex 期待的响应至少包含：

{
  "encrypted_output": "optional ciphertext",
  "output": "search result"
}

建议 sub2api 不解析或重建该结构，直接 JSON 透传。

最小复现

curl -i https://SUB2API_HOST/v1/alpha/search \
  -H 'Authorization: Bearer SUB2API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
    "id": "search-session-test",
    "model": "gpt-5.6-sol",
    "commands": {
      "search_query": [{"q": "杭州天气"}]
    },
    "settings": {
      "allowed_callers": ["direct"],
      "external_web_access": true
    },
    "max_output_tokens": 2000
  }'

当前结果是 HTTP 404；修复后应返回 JSON 搜索结果。

建议测试

• 三个兼容入口的路由注册测试
• OAuth 上游 URL、token、ChatGPT account headers 和请求体透传测试
• API Key 默认及自定义 base URL 测试
• 200、401、403、429、5xx 状态和 JSON 正文透传测试
• 非 OpenAI group 返回结构化 JSON 错误
• Codex CLI/Desktop + gpt-5.6-sol 端到端搜索回归

验收标准

• GPT-5.6 在 Codex CLI 和 Desktop 中可以正常使用内置 web search
• /v1/alpha/search 和 /backend-api/codex/alpha/search 不再返回 404
• 不再出现 failed to decode search response
• GPT-5.5 和现有 /responses 行为不受影响
• OAuth 与 API Key 两种账号类型均有覆盖

补充：OpenAI 公开 API 的推荐搜索方式仍是 /v1/responses 加 tools: [{"type":"web_search"}]。这里的 alpha/search 是 Codex Responses Lite 使用的独立兼容端点，不代表公开 API 已全面迁移。