创建、管理和查看 API 密钥，从这里开始。
sub.carlos.wang/keys开泊 API 快速接入指南
如果你要在 Codex、VS Code Codex 或 OpenCode 中使用开泊 API，按图完成密钥创建和客户端配置；开发者也可以直接查看 OpenAI 兼容接口示例。
Codex 和兼容客户端统一使用带 /v1 的地址。
Agent Setup
Codex 详细配置流程
按顺序完成登录、创建密钥、复制配置、重启测试和兑换。教程图均来自开泊 API 控制台，点击图片可放大。
Codex / VS Code Codex
推荐先用控制台的“使用密钥”功能生成配置；已安装 CC Switch 的用户也可以直接导入。
准备 Codex 或 CC Switch
桌面版 Codex 用户可直接使用控制台生成的配置。需要管理多个 Provider 时，再安装 CC Switch。
注册并登录开泊 API
打开开泊 API，完成注册和登录。登录后在左侧“我的账户”区域进入“API 密钥”。管理员账户会看到更多管理菜单，但用户接入流程相同。
进入 API 密钥页面
点击右上角“创建密钥”。页面同时会展示当前 API 端点，接入时请完整复制到 /v1。
配置并创建密钥
填写便于识别的名称并选择可用分组。新手建议先保持 IP、额度、速率和有效期限制关闭；熟悉后再按业务需要收紧权限。
安全建议：不同应用使用不同密钥。密钥创建后只保存到客户端配置文件，不要粘贴到聊天、群聊或公开截图中。
选择“使用密钥”生成 Codex 配置
在密钥卡片底部点击“使用密钥”，选择 Codex CLI、操作系统和认证模式。初次接入建议沿用页面默认的兼容模式。
复制配置文件
将页面给出的 config.toml 写入 Codex 配置目录，并把 auth.json 保存到同一目录。不要把真实密钥写进项目仓库。
~/.codex/config.toml
~/.codex/auth.json%USERPROFILE%\.codex\config.toml
%USERPROFILE%\.codex\auth.json重启并测试
完全关闭旧的 Codex 或 VS Code 窗口，再重新打开并输入“你好”测试。旧窗口可能继续读取旧配置，因此仅刷新页面通常不够。
旧账户用户：如果 Codex 中仍登录其他 OpenAI 账户，先退出该账户，再重启应用。
使用兑换码
确认 Codex 可以正常回复后，进入“兑换”页面输入兑换码。兑换码区分大小写，每个兑换码只能使用一次。
Model API
模型 API 调用手册
开泊 API 为 Codex 提供 OpenAI Responses 协议。模型名称和可用分组以控制台当前展示为准。
Endpoint：POST https://sub.carlos.wang/v1/responses
curl https://sub.carlos.wang/v1/responses \
-H "Authorization: Bearer $KAIBO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"input": "你好，请介绍一下你自己"
}'from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://sub.carlos.wang/v1",
)
response = client.responses.create(
model="gpt-5.6-sol",
input="你好，请介绍一下你自己",
)
print(response.output_text)model_provider = "OpenAI"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://sub.carlos.wang/v1"
wire_api = "responses"
requires_openai_auth = true
[features]
goals = true| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型 ID，以密钥分组可用模型为准。 |
| input | string | array | 是 | 用户输入或结构化消息数组。 |
| stream | boolean | 否 | 是否流式返回结果。 |
| instructions | string | 否 | 本次请求的系统级指令。 |
FAQ
常见排障
先检查 Key、Base URL、模型和客户端是否真正重启，再根据错误码定位。
401：认证失败
检查 API Key 是否完整、是否包含多余空格，以及 Authorization: Bearer YOUR_API_KEY 是否写对。Codex 用户还要确认 auth.json 位于正确目录。
403：无权调用
当前密钥分组可能没有模型权限，或者账户、密钥状态异常。回到“API 密钥”页检查分组和状态。
404：接口或模型不存在
确认 Base URL 是 https://sub.carlos.wang/v1，Responses 路径是 /v1/responses，并使用当前分组实际存在的模型 ID。
429：额度或并发不足
检查余额、密钥额度限制和账户并发数。短时间请求过多时降低并发后重试。
配置正确但 Codex 仍走旧账户
退出旧账户，完全关闭 Codex 或 VS Code，再重新打开。确认当前进程读取的是刚写入的配置目录。
CC Switch 导入后没有生效
确认 Provider 已切换为“正在使用”，Base URL 没有重复 /v1，然后重启 Codex。
Agent Deploy
Codex 配置核查清单
完成上面的图文步骤后，用这份清单做最后确认。
ProviderOpenAI Compatible
Base URLhttps://sub.carlos.wang/v1
Wire APIresponses
API Key来自开泊 API 控制台当前密钥
默认模型gpt-5.6-sol 或当前分组推荐模型
应用状态保存配置后已完全重启