为什么只改 base URL 还会报错
很多 OpenAI-compatible API 接入问题，不是 SDK 不能用，而是 base URL、API Key 和模型 ID 来自不同平台。
接入前的 5 项检查
- 检查 base URL：确认协议、域名以及
/v1路径完整。 - 检查 API Key：必须使用当前平台和当前项目创建的 Key，不能混用官方或旧平台 Key。
- 检查 model ID：从当前模型目录复制完整 ID，不要凭记忆填写简称。
- 先跑最小 cURL：最小请求成功后，再接 SDK、LangChain、Dify 或业务代码。
- 核对日志和扣费：确认实际模型、Token 用量、失败原因和最终扣费。
只替换地址、保留旧 Key 或旧模型名，常见结果是401 unauthorized、model not found，或者请求成功但路由和成本不符合预期。
完整配置与排查清单：
https://tacklekey.com/zh/guides/openai-compatible-base-url?utm_source=csdn&utm_medium=article&utm_campaign=openai_compatible_checklist_20260701
安全提醒：不要把真实 API Key 写进前端、截图或公开仓库。
