11book / docs

文档中心

从第一次调用到生产排错,按场景找到可直接复制的配置。

文档目录 · 接入 Codex CLI

▪ codex cli

接入 Codex CLI

Codex CLI 通过 model_provider 指向 11book,模型与使用习惯保持不变;全程只需一次配置。

前置条件

  • 已安装 OpenAI Codex CLI 并可正常运行。
  • 已在 控制台创建 API Key,且账户余额充足。

第 1 步 · 设置 API Key 环境变量

Codex 通过 env_key 声明的环境变量读取密钥,把它写入你的 shell 配置(如 ~/.zshrc):

~/.zshrc
export BOOK_API_KEY="sk-xxxx"  # create one in the console

第 2 步 · 修改 config.toml

编辑 ~/.codex/config.toml,新增 11book provider 并设为默认:

~/.codex/config.toml
model_provider = "11book"
model = "YOUR_MODEL_ID"

[model_providers.11book]
name = "11book"
base_url = "https://api.11book.ai/v1"
env_key = "BOOK_API_KEY"
wire_api = "responses"

第 3 步 · 验证

重新打开终端(让环境变量生效),运行一句最简单的指令:

终端
codex "Introduce yourself in one sentence"

正常返回即接入完成;用量与消费可在控制台「使用记录」查看。

模型选择建议

在模型与价格中选择可用的 GPT / Codex 系列模型,将示例中的 YOUR_MODEL_ID 替换为完整模型 ID;调用前确认端点支持和使用限制。

常见问题

提示 401 / 无效密钥?

检查 BOOK_API_KEY 是否已导出(test -n "$BOOK_API_KEY"),以及 Key 是否在控制台被停用或删除;改完环境变量需重开终端。

提示余额不足?

Key 与账户余额共用,到余额充值页充值或兑换后自动恢复。

429 / 限流?

短时间请求过于频繁会被限流保护,稍后自动恢复;生产环境建议做好退避重试。

修改配置后不生效?

Codex CLI 启动时读取配置,修改 config.toml 后需退出并重新启动会话。

The Final Page

万万不可

wan wan bu ke · never, ever

用户怕什么,我们万万不可什么。这是我们的承诺,也是名字里「万万」的意思。

01万万不可静默降级
02万万不可泄漏密钥
03万万不可糊涂收费
04万万不可暗改价格
05万万不可让额度过期
06万万不可跑路失联
BASE URLhttps://api.11book.ai/v1