大家好,我是云途。很多配置页同时出现 Base URL、API Key、Provider 和 Model。只要其中一项指向错误,工具就无法正常请求。
这篇不绑定某一家服务商,只讲可迁移的判断方法。
一次模型请求经过哪些位置
Provider
实际提供账号、模型接口、用量和计费的服务方。
Base URL
请求发送到的基础地址。地址相似不代表服务和能力完全相同。
API Key
证明调用身份的秘密凭证。拿到它的人可能消耗额度或访问权限。
Model
本次请求要使用的具体模型标识,必须是当前服务商实际提供的名称。
“兼容 OpenAI API”不等于完全相同
兼容通常表示某些请求格式或 SDK 可以复用,但模型名称、上下文长度、工具调用、流式输出、错误码和计费仍可能不同。迁移时应先用最小请求测试,而不是一次替换全部配置。
API Key 必须当作密码保存
export MODEL_API_KEY="你的密钥"
# 不要把真实密钥写进教程、截图或 Git 仓库- 不要把密钥发给不可信网站或聊天群。
- 不要把真实密钥提交到 Git。
- 截图前检查终端、配置文件和浏览器地址。
- 怀疑泄漏时立即在服务商后台撤销并重新生成。
你已经能独立检查一组模型配置
- 能找到真实服务商和计费账号。
- 能区分 Base URL、API Key 与模型名。
- 会用最小请求验证配置,不一次改动全部环境。