Simplaj API 使用教程

从 Codex 连接手机 App / GPT 账号登录，到注册、兑换、创建 API Key 与常见客户端配置，一页完成上手。

一、Codex 连接手机 App

适合 Codex 先用 GPT / ChatGPT 账号登录，同时把模型请求转到 Simplaj API Key 的场景。

退出 Codex 先完全退出 Codex 或 VS Code 里的 Codex 插件，避免配置文件正在被占用。

删除旧登录文件 删除 ~/.codex/auth.json。只删这个文件，不要删除 config.toml 或 sessions 目录。

重新用 GPT 账号登录 重新打开 Codex，使用 GPT / ChatGPT 账号登录。若提示手机 App 扫码或确认，按手机 App 提示完成。

填写 Simplaj API Key 在 [model_providers.sub2api] 里加入 experimental_bearer_token，provider 名称保持 sub2api。如果只是切换 base_url，也不要改 model_provider 和 name。

重启 Codex 保存配置后退出并重新启动 Codex。只删除 auth.json 不会清空当前会话。

~/.codex/config.toml

model_provider = "sub2api"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[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"

二、注册账号与登录

注册入口、登录入口均为公开页面。注册后如果提示验证邮箱，请先完成邮箱验证。

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

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

填写邮箱

使用常用邮箱注册，后续找回密码、验证通知都会发送到该邮箱。

设置密码

密码至少 6 个字符。建议使用独立密码，避免和其他站点共用。

完成验证

如收到验证邮件，请按邮件提示完成验证，再进入控制台。

三、兑换套餐或余额

兑换码通常由客服、订单系统或活动发放。兑换成功后，账号才具备对应调用权限。

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

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

查看账户状态 兑换后可在仪表盘、使用记录、订阅或个人资料中查看余额与权限。

四、生成 API Key

API Key 是客户端调用 Simplaj API 的凭证。创建后请立即复制保存，不要公开发送完整 Key。

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

点击创建密钥 填写名称，选择可用分组。不确定时选择默认可用分组。

复制并保存 默认格式通常是 sk-xxxxxxxx。只在自己的客户端中使用。

额度限制怎么理解？

给单个 Key 设置消费上限。例如限制 10 美元，则该 Key 最多消费到 10 美元。填写 0 或不填写通常表示不额外限制，最终仍受账号余额、套餐和平台规则约束。

五、接口地址

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

使用场景	Base URL	说明
Codex / Responses provider	`https://sub2api.simplaj.top`	Codex 配置里使用根地址，协议设为 `responses`。
OpenAI 兼容 SDK / Chat Completions	`https://sub2api.simplaj.top/v1`	适合 Cherry Studio、OpenClaw、普通 OpenAI SDK 等。
Gemini 兼容客户端	`https://sub2api.simplaj.top/v1beta`	使用 Gemini 原生兼容接口时选择。
Antigravity Claude 入口	`https://sub2api.simplaj.top/antigravity/v1`	Antigravity 的 Claude 兼容路径。
Antigravity Gemini 入口	`https://sub2api.simplaj.top/antigravity/v1beta`	Antigravity 的 Gemini 兼容路径。

Authorization Header

Authorization: Bearer sk-替换成你的密钥

快速测试

curl -s https://sub2api.simplaj.top/v1/models \
  -H "Authorization: Bearer sk-替换成你的密钥"

六、CC Switch 一键导入

推荐新手优先使用一键导入，减少手动填错 Base URL 或 Key 的概率。

飞书下载说明 GitHub Releases

安装 CC Switch 先通过上方链接下载并安装 CC Switch，然后允许浏览器打开 ccswitch:// 协议。

进入 API 密钥页 找到要使用的 Key，点击「导入到 CC Switch」。

确认导入 CC Switch 会自动写入服务商名称、接口地址、API Key 和用量查询脚本。

七、客户端配置

以下配置中的 sk-替换成你的密钥 都需要替换成你自己生成的 API Key。

Codex / VS Code Codex

Codex 的 provider 使用 Responses 协议，Base URL 填根地址，不要加 /v1。已按第一节登录的用户只需要确认配置一致。

关键点

保持 model_provider = "sub2api"、[model_providers.sub2api] 和 name = "sub2api" 不变，再把 Simplaj API Key 写进 experimental_bearer_token。

~/.codex/config.toml

model_provider = "sub2api"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[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"

OpenClaw

先按官方文档安装。模型配置可写入 ~/.openclaw/openclaw.json。

OpenClaw provider

{
  "provider": "simplaj",
  "base_url": "https://sub2api.simplaj.top/v1",
  "api": "openai-responses",
  "api_key": "sk-替换成你的密钥",
  "model": {
    "id": "gpt-5.4",
    "name": "GPT-5.4",
    "reasoning": true,
    "input": ["text", "image"],
    "contextWindow": 400000,
    "maxTokens": 128000
  }
}

ClawX

进入「模型」页面添加自定义供应商：名称填 Simplaj API，Base URL 填 https://sub2api.simplaj.top/v1，模型添加 gpt-5.4。

Cherry Studio

添加 OpenAI 兼容服务商。API 地址建议填 https://sub2api.simplaj.top/v1#，末尾 # 可避免部分版本重复追加路径。

八、命令行测试

遇到客户端报错时，先用 curl 确认 Key、地址和模型是否可用。

Responses API

curl -s https://sub2api.simplaj.top/v1/responses \
  -H "Authorization: Bearer sk-替换成你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "请用一句话介绍 Simplaj API。"
  }'

查看 Key 用量

curl -s https://sub2api.simplaj.top/v1/usage \
  -H "Authorization: Bearer sk-替换成你的密钥"

九、常见问题

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

为什么注册后不能直接调用？

请先完成邮箱验证，并确认账号已经兑换套餐或余额。没有可用权限时，即使 Key 格式正确也可能无法调用。

客户端下拉框里没有 GPT-5.4 怎么办？

部分客户端不会实时同步模型列表。可以在配置文件或模型管理中手动添加 gpt-5.4。

Base URL 要不要带 /v1？

Codex 的 Responses provider 使用 https://sub2api.simplaj.top；OpenAI 兼容 SDK、OpenClaw、Cherry Studio 通常使用 https://sub2api.simplaj.top/v1。

Codex 重新登录会丢掉现在的会话吗？

正常不会。只删除 ~/.codex/auth.json 是重置登录态，不是删除历史会话。不要删除 ~/.codex/sessions，并且保持 provider 名称 sub2api 不变。

如果你切换完 base_url 后看不到之前的历史，通常是因为 model_provider、[model_providers.xxx] 或 name 改成了新名字。把 provider 名称改回原来的 sub2api，历史会话通常就能继续对应上。

提示 Invalid API key 怎么排查？

检查 Key 是否完整、是否被禁用或过期、是否额度用尽、Header 是否为 Authorization: Bearer sk-...，以及 Codex 里的 experimental_bearer_token 是否填了 Simplaj API Key。