Chat Completions 协议 协议

它是什么

Chat Completions 协议是 OpenAI 风格的对话补全接口：POST /v1/chat/completions，请求体是 model / messages / temperature / top_p / max_tokens / seed 等字段的 JSON，响应体含 choices[0].message.content、finish_reason 与 usage。第 02 章逐字段解剖了它：model 必填、messages 是完整对话历史、finish_reason 的 stop / length / tool_calls 含义不同、usage 是计费依据。

为什么它是事实标准

DeepSeek、本地 Ollama 等大量服务都提供兼容端点（openai-compat），messages、choices、usage 等字段名在兼容服务间通用；第 04 章的 Provider 抽象也以它为基线去翻译 Anthropic 的差异。流式时同一请求变成 delta 增量序列（delta 词条）。

易混点

messages 里每条消息必须有 role（system / user / assistant，见 messages 词条）；服务端无状态，每次请求都要全量重发历史；max_tokens 撞上会被截断成 finish_reason: 'length'（token 词条）。

小结

chat/completions 是本教程所有厂商接入的起点，也是判断「OpenAI 兼容服务」的标尺——第 02 章把它啃透，后面的流式、工具、Agent Loop 全是顺水推舟。