Files
Agent-Workbench/docs/APIKEY-ROUTE-L-INVESTIGATION.md
T

8.0 KiB
Raw Blame History

apikey Claude接入调查

后续N更正:用户确认这把Key实际属于GPT分组,原型号误填Claude。L发现的“当时缺少Messages适配”是产品能力边界,不是该GPT连接故障的根因证明。Messages后由M独立交付,当前连接已按GPT/Responses校正并保留停用;见复查。以下为分组尚未确认时的历史调查,原证据保持。

本次确定了工作台的协议接入缺口:1.24.3尚未实现Anthropic Messages,现有apikey连接使用Chat Completions,其地址拼接也与供应商公开示例不同。原预检的GPT标识确实出现在上游原SSE;没有发现工作台将所选Claude请求替换成legacy GPT或把返回型号按默认模型填充的证据。供应商内部为何返回这个标识、这把Key的分组与映射,仍未得到验证。

本报告记录2026-11-03的调查,源码与已安装版本来源均为f53eebb7171f169ac3620b93bdbd9b8bc6ba3401。这是诊断结果,不是新协议已经上线的发行说明。

已确认的事实

项目 原J样本 / 当前实现 供应商公开文档
请求型号 claude-opus-5-5,单独指定apikey连接,poolId=null Claude示例同名
协议 Chat Completions,SSE Claude脚本示例为Anthropic Messages
拼接地址 https://api.apikey.fan + /chat/completions Chat示例为https://api.apikey.fan/v1/chat/completions;Claude示例为https://api.apikey.fan/v1/messages
原响应 HTTP200,23个JSON data事件,所报告型号只有gpt-6.1-sol,另有[DONE] Chat示例请求GPT;Messages示例请求Claude
工作台支持范围 仅chat-completions和responses,没有Messages适配器 Claude Code教程通过Anthropic客户端使用根地址

供应商来源:API脚本教程、Claude Code教程。公开页面原观察与截图已保存:API文档、Claude手动说明、截图。只读访问,未登录或执行文档中的安装命令。

Claude Code教程把ANTHROPIC_BASE_URL写成域名根地址,由其客户端追加Messages路径。工作台Chat适配器则把/chat/completions直接追加到用户填写的根地址。两种客户端的根地址填写规则不同,不能照抄同一个值就视为同一种Claude接入。仅增加/v1只能对齐Chat路径,不能把Chat请求转换成Messages协议。

公开示例也不能证明该服务绝不支持Chat调用Claude;它没有给出原请求所在Key分组或Chat到Claude的兼容映射依据。因此“协议/路径与Claude示例不一致”是已确认事实,“这就是服务端返回GPT的唯一原因”仍是未证实推断。

原字节与代码核对

原请求SHA-256为0820d369158abe498f72811970cc6667ff49579394ecf10c7fa3b8b4bde67b28,发送字段是Claude;原响应SHA-256为af7ed87879b9a8af76850f26c4274a4684a72c19900c8c46a4c5e83b97dab6e0,responseRedacted=false,型号字段直接是GPT。原J清单、30份原件及4334报告tokens均再次离线核对通过,没有重发这次请求。

所审查的八个源码模块逐字节与最终1.24.3发行冻结输入一致,见源码身份。实际链路为:

  1. actualRequest取所选成员对应的请求体;ModelHub保存实际请求SHA,再把同一请求体、成员地址、成员凭据交给Provider。
  2. Provider发送base + route与JSON.stringify(body)。请求型号不从左下角旧连接重新读取;protocolRoute仅返回/responses或/chat/completions。
  3. 流读取器先把收到的JSON事件交给型号观察器,再处理文字和工具;观察器读取事件自己的model,没有缺省GPT回填。
  4. 原响应字节保存为工件。原J标记没有脱敏改写,完整响应的型号不一致触发严格暂停、保留用量,工具数为0。

原J上游请求ID为225f0a8c-60e6-4fca-a8f8-2baeabf3238b, 3e0f36b5-5266-4d1b-b9f0-cd75ae32edb9,时间为2026-11-03T05:25:12.732Z。这些信息可供供应商查内部路由,本轮没有向其发送用户日志或联系消息。响应ID前缀等外观只能作线索,不能认证底层权重。

原封存保存了endpoint与route,但未保存任何重定向后的最终URL;报告中的历史完整地址由已封存配置和发行源码拼接得出,不能当成历史TLS抓包。当前公开GET所用运输层未配置环境代理,不倒推原J进程当时的代理环境。

本机验证及边界

实际localhost HTTP回放三组通过,收据:原根地址与带/v1地址的两个隔离样本都发出了与原J相同SHA的Claude请求,接收原J未修改SSE后均报告GPT并严格拒绝。第三组仅在独立副本把响应型号换成Claude,作为明确标注的合成正对照,观察器正常判定一致。原J文件与正式模型均未修改。

这项回放验证客户端实际发送与接收,不是供应商的新推理实测,也不能证明改/v1后其实际路由结果会相同。对原路径及两个文档路径进行匿名GET均为404;这些是需要POST的接口,GET404不能用于判断带凭据POST的可用性、映射或Key分组。

当前正式仍为1.24.3、原PID36552/Provider/凭据,55项目/71会话及每表原行、全部导出、工件字节、公开模型中心与K最后快照精确一致,当前无活动任务;见状态收据。本阶段真实模型新增请求0;公开页面不使用Key,回放使用自有本机凭据。

下一修复与验收

  1. 优先补齐原生Anthropic Messages适配,而非为GPT返回配置Claude别名。覆盖请求与历史/工具结果转换、鉴权契约、JSON及SSE事件、用量/缓存来源、原错误、停止、身份暂停与原响应证据;未验证能力继续标为未知。
  2. 显示实际协议和最终拼接路径,提示SDK根地址与Chat根地址的差异;不对所有供应商盲目补/v1。后续请求记录最终响应URL/重定向标记,帮助定位兼容网关。
  3. 按供应商文档配置Messages后,用原Provider保存凭据另开一个新预检:单请求、无工具、最多256输出、累计16000tokens、无切池或自动重试。记录原请求与原响应、实际URL、型号和用量;不续跑J/E/H,不认证模型自述。
  4. 若Messages也返回GPT,保留新结果并用请求ID核对供应商分组/映射;若型号一致,先判定接入预检通过,再分别做真实工程交付与Purge对照。相同型号字段仍不能认证底层权重。

本轮只完成调查和证据保存,上述产品修复尚未实现,正式连接保持原样。1.25更广功能继续保留计划,原失败和模型/Purge收益结论不改写。

可复核记录

最终37份证据、652352字节,最终清单的SHA-256为bd900d169944161058e25fa4fa2675560e44e3f36e9b73ef8dab14078e111fad。运行node scripts/verify-apikey-route-l.mjs可离线核对原字节、原J清单、三组回放、公开文档、截图实际格式与正式保留收据;最终离线结果。

首34份/564873字节封存和离线结果保持,原清单SHA为b627e578795ec28148ed5d258a0b2cbc03b75fdf9ffad62ff5dede4faa516a04。随后按魔数核对发现浏览器截图实际返回JPEG,最初扩展名写成PNG;首校验只核对字节,没有检查媒体格式。保留原图和首清单,追加同字节JPG与更正收据,最终校验增加JPEG签名和两份完全相等的断言。

调查中两次Windows通配路径/一处猜测文件名的只读搜索失败、公开配置解析首次遗漏脚本末分号、网页导航首次使用了渲染更新前索引均已纠正;没有据此改写原件、重放真实请求或把404当作POST失败。