Wire Protocol(线上协议) 协议

别名: 线缆协议

客户端与服务端之间实际传输的协议形态——对 LLM 而言就是那个 HTTP 请求/响应 JSON。官方 SDK 只是给同一套 wire protocol 包了层糖:出 bug 时(为什么 400?为什么取到 `undefined`?)你必须能读懂它在线上发的是什么。

它是什么

Wire Protocol(线上协议)指客户端与服务端之间实际传输的协议形态——对 LLM 而言就是那个 HTTP 请求/响应 JSON。官方 SDK 只是给同一套 wire protocol 包了层糖:它内部发出的请求、收的响应,还是第 02 章手写的那套 JSON。出 bug 时(为什么 400?为什么取到 undefined?)你必须能读懂它在线上发的是什么。

与 SDK 的关系

SDK 的 create() 背后就是一个 POST .../chat/completions,请求体字段名是 messages / temperature 而不是 topP;官方 SDK 之间签名也不统一,就算接了 SDK,业务代码仍需要自己的 provider-abstraction第 04 章结尾专门辨析「何时才值得引入官方 SDK」:先手写吃透协议,再用 SDK 替换 Provider 内部那一层。

怎么读

直接看线上形态比读 SDK 源码更快:用 curl 或抓包看请求长什么样、响应长什么样。OpenAI 与 Anthropic 两家的线上形态分别见 openai-compatanthropic-messages-api 词条。

相关词条

出现在这些章节