Simplaj API 使用教程

平台地址：https://sub2api.simplaj.top/。按顺序完成注册、兑换套餐、生成 API Key 和工具配置即可开始使用。

进入主站

售后 QQ 群

注册、兑换、配置、调用报错等问题，可以在群里发截图说明。

售后 QQ 群：1104376360

扫码加入售后群。说明问题时建议带上页面截图、客户端名称、报错提示和你正在配置的 Base URL。

扫码加入售后 QQ 群

登录平台

访问官网或登录页进入 Simplaj API 控制台。

Simplaj API 登录页面截图 — 登录地址 `https://sub2api.simplaj.top/login`

一、注册账号

输入邮箱和密码即可完成注册。若系统提示邮箱验证，请先到邮箱里点击验证链接，再返回平台登录。

访问注册地址 https://sub2api.simplaj.top/register

填写邮箱和密码 使用常用邮箱注册，后续验证和账号通知都会发送到该邮箱。

完成邮箱验证 如果收到验证邮件，按邮件提示完成验证后再登录。

Simplaj API 注册页面截图 — 注册账号页面 `https://sub2api.simplaj.top/register`

二、兑换套餐

登录后，在左侧边栏选择「兑换」，输入你收到的兑换码，即可完成套餐激活。

进入兑换页 登录后点击左侧「兑换」，或访问 https://sub2api.simplaj.top/redeem。

输入兑换码 粘贴你收到的兑换码，确认没有多余空格或换行。

确认套餐状态 兑换完成后，余额、并发数或套餐权限会自动更新。

Simplaj API 兑换套餐页面截图 — 兑换套餐页面 `https://sub2api.simplaj.top/redeem`

三、生成 API Key

在左侧边栏切换到「API 密钥」，点击「创建密钥」。创建完成后复制使用，密钥格式一般为 sk-xxxx。

进入 API 密钥页 登录后点击左侧「API 密钥」，或访问 https://sub2api.simplaj.top/keys。

选择正确分组 创建时，分组请选择兑换码所属的分组；例如兑换码兑换到 gpt 分组，就选择 gpt，否则这个 Key 可能没有对应的套餐额度或模型权限。

复制并保存 API Key 只在自己本机配置使用，不要发到公开群聊、论坛或截图里。

Simplaj API 密钥页面截图 — API 密钥页面 `https://sub2api.simplaj.top/keys`

API 接口地址

Codex 和 OpenAI 兼容客户端的 Base URL 写法不同，请按客户端类型选择。

使用场景	接口地址	说明
Responses / Codex	`https://sub2api.simplaj.top`	Codex 配置里使用根地址，协议设为 `responses`。
OpenAI 兼容接口	`https://sub2api.simplaj.top/v1`	适合 Cherry Studio、OpenClaw、ClawX、普通 OpenAI SDK 等。

避免重复 /v1

如果某个客户端会自动拼接 /v1，Base URL 就不要重复写 /v1。Cherry Studio 等部分客户端可在地址末尾加 #，避免自动追加版本路径。

配置教程

推荐先使用 CC Switch 一键导入；不使用一键导入时，再按下面的纯 API 手动配置。

一、CC Switch 一键导入（推荐）

普通用户优先使用 CC Switch。一键导入后，无需手动修改 auth.json 或 config.toml。

飞书下载说明 GitHub Releases

下载并安装 CC Switch 先通过上方链接下载并安装 CC Switch。

进入 API 密钥页面 登录 Simplaj API 平台，进入「API 密钥」页面。

点击导入 找到需要使用的 Key，点击「导入到 CC Switch」。

确认使用 浏览器会唤起 CC Switch，并自动写入服务商、接口地址和 API Key。导入完成后，在 CC Switch 中选择 Simplaj API 配置即可使用。

如果点击导入没有反应，通常是本机没有安装 CC Switch，或浏览器没有允许打开 ccswitch:// 协议。先确认 CC Switch 可以正常启动，再重新点击导入。

二、Codex 纯 API 手动配置

如果不用 CC Switch，可以手动配置 Codex。纯 API 模式不需要登录 GPT / ChatGPT 账号，适合 CLI、VS Code Codex、Cursor 插件或 API 调用。

1. 退出 Codex

先完全退出 Codex、VS Code Codex 插件或正在运行的 Codex CLI。

2. 写入 API Key

把 Simplaj API 平台生成的 API Key 写入 ~/.codex/auth.json，或使用 codex login --with-api-key。

3. 编辑 config.toml

配置 provider 名称、模型、Base URL 和 Responses 协议，保存后重新启动 Codex。

~/.codex/auth.json

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-替换成你的 Simplaj API Key"
}

命令写入 API Key

printf 'sk-替换成你的 Simplaj API Key' | codex login --with-api-key

~/.codex/config.toml

model_provider = "sub2api"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_verbosity = "high"
network_access = true
web_search = "live"
windows_wsl_setup_acknowledged = true

