5.0 KiB
模型协议与能力边界
1.17新增OpenAI Responses适配,1.24.4新增原生Anthropic Messages,保留既有Chat Completions。品牌、模型名称与声明不能替代检测。现有API代理可按实际协议添加;PNG任务图片按各协议发送,未知WorkBuddy登录态、音频和视频输入尚未接入。
实际协议
Chat沿用messages与tool_calls/tool_call_id;Responses使用typed input/output Items,function_call.call_id与function_call_output严格配对,保留原用量字段。请求使用store:false,支持同一接口和模型下携带加密reasoning Items,换接口/模型时重新生成普通历史,不泄露私有Items。工具采用strict:false以保持现有可选参数契约。
Messages 使用顶层 system、messages 内容块、tool_use/input_schema 和带原 tool_use_id 的 tool_result。原生 thinking/signature 与 redacted_thinking 只为同地址/型号保留上游历史,不拼成普通助手文本。未知服务端工具和内容块明确暂停;达到输出/上下文上限、pause_turn 或缺少完整终结时不执行工具。
连接选择 Anthropic Messages 后,可填服务根地址或以 /v1 结尾的 API 根地址,界面预览最终 POST 地址;例如 https://api.apikey.fan 和 https://api.apikey.fan/v1 都发送到 https://api.apikey.fan/v1/messages。完整 /messages 端点不作为根地址接受。Chat/Responses 延续原有根地址拼接规则,不自动为其它协议增加 /v1。Messages 默认 x-api-key,可显式选择兼容服务的 Bearer;同时发送 anthropic-version:2023-06-01。保存、选择与切换不自动请求模型。
Messages SSE 必须依次核对 message_start、每个内容块的 start/delta/stop、message_delta 和 message_stop,工具 JSON 必须完整为对象。message_start.message.model 参与原有请求/返回型号核对,严格模式下未知或不一致即暂停,不以注册别名掩盖不一致。原响应和用量保留;相同字符串也不认证底层模型权重。
Messages 的输入计数为 input_tokens + cache_creation_input_tokens + cache_read_input_tokens,message_delta 用量是累计快照,不能把每个快照相加。原字段与缓存分项保留;这是消费记录,不是 Purge 收益证明。原生参数已接入 temperature(0–1)、top_p、top_k、stop_sequences、thinking;max_tokens 始终来自工作台硬预算,不能由自定义参数覆盖。
新的请求账本、消费记录和错误信息保存实际请求 URL 与 fetch 观察到的响应 URL。所有模型请求不自动跟随 HTTP 重定向,避免向跳转目标转发任一种凭据;3xx 保留错误并要求核对地址。旧记录没有保存的历史最终 URL 不补造。
混合协议或流式模型池封存每个成员实际请求变体;真正发送的请求另有原字节SHA、长度和Task/Run所属工件。历史纯Chat请求继续按原格式核对。预算按最大变体估算和最小成员容量保守预留;不把多线路变体总和当一次发送量。
SSE只显示有界进展。完整参数和终结核对前不派发工具;Chat须完整finish_reason及[DONE],Responses须completed且身份、参数和文本与原片段一致。收到流后断开、超时或协议失败不自动换成员重发。主动停止关闭原HTTP并释放租约。保存有界原响应工件;已知凭据会脱敏,原流SHA和脱敏后工件SHA分别保留。超过4MB则停止读取并明确标记捕获范围。
能力与检测
文本/工具保留旧连接的协议声明,流式/视觉/音频默认待验证。检测只在用户主动调用后发送合成输入,可能产生上游费用;不输入项目文件、不执行检测工具。文本应答不能证明工具能力,工具须返回要求的原调用及nonce,流式须走真实SSE并完整结束。结果绑定连接和凭据修订及原请求账本;变化后不再显示已验证。
选路复用原轮询、权重、粘连、租约和冷却。能力不符者在获取租约前排除,并在原Run记录具体原因;全部不符记为未派发,不产生上游用量。HTTP401/429、超时、中断及结果未知分别保留,不承诺上游永不中断。
来源
实际读取并据以实现的OpenAI官方资料:
Messages 实际读取依据为 Anthropic 官方 TypeScript SDK 的 Messages 契约 和 apikey 公开请求示例。本次两份官方文档网页实际转到地区不可用页,没有将该 HTTP200 当作文档内容。
以上是协议依据,不能证明任意代理完整兼容。专项使用自有loopback服务;真实连接身份预检、真实模型工程效果和Purge收益分别记录,不借用本机夹具结论。