客户端接入

Sub2API 使用教程

这是一份给客户使用的教程：登录 Sub2API，创建自己的 API Key，然后接入 CC Switch、Codex、VS Code Codex、OpenClaw 和作图接口。截图里的邮箱和 Key 都是示例值。

打开 Sub2API 下载 CC Switch 在线作图 作图 API 文档

基础信息

Sub2API 登录地址 https://api.94576354.xyz
Codex Base URL https://api.94576354.xyz
OpenAI 兼容 Base URL https://api.94576354.xyz/v1
作图接口地址 https://img.94576354.xyz

你只需要保存好自己的 sk-... API Key。文字模型和 Codex 走主 API；作图走图片域名。

不要把 API Key 发到公开聊天、截图、工单或代码仓库里。截图、文档、教程里统一用 sk-xxxxxxxxxxxxxxxx 代替。

一、注册或登录

打开 https://api.94576354.xyz/register 可以创建账户。已经拿到账号的客户，直接打开 https://api.94576354.xyz/login 登录。

Sub2API 注册页面
注册页面只需要填写邮箱和密码；如果你拿到的是已创建账号，就跳过这一步。
Sub2API 登录页面
登录入口。
填写登录信息
输入自己的邮箱和密码后登录。

登录成功后会进入仪表盘。客户侧菜单只会看到自己的 API 密钥、使用记录、渠道状态、订阅、兑换和个人资料。

客户仪表盘
客户仪表盘。

二、创建自己的 API Key

进入左侧 API 密钥，点击 创建密钥。

客户 API 密钥页面
还没有 Key 时，页面中间和右上角都会有创建入口。

创建时建议这样填：

  1. 名称写用途，例如 codex-desktop、vscode-codex、openclaw。
  2. 分组选择账号可用的分组，常见是 codex。
  3. 额度限制、速率限制、有效期可以按需要填写；不确定就保持默认。
创建 API Key 弹窗
创建密钥弹窗。
填写 API Key 信息
填写名称并选择分组。

创建成功后复制 sk-...。如果页面只展示一次，请当场保存到本地密码管理器或你的客户端配置里。

API Key 创建成功
创建完成后会在列表里看到这个 Key。

三、导入 CC Switch

CC Switch 是本地 AI CLI 配置管理工具，可以把同一个 API Key 写入 Claude Code、Codex、Gemini CLI 等客户端配置。

  1. 打开 CC Switch Releases。
  2. Windows 下载 .msi，macOS 下载对应架构的 .dmg，Linux 下载对应包。
  3. 安装并启动一次 CC Switch。
  4. 回到 Sub2API 的 API 密钥页面，点击 导入到 CCS。
API Key 操作按钮
每个 Key 后面都有“使用密钥”和“导入到 CCS”。
CC Switch 导入选项
选择要写入的客户端配置，比如 Claude Code 或 Gemini CLI。
CC Switch 未安装提示
如果没有安装或系统没有注册 ccswitch:// 协议，浏览器会提示先安装 CC Switch。
手动导入时，Provider 类型选 OpenAI Compatible，Base URL 填 https://api.94576354.xyz/v1，API Key 填你自己的 sk-...。

四、桌面端 Codex 接入

在 API 密钥列表点击 使用密钥，页面会给出 Codex 配置片段。

使用 API 密钥弹窗
使用密钥弹窗会生成 Codex CLI 配置。

Windows 路径：

%USERPROFILE%\.codex\config.toml
%USERPROFILE%\.codex\auth.json

macOS / Linux 路径：

~/.codex/config.toml
~/.codex/auth.json

推荐 config.toml：

model_provider = "sub2api"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"

[model_providers.sub2api]
name = "sub2api"
base_url = "https://api.94576354.xyz"
wire_api = "responses"
requires_openai_auth = true

auth.json：

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxx"
}

配置完成后重新打开 Codex，发送一句 回复 ok 测试。

五、VS Code 里的 Codex 接入

VS Code Codex 通常读取同一套本地 Codex 配置。先按上一节配置好：

%USERPROFILE%\.codex\config.toml
%USERPROFILE%\.codex\auth.json

然后重启 VS Code。如果插件里单独提供 Provider 设置，按下面填：

字段填写
ProviderOpenAI Compatible / Custom
Base URLhttps://api.94576354.xyz
API Key自己的 sk-...
Modelgpt-5.5 或你的分组支持的模型。

如果 VS Code 仍读取旧 Key，关闭所有 VS Code 窗口后重新打开。

六、OpenClaw 接入

OpenClaw 按 OpenAI 兼容接口接入：

字段填写
Provider TypeOpenAI Compatible / Custom OpenAI
Base URLhttps://api.94576354.xyz/v1
API Key自己的 sk-...
Modelgpt-5.5 或你的分组支持的模型。
Streaming开启。

保存后新建会话，输入 用一句话回复：ok。能正常回复，再测试代码问题。

七、作图接口

网页作图和图片 API 统一使用图片域名：

https://img.94576354.xyz
场景接口
在线作图GET /
统一异步任务POST /v1/image-tasks
查询任务GET /v1/image-tasks/{task_id}
上传参考图POST /v1/images/assets
导入公网参考图POST /v1/images/assets/import
标准单张文生图POST /v1/images/generations
标准单张图生图POST /v1/images/edits

统一任务通过 workflow 选择 generate、edit、intent 或 responses。生成、编辑和 AI 规划单任务最多 15 张。

参考图先上传为 image_asset_id，后续任务只传资产 ID。上传资产保留 24 小时，每个账户最多 5,000 个、合计 10 GiB；生成结果图片保留 48 小时。

任务提交后使用同一把 API Key 轮询。ready_images 会立即返回先完成的图片，不需要等待整批结束。

完整参数见 作图 API 文档。

检查清单

  • 确认自己登录的是客户账号，不是别人的账号。
  • API Key 已复制保存，未发到公开渠道。
  • Codex 用 https://api.94576354.xyz。
  • OpenAI 兼容客户端用 https://api.94576354.xyz/v1。
  • 作图客户端用 https://img.94576354.xyz。
  • 模型名填写账号分组支持的模型。
  • CC Switch 已安装并启动过一次。
  • 测试请求能正常返回 ok。

常见问题

401 是什么原因？

API Key 错了、复制少了字符、Key 被禁用或过期。重新复制自己的 sk-...。

404 是什么原因？

通常是 Base URL 填错。OpenClaw、OpenAI SDK、很多第三方客户端需要 https://api.94576354.xyz/v1；Codex 的 config.toml 用 https://api.94576354.xyz。

模型不存在怎么办？

换成账号分组支持的模型名，例如 gpt-5.6-sol、gpt-5.6-terra、gpt-5.5 或 gpt-5.4。

429 或速度慢怎么办？

通常是并发、RPM、余额或上游排队导致。先降低并发重试，再联系服务方查看账号状态。

CC Switch 点了没反应怎么办？

先确认 CC Switch 已安装并打开过一次。如果浏览器提示未注册协议，就在 CC Switch 里手动新增 OpenAI Compatible Provider。