KingFlow API Key 管理页面

KingFlow 文档页面

Codex 接入 GPT API 中转站时，最容易出错的地方通常不是模型能力，而是配置文件。尤其是 config.toml 和 auth.json，一个负责模型供应商配置，一个负责密钥或认证信息。如果字段写错，Codex 就可能无法正常调用模型。

本文以 KingFlow 为例，介绍 Codex 接入 GPT API 中转站时的配置思路。

KingFlow 官网：https://www.kingflow.ai/

一、config.toml 和 auth.json 分别做什么

可以简单理解为：

config.toml：告诉 Codex 用哪个模型、哪个 Base URL、哪个 provider
auth.json：保存 API Key 或认证相关信息

这两个文件配合起来，Codex 才能知道请求发往哪里，以及使用哪个 Key 完成鉴权。

二、配置前先准备三项信息

在 KingFlow 控制台中，先准备：

1. API Key。
2. API Base URL。
3. 模型名称。

注意：官网地址 https://www.kingflow.ai/ 不一定是 API Base URL。实际接口地址应以 KingFlow 后台提供的信息为准。

三、config.toml 配置思路

config.toml 中重点是 provider 和默认模型。示意配置如下：

[model_provider.kingflow]
name = "KingFlow"
base_url = "以 KingFlow 控制台提供的 API 地址为准"
env_key = "KINGFLOW_API_KEY"

[profiles.default]
model_provider = "kingflow"
model = "以 KingFlow 后台支持的模型名称为准"

这里不要直接照搬其他平台的模型名，因为不同中转站可能会对模型名称做兼容或映射。

四、auth.json 配置思路

auth.json 的重点是密钥管理。示意：

{
  "KINGFLOW_API_KEY": "你的_KingFlow_API_Key"
}

实际使用时，不建议把完整 Key 截图发给别人，也不要写入公开仓库。

五、为什么建议用环境变量名

使用类似 KINGFLOW_API_KEY 这样的环境变量名，有两个好处：

1. 配置文件更清晰。
2. 后续更换 Key 时，不需要改动所有模型配置。

如果团队多人使用，也可以给不同项目设置不同 Key，方便统计消耗。

六、测试配置是否成功

配置完成后，可以用一个简单问题测试：

请用三句话解释 JavaScript 的事件循环。

如果能正常返回结果，说明 Base URL、API Key 和模型名称基本正确。

七、常见错误排查

1. 401 或鉴权失败

优先检查 API Key 是否正确、是否有空格、是否过期。

2. model not found

检查模型名称是否和 KingFlow 后台一致。

3. 请求没有响应

检查 Base URL 是否填写成了官网首页，或者当前 provider 是否启用。

4. IDE 可用但命令行不可用

检查环境变量是否在当前终端会话中生效。

八、总结

Codex 接入 GPT API 中转站时，config.toml 和 auth.json 是最核心的两个配置点。用 KingFlow 这类统一 API 接入入口，可以减少多个平台之间来回切换的配置成本。

配置时只要记住三点：Base URL 以控制台为准，模型名称以后台为准，API Key 不要泄露。