DOCAI · 概念 · L2
什么是 endpoint
一句话定义
API 里的一个具体地址：你往它发请求，它按约定回结果。
开发者更新 2026-11-13核验 2026-11-13 · docai 编辑部
它是什么
一个完整的调用地址，通常由三部分组成：
https://api.example.com/v1/chat/completions
└──────── 域名 ────────┘└──── 路径 ────┘域名指向哪台服务器，路径决定调用哪个能力。同一个域名下可以有几十个 endpoint。
常见的几个
| endpoint | 做什么 |
|---|---|
/v1/chat/completions |
对话生成 |
/v1/embeddings |
文本向量化 |
/v1/models |
列出可用模型 |
/v1/files |
上传与管理文件 |
具体路径以你所用服务的文档为准，中转站可能有额外前缀。
三个常见误解
- 「404 就是地址写错了」：不一定。也可能是该服务不提供这个 endpoint、路径前缀被中转站改过，或者请求方法不对（GET 打到了只收 POST 的地址）。
- 「域名对了就能调」：还要看路径、方法、请求头和鉴权。
- 「所有厂商的路径都一样」：不一样。兼容 OpenAI 格式的服务会模仿它的路径，但不是全部。
排错顺序
- 对照文档确认方法（GET/POST）和完整路径。
- 确认 base URL 是否包含
/v1，很多 404 是重复或漏掉了这一段。 - 用最简单的请求试（比如
/v1/models），排除请求体的问题。 - 还不行就看响应体，服务端通常会说「没找到哪个路由」。