平台使用文档

本文档用于配置平台的 OpenAI 兼容接口，以及 Codex 和 cc-switch 相关功能。

接口地址 https://88apis.top/v1

鉴权方式 Authorization: Bearer API_KEY

常用模型 gpt-5.5 / gpt-5.4 / gpt-5.4-mini

快速开始

登录平台控制台。
进入令牌页面，新建或复制你的 API Key。
在客户端中填写接口地址 https://88apis.top/v1。
在客户端中填写你的 API Key。
选择可用模型并发起测试请求。

如果客户端支持“OpenAI Compatible”“OpenAI 兼容”“自定义 API Base URL”，通常都可以填写以上地址使用。

获取 API Key

API Key 是调用接口的凭证。请不要把它发给其他人，也不要提交到公开仓库。

打开平台控制台并登录账号。
进入 令牌 或 Token 页面。
点击新建令牌，设置名称、额度、模型限制和有效期。
复制生成的 Key，后续在客户端中作为 API_KEY 使用。

令牌只在创建或复制时完整展示。建议单独保存到本机密码管理器或客户端配置文件中。

OpenAI 兼容接口

平台支持 OpenAI 风格的请求路径。以下示例中的 API_KEY 请替换成你的真实令牌。

Responses 接口

curl https://88apis.top/v1/responses \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "用三句话介绍平台的用途"
  }'

Chat Completions 接口

curl https://88apis.top/v1/chat/completions \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "user", "content": "你好"}
    ],
    "stream": true
  }'

字段	说明
`base_url`	统一填写 `https://88apis.top/v1`
`API_KEY`	控制台令牌页面生成的 Key
`model`	以控制台可用模型列表为准，常见值有 `gpt-5.5`、`gpt-5.4`、`gpt-5.4-mini`

Codex 配置

推荐使用 cc-switch 一键导入配置；如果不想使用工具，也可以手动编辑 Codex 配置文件。

重点提醒：配置完成后必须完全退出并重新打开 Codex。只关闭当前会话窗口不一定会重新读取配置。

下载 cc-switch

下载 macOS 版本下载 Windows 版本

方法一：一键导入（推荐）

先安装 cc-switch，并保持客户端可正常打开。
进入平台的 API 密钥 页面，找到要给 Codex 使用的令牌。
点击该令牌右侧的更多按钮，选择 CC Switch。
弹窗中选择 Codex，名称保持 88apis，主模型选择 gpt-5.5，然后点击 打开 CC Switch。
在 cc-switch 的确认窗口中检查供应商名称、API 端点和模型，确认无误后点击 导入。
导入后进入 cc-switch 的 Codex 页，确认 88apis 处于使用中。

保存并启用后，必须完全重启 Codex 客户端。只关闭当前会话窗口不一定会重新读取配置。

方法二：手动添加供应商（备用）

打开 cc-switch，选中 Codex，点击添加。
选择自定义配置。
供应商名称填写 88apis。
API Key 填写你在平台控制台创建的令牌。
请求地址填写 https://88apis.top/v1，然后保存。
点击启用。

保存并启用后，必须完全重启 Codex 客户端。只关闭当前会话窗口不一定会重新读取配置。

方法三：不使用工具

如果不使用 cc-switch，可以直接编辑 Codex 的配置文件。

配置 config.toml

常见位置：

macOS / Linux：~/.codex/config.toml
Windows：%USERPROFILE%\.codex\config.toml

model = "gpt-5.5"
model_provider = "custom"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.custom]
name = "88apis"
base_url = "https://88apis.top/v1"
wire_api = "responses"

配置 auth.json

常见位置：

macOS / Linux：~/.codex/auth.json
Windows：%USERPROFILE%\.codex\auth.json

{
  "OPENAI_API_KEY": "API_KEY"
}

如果你打开旧会话失败，检查旧会话里的 model_provider 是否和当前 config.toml 一致。名称不一致时，Codex 可能找不到对应提供商。

Codex 会话同步工具

如果你切换 Codex 的供应商后，旧会话在 Codex Desktop 或 /resume 里看不到，可以使用 codex-provider-sync 同步历史会话的供应商信息。

npm 方式（推荐）

先确认电脑已安装 Node.js，然后在终端执行：

npm install -g git+https://github.com/Dailin521/codex-provider-sync.git
codex-provider status
codex-provider sync

status：先检查当前 Codex 供应商和历史会话状态。
sync：把历史会话同步到当前正在使用的供应商。

Windows EXE 方式（可选）

Windows 用户如果不想使用 npm，也可以下载 EXE 版本。

下载 Windows EXE 查看项目地址

打开 CodexProviderSync.exe。
点击 Refresh。
选择目标供应商。
点击 Execute。

执行同步前建议完全退出 Codex。工具会自动备份；如果提示 SQLite 被占用，关闭 Codex 后再重试。

保留官方登录

如果你同时使用 Codex 官方登录和第三方 API，建议在 cc-switch 里开启这个设置。

打开 cc-switch，点击左上角齿轮进入设置。
在 通用 页找到 Codex 应用增强。
开启 切换第三方时保留官方登录。
回到 Codex 列表，在官方登录方式和 88apis 之间来回切换一次。
如果有多个官方登录方式，最后一次选中的官方登录方式会作为保留的登录账号。
确认登录账号后，最后必须切回 88apis 这类 API 方式。

开启后，切换到第三方 API 时会尽量保留 Codex 官方登录，方便继续使用官方插件、手机远程操作、语音输入等能力。最后停留在 88apis API 方式，Codex 才会继续走平台 API。

常见问题

401 是什么问题？

通常是 API Key 不正确、令牌被禁用、令牌过期，或客户端没有按 Authorization: Bearer API_KEY 格式传递。

为什么模型列表为空？

先确认 API Key 有可用模型权限；再确认客户端的 Base URL 是 https://88apis.top/v1，不是站点首页地址。

首字延迟和什么有关？

主要与客户端到站点、站点到上游、请求体大小、上游排队、流式响应建立速度有关。建议先用同一模型、同一 prompt、同一网络环境做对比。