适合谁,不适合谁
开始前准备
- 明确要配置的客户端:Codex、Claude Code 或其他工具。
- 登录服务控制台,找到该客户端对应的当前说明。
- 准备安全的凭证存储方式,不把 Key 写入仓库。
- 知道怎样运行一次最小测试任务。
完整步骤
确认客户端和请求协议
Codex 可使用 OpenAI Responses provider;Claude Code 网关通常需要 Anthropic 格式。先确定协议再找字段。
复制 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
没有统一答案。使用控制台给出的完整格式;自行添加可能造成重复路径。
Key 有效但客户端仍失败
检查凭证请求头、协议、模型权限和客户端配置来源,不要只重新生成 Key。
模型名看起来正确却提示不存在
展示名称可能不是调用标识,或当前账户没有权限;重新从控制台复制。
HTTP 200 但内容不对
可能打到网页、代理错误页或不兼容响应;检查响应 Content-Type 和正文结构。
完成后的检查方法
- 客户端和请求协议已经确定。
- Base URL、Key、模型名来自同一当前配置说明。
- Key 没有出现在 config 示例、仓库、截图或聊天中。
- 没有自行添加或删除未知路径。
- 真实最小任务返回与输入相符的结果。
- 控制台记录与测试行为能够交叉确认。
FAQ
API Key 和登录密码一样吗?
作用类似访问凭证,但通常用于程序或客户端调用。泄露后应立即撤销或轮换。
Base URL 就是网站首页吗?
不一定。业务首页和 API 服务地址可能不同,应以控制台配置说明为准。
一个 Key 可以给所有客户端用吗?
取决于服务支持的协议和权限,不能默认通用。
怎样证明 API 配置成功?
运行真实最小任务,检查输出、客户端状态和服务端记录,而不是只看网页或未认证状态码。
先确定客户端,再复制成套配置字段。
进入控制台查看当前 Base URL、凭证类型、模型名和协议说明,不从旧文章拼接配置。 模型、价格、额度与规则以对应业务站当前展示为准。
进入小贺API查看当前字段