本文要点
- API Key 用来证明你是谁，不要公开截图或发给不可信的人。
- Base URL 决定请求发到哪里，中转站和官方入口通常不一样。
- Model Name 决定调用哪个模型，必须使用服务方支持的名称。
步骤一：先区分三个字段
API Key 是身份凭据，泄露后别人可能消耗你的额度。Base URL 是接口地址，决定请求发往官方入口还是某个 AI 中转站。Model Name 是模型名称，决定本次请求使用哪类能力。
这三个字段不要混填。把接口地址填到密钥里、把模型名写错、把测试密钥放到生产项目里，都会导致看起来很像“服务不可用”的错误。
步骤二：按项目建立配置记录
建议每个项目记录：用途、接口地址、模型名、密钥来源、额度负责人、代理环境和最近一次变更时间。团队协作时，不要只在聊天里口头传一串密钥。
如果使用 AI 中转站，还要记录它是否支持你要调用的模型、是否有速率限制、失败请求是否计费，以及是否提供可查的用量明细。
步骤三：连接失败时按顺序排查
先检查代理环境和网络连通性，再检查 API Key 是否有效，然后检查 Base URL 是否多写或少写路径，最后检查 Model Name 是否属于当前服务支持范围。
如果你需要固定代理环境来访问 AI 工具或接口文档，可以 访问 PuppyIP 官网，购买后按 使用教程 配置。
常见问题
Base URL 可以随便换吗？
不建议随便换。换入口会影响模型名、计费、限速、日志和错误排查方式。
API Key 可以放在前端页面里吗？
不建议。密钥应放在服务端或受控环境中，公开页面和截图都不应该暴露真实密钥。