API Key 和 Base URL 是什么:配置前先看懂 5 个概念

这篇教程只解决一个问题:第一次配置 Codex 或 Claude Code 时,怎样看懂控制台给出的字段,并避免把地址、Key、模型和协议填错位置。

直接答案API Key 是访问凭证,Base URL 是客户端发送请求的服务地址,模型名是具体资源标识,请求协议决定客户端怎样组织数据,状态码说明失败发生在哪一层。五项必须属于同一服务和同一配置说明;Codex 与 Claude Code 协议不同,不能直接互抄。

适合谁,不适合谁

适合:第一次配置客户端看到 Base URL、Key、模型名时不知道各自作用。
适合:需要判断教程是否可照抄希望先确认客户端、服务和协议是否匹配。
不适合:把 Key 发给他人代配完整凭证不应通过聊天、截图或公开文档传递。
不适合:只看域名猜接口业务首页、API 根地址和具体接口路径可能不同。

开始前准备

  1. 明确要配置的客户端:Codex、Claude Code 或其他工具。
  2. 登录服务控制台,找到该客户端对应的当前说明。
  3. 准备安全的凭证存储方式,不把 Key 写入仓库。
  4. 知道怎样运行一次最小测试任务。
字段必须成套使用不要把 A 服务的 Key、B 服务的 Base URL 和旧文章里的模型名拼在一起。

完整步骤

01

确认客户端和请求协议

Codex 可使用 OpenAI Responses provider;Claude Code 网关通常需要 Anthropic 格式。先确定协议再找字段。

02

复制 Base URL

Base URL 指向服务入口。是否包含版本路径由当前控制台说明决定,不要自行增删。

03

安全保存 API Key

Key 相当于密码。使用客户端认证或环境变量,不打印到日志,不提交 Git。

04

复制当前模型名和其他必填项

模型展示名称与调用标识可能不同,必须复制控制台当前值。

05

用真实最小任务验证

检查客户端状态、任务输出和服务端使用记录;网页返回 200 不能证明模型调用成功。

五个配置概念怎样对应

下面是概念示例,不是可直接调用的真实凭证。

配置字段清单
客户端:Codex 或 Claude Code
Base URL:从该客户端对应的控制台说明复制
API Key / Token:只保存到本机认证或环境变量
模型名:复制当前可用调用标识
请求协议:Responses 或 Anthropic Messages 等明确格式
验证:客户端诊断 + 一次真实最小任务 + 控制台记录
不推荐

网站能打开,Key 也有,所以任何客户端都能用。

建议做法

先确认客户端需要的协议,再使用同一服务给出的 Base URL、凭证类型和模型名完成真实调用。

怎样判断结果是否可用?

配置是否成功取决于整条链路一致,不能由单个字段或网页状态推断。

常见问题与报错

Base URL 应不应该带 /v1

没有统一答案。使用控制台给出的完整格式;自行添加可能造成重复路径。

Key 有效但客户端仍失败

检查凭证请求头、协议、模型权限和客户端配置来源,不要只重新生成 Key。

模型名看起来正确却提示不存在

展示名称可能不是调用标识,或当前账户没有权限;重新从控制台复制。

HTTP 200 但内容不对

可能打到网页、代理错误页或不兼容响应;检查响应 Content-Type 和正文结构。

完成后的检查方法

  • 客户端和请求协议已经确定。
  • Base URL、Key、模型名来自同一当前配置说明。
  • Key 没有出现在 config 示例、仓库、截图或聊天中。
  • 没有自行添加或删除未知路径。
  • 真实最小任务返回与输入相符的结果。
  • 控制台记录与测试行为能够交叉确认。

FAQ

API Key 和登录密码一样吗?

作用类似访问凭证,但通常用于程序或客户端调用。泄露后应立即撤销或轮换。

Base URL 就是网站首页吗?

不一定。业务首页和 API 服务地址可能不同,应以控制台配置说明为准。

一个 Key 可以给所有客户端用吗?

取决于服务支持的协议和权限,不能默认通用。

怎样证明 API 配置成功?

运行真实最小任务,检查输出、客户端状态和服务端记录,而不是只看网页或未认证状态码。

先确定客户端,再复制成套配置字段。

进入控制台查看当前 Base URL、凭证类型、模型名和协议说明,不从旧文章拼接配置。 模型、价格、额度与规则以对应业务站当前展示为准。

进入小贺API查看当前字段

下一步