Base URL、API Key、模型名快速对照
这三个字段必须来自同一服务、同一客户端的当前配置说明。
/v1 要看客户端最终请求路径。/v1 结束；Anthropic/Claude 常从服务根地址发起 Messages 请求；Gemini REST 常见 /v1beta。这只是识别线索，最终必须以服务商和客户端当前说明为准。适合谁，不适合谁
开始前准备
- 明确要配置的客户端：Codex、Claude Code 或其他工具。
- 登录服务控制台，找到该客户端对应的当前说明。
- 准备安全的凭证存储方式，不把 Key 写入仓库。
- 知道怎样运行一次最小测试任务。
完整步骤
确认客户端和请求协议
Codex 可使用 OpenAI Responses provider；Claude Code 网关通常需要 Anthropic Messages 格式；Gemini REST 常见 /v1beta 路径。先确定协议，再从同一份当前说明复制地址与凭证类型。
复制 Base URL
Base URL 指向服务入口。是否包含版本路径由当前控制台说明决定，不要自行增删。
安全保存 API Key
Key 相当于密码。使用客户端认证或环境变量，不打印到日志，不提交 Git。
复制当前模型名和其他必填项
模型展示名称与调用标识可能不同，必须复制控制台当前值。
用真实最小任务验证
检查客户端状态、任务输出和服务端使用记录；网页返回 200 不能证明模型调用成功。
五个配置概念怎样对应
下面是概念示例，不是可直接调用的真实凭证。
客户端：Codex 或 Claude Code Base URL：从该客户端对应的控制台说明复制 API Key / Token：只保存到本机认证或环境变量 模型名：复制当前可用调用标识 请求协议：Responses 或 Anthropic Messages 等明确格式 验证：客户端诊断 + 一次真实最小任务 + 控制台记录
网站能打开，Key 也有，所以任何客户端都能用。
先确认客户端需要的协议，再使用同一服务给出的 Base URL、凭证类型和模型名完成真实调用。
怎样判断结果是否可用？
配置是否成功取决于整条链路一致，不能由单个字段或网页状态推断。
常见问题与报错
Base URL 应不应该带 /v1
没有统一答案。OpenAI-compatible 服务常见 /v1，Anthropic/Claude 与 Gemini 的路径组织不同；使用控制台给出的完整格式，自行添加可能造成重复路径。
Key 有效但客户端仍失败
检查凭证请求头、协议、模型权限和客户端配置来源，不要只重新生成 Key。
模型名看起来正确却提示不存在
展示名称可能不是调用标识，或当前账户没有权限；重新从控制台复制。
HTTP 200 但内容不对
可能打到网页、代理错误页或不兼容响应；检查响应 Content-Type 和正文结构。
完成后的检查方法
- 客户端和请求协议已经确定。
- Base URL、Key、模型名来自同一当前配置说明。
- Key 没有出现在 config 示例、仓库、截图或聊天中。
- 没有自行添加或删除未知路径。
- 真实最小任务返回与输入相符的结果。
- 控制台记录与测试行为能够交叉确认。
FAQ
API Key 和登录密码一样吗？
作用类似访问凭证，但通常用于程序或客户端调用。泄露后应立即撤销或轮换。
Base URL 就是网站首页吗？
不一定。业务首页和 API 服务地址可能不同，应以控制台配置说明为准。
一个 Key 可以给所有客户端用吗？
取决于服务支持的协议和权限，不能默认通用。
怎样证明 API 配置成功？
运行真实最小任务，检查输出、客户端状态和服务端记录，而不是只看网页或未认证状态码。
先确定客户端，再复制成套配置字段。
进入控制台查看当前 Base URL、凭证类型、模型名和协议说明，不从旧文章拼接配置。 模型、价格、额度与规则以对应业务站当前展示为准。
进入小贺API查看当前字段