接入指南
Base URL、SDK、聊天客户端与编程工具的配置方法，以及常见报错排查。
-
Cherry Studio / Chatbox / LobeChat 怎么配置自定义 API？
三款客户端的配置方法相同：在设置里找到 OpenAI 兼容的模型服务，把 API 地址填成 https://token.easyapi.com/v1，把 API Key 填成在 EasyAPI 控制台创建的 sk- 开头令牌，再添加模型广场里的模型 ID 即可对话。常见的失败原因是地址漏了 /v1 或模型 ID 写错。
-
调用大模型 API 返回 401 / 429 / 5xx 分别该怎么排查？
401 表示密钥无效或请求头格式不对，应检查 API Key 和 Authorization 头；429 表示请求频率或配额超限，应降低并发并做指数退避重试；5xx 是网关或上游模型服务异常，稍后重试或临时换模型，持续出现再联系平台。
-
OpenAI 兼容 API 是什么？为什么只改 base_url 就能切换模型？
OpenAI 兼容 API 指的是请求路径、参数和返回结构都沿用 OpenAI 接口规范的模型服务。因为 SDK 只是按这套规范拼 HTTP 请求，所以把 base_url 指向兼容的网关、换上对应的 API Key 和模型名，同一份代码就能调用别家的模型。
-
用 OpenAI Python SDK 调用国产大模型要怎么改代码？
用 OpenAI Python SDK 调用国产大模型只需要改三处：创建客户端时把 base_url 设为兼容服务的地址，api_key 换成该平台的 Key，调用时把 model 写成目标模型的 ID。其余的 messages、stream 等写法保持不变。