[model_providers.sub2api]
name = "sub2api"
base_url = "https://sub2api.simplaj.top"
wire_api = "responses"
requires_openai_auth = true

[features]
fast_model = true

三、VS Code / Cursor 插件

在扩展商店搜索 Codex 并安装。安装完成后，打开 Codex 插件入口，填入你在 Simplaj API 平台生成的 API Key。

配置方式

如插件支持编辑配置文件，按上面的 config.toml 内容配置即可。模型名称可手动填写 gpt-5.4。

模型列表看不到 gpt-5.4

如果模型下拉列表里暂时看不到 gpt-5.4，这是前端列表没有同步导致的，不影响使用。直接在配置文件中手动指定模型即可。

四、OpenClaw

先参考 OpenClaw 官方安装文档完成安装。安装过程中可以先不管模型配置，安装完成后编辑 ~/.openclaw/openclaw.json。

OpenClaw provider

{
  "provider": "sub2api",
  "base_url": "https://sub2api.simplaj.top/v1",
  "api": "openai-responses",
  "api_key": "生成的 API 密钥",
  "model": {
    "id": "gpt-5.4",
    "name": "GPT-5.4",
    "reasoning": true,
    "input": ["text", "image"],
    "cost": {
      "input": 1.75,
      "output": 14,
      "cacheRead": 0.175,
      "cacheWrite": 0.175
    },
    "contextWindow": 400000,
    "maxTokens": 128000
  }
}

五、ClawX

ClawX 是 OpenClaw AI 智能体的桌面客户端，开源地址：https://github.com/ValueCell-ai/ClawX。

进入模型页面 点击左侧「模型」，进入添加供应商。

选择自定义添加 API Key 填写 Simplaj API 平台生成的 sk-...。

填写接口和模型 Base URL 填写 https://sub2api.simplaj.top/v1，模型填写 gpt-5.4，保存后重启网关。

六、Cherry Studio

进入 Cherry Studio 设置页，添加自定义供应商。

API Key	填写 Simplaj API 平台生成的 `sk-...`
API 地址	`https://sub2api.simplaj.top/v1#`
模型	添加 `gpt-5.4`

地址末尾的 # 用于禁用部分版本的自动路径拼接，避免变成重复的 /v1/v1。

七、可解锁能力说明

普通调用优先用 CC Switch 或「纯 API 手动配置」。如果你还需要 Codex 的官方登录态能力，可以使用「GPT 登录 + API 调用」方式：账号登录态走 GPT / ChatGPT，模型请求走 Simplaj API。

连接手机 App

在手机端继续查看或接入 Codex 会话。

官方插件与连接器

使用需要 GPT / ChatGPT 登录态的官方插件、连接器等功能。

长期目标能力

使用长期目标、后台任务等依赖官方账号登录态的能力。

退出 Codex 先完全退出 Codex。

重置登录态 备份后删除 ~/.codex/auth.json，不要删除 ~/.codex/sessions。

重新登录 GPT / ChatGPT 账号 重新启动 Codex，使用 GPT / ChatGPT 账号登录。

增加 experimental_bearer_token 打开 ~/.codex/config.toml，保持 provider 名称不变，在 [model_providers.sub2api] 下增加 experimental_bearer_token，值填写 Simplaj API Key。

重启 Codex 保存配置后，退出 Codex 并重新启动。

~/.codex/config.toml

model_provider = "sub2api"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_verbosity = "high"
network_access = true
web_search = "live"
windows_wsl_setup_acknowledged = true

[model_providers.sub2api]
name = "sub2api"
base_url = "https://sub2api.simplaj.top"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "sk-替换成你的 Simplaj API Key"

[features]
fast_model = true

只重置登录态和修改配置，不会丢当前历史会话。
不要删除 ~/.codex/sessions。
provider 名称不要变，保持 model_provider = "sub2api"、[model_providers.sub2api] 和 name = "sub2api" 一致；改名后旧历史可能看起来消失。
普通 API 用户和 CC Switch 一键导入用户不需要配置这一项。

常见问题

以下是配置时最常见的几个问题。

1. 推荐先用 CC Switch 还是手动配置？

推荐先用 CC Switch。一键导入最省事，也最不容易把 base_url、provider 名称或 API Key 写错。

2. 切换 base_url 后历史会话不见了怎么办？

provider 名称不要变。历史会话通常跟 provider 名称关联，请保持 model_provider = "sub2api"、[model_providers.sub2api]、name = "sub2api" 这三个位置一致。只切换 base_url 或 API Key 时，不要把 provider 改成新名字。

3. 提示 Invalid API key 怎么排查？

按顺序检查：API Key 是否复制完整、Key 前后是否有多余空格、Key 是否已删除或额度用完、纯 API 模式下 auth.json 里的 OPENAI_API_KEY 是否是 Simplaj API Key、Codex Responses 模式下 base_url 是否写成 https://sub2api.simplaj.top。

4. 重新登录 Codex 会不会丢会话？

不会。不要删除 ~/.codex/sessions。只重置登录态或修改配置，不会删除历史会话文件。