64 lines
8.0 KiB
Markdown
64 lines
8.0 KiB
Markdown
# apikey Claude接入调查
|
||
|
||
后续N更正:用户确认这把Key实际属于GPT分组,原型号误填Claude。L发现的“当时缺少Messages适配”是产品能力边界,不是该GPT连接故障的根因证明。Messages后由M独立交付,当前连接已按GPT/Responses校正并保留停用;见[复查](ROUTING-AUDIT-N.md)。以下为分组尚未确认时的历史调查,原证据保持。
|
||
|
||
本次确定了工作台的协议接入缺口: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脚本教程](https://apikey.fan/docs/api-scripts#anthropic-messages-%E6%96%87%E6%9C%AC-%E8%A7%86%E8%A7%89)、[Claude Code教程](https://apikey.fan/docs/claude)。公开页面原观察与截图已保存:[API文档](apikey-route-l-evidence/observations/vendor-api-scripts-ax.txt)、[Claude手动说明](apikey-route-l-evidence/observations/vendor-claude-ax.txt)、[截图](apikey-route-l-evidence/observations/vendor-messages.jpg)。只读访问,未登录或执行文档中的安装命令。
|
||
|
||
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发行冻结输入一致,见[源码身份](apikey-route-l-evidence/observations/source-review.json)。实际链路为:
|
||
|
||
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回放三组通过,[收据](apikey-route-l-evidence/observations/provider-replay.json):原根地址与带`/v1`地址的两个隔离样本都发出了与原J相同SHA的Claude请求,接收原J未修改SSE后均报告GPT并严格拒绝。第三组仅在独立副本把响应型号换成Claude,作为明确标注的合成正对照,观察器正常判定一致。原J文件与正式模型均未修改。
|
||
|
||
这项回放验证客户端实际发送与接收,不是供应商的新推理实测,也不能证明改`/v1`后其实际路由结果会相同。对原路径及两个文档路径进行匿名GET均为404;这些是需要POST的接口,GET404不能用于判断带凭据POST的可用性、映射或Key分组。
|
||
|
||
当前正式仍为1.24.3、原PID36552/Provider/凭据,55项目/71会话及每表原行、全部导出、工件字节、公开模型中心与K最后快照精确一致,当前无活动任务;见[状态收据](apikey-route-l-evidence/observations/formal-retention.json)。本阶段真实模型新增请求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字节,[最终清单](apikey-route-l-evidence/manifest-final.json)的SHA-256为`bd900d169944161058e25fa4fa2675560e44e3f36e9b73ef8dab14078e111fad`。运行`node scripts/verify-apikey-route-l.mjs`可离线核对原字节、原J清单、三组回放、公开文档、截图实际格式与正式保留收据;[最终离线结果](apikey-route-l-offline-final.txt)。
|
||
|
||
首34份/564873字节封存和离线结果保持,原清单SHA为`b627e578795ec28148ed5d258a0b2cbc03b75fdf9ffad62ff5dede4faa516a04`。随后按魔数核对发现浏览器截图实际返回JPEG,最初扩展名写成PNG;首校验只核对字节,没有检查媒体格式。保留原图和首清单,追加同字节JPG与更正收据,最终校验增加JPEG签名和两份完全相等的断言。
|
||
|
||
调查中两次Windows通配路径/一处猜测文件名的只读搜索失败、公开配置解析首次遗漏脚本末分号、网页导航首次使用了渲染更新前索引均已纠正;没有据此改写原件、重放真实请求或把404当作POST失败。
|