Endpoint

Endpoint 指 API 暴露的某个具体功能入口，表现为一段路径。同一个服务通常提供多个 Endpoint——对话生成、文本向量、模型列表各有各的路径，各自接受不同的请求体字段并返回不同结构的响应。判断一个服务能做什么，看它提供了哪些 Endpoint 比看宣传更可靠。

一个服务通常有多个 Endpoint

以模型 API 为例，常见的几类是：

• 对话 / 生成类：把消息发给模型并拿回结果，是最常用的那一个。
• 向量类：把文本转成向量，用于检索与相似度计算。
• 模型列表类：返回当前密钥实际可调用的模型，比照抄文档里的模型名可靠。

每个 Endpoint 的请求体字段不同，不能把一个的参数套到另一个上。

常见误解

• Endpoint 不等于完整地址。 它要拼在 Base URL 后面才能用。
• 接口存在不等于功能可用。 路径能访问，但你的密钥可能没有对应权限，或该模型不在你的可用范围内。
• 兼容层的 Endpoint 覆盖可能不全。 第三方服务常常只实现最常用的那一两个，别默认它支持全部。

判断一个服务支持什么

最直接的方法是查它的文档里列出了哪些 Endpoint，再用模型列表类接口确认实际可调用范围。宣传语里的能力描述与实际暴露的接口经常对不上——这一点在评估第三方兼容服务时尤其重要，方法见 OpenAI 兼容接口怎么判断。