SuperFast AISuperFast AI文档中心
开始使用

第一次连接 Codex

创建密钥、配置服务商,再用一条消息验证连接。

按“创建密钥 → 配置服务商 → 小量验证”的顺序接入。本站账户与 OpenAI / ChatGPT 账户是不同的账户体系,余额也不互通。

1. 创建与模型匹配的密钥

登录 控制台,打开「API 密钥」,选择支持目标模型的分组。建议为本地编程工具单独创建密钥,并根据需要设置额度和有效期。

从 模型广场 复制目标模型 ID。确认分组支持 Responses 接口和所需工具能力。

2. 安装客户端

桌面用户从 OpenAI 官方桌面文档 进入下载渠道;终端用户参考 Codex CLI 教程。

CC-Switch 是可选的第三方配置管理工具,从 项目发布页 获取。已有配置先备份,不必为了首次接入开启历史迁移功能。

3. 配置 SuperFast 服务商

优先使用控制台的「导入到 CCS」,导入后检查实际写入的地址、模型、密钥与协议,再启用供应商。

配置项 内容
名称 SuperFast
Codex base_url https://api.sfapi.de/v1
国内线路 base_url https://api-cn.sfapi.de/v1
协议 responses
模型 从本站模型广场复制的可用模型 ID
密钥 对应分组的本站 API Key

地址以最终请求路径为准:Codex 直接连接本站时,应请求 /v1/responses。某些工具的“主机地址”字段会自动追加 /v1,另一些“Base URL”字段不会。不要把“不加 /v1”当成所有客户端通用的规则,也不要拼成 /v1/v1/responses。

手动配置方式及环境变量见 Codex CLI。使用已有 ChatGPT 登录时,要确认当前模型供应商确实切到了 SuperFast;不能仅凭登录邮箱判断请求走向。

4. 重启并核验

保存配置后退出并重新启动客户端;macOS 可用 ⌘Q,Windows 使用应用的退出入口并确认后台进程已结束。新建对话,发送一条简短测试消息。

随后在本站「使用记录」核对时间、模型、密钥与费用。看到正常回复且有匹配记录,才能确认这次请求经过本站。测试也可能计费。

5. 出错时怎么做

  • 401:核对密钥是否正确、过期、禁用,以及实际发送给哪个地址。
  • 404:检查最终请求路径和协议,避免缺少或重复 /v1。
  • 503:可能没有可用上游、分组不匹配、通道限流或临时故障,结合错误正文判断。
  • 余额 / 额度提示:不要忽略。先确认提示来自哪个账户、当前供应商和实际请求地址。
  • 切换后找不到历史:先备份本地状态,核对供应商与历史筛选;迁移工具不是接入的必要步骤,也不能保证恢复所有历史。

资料依据:OpenAI 认证说明 · 自定义模型供应商。

最后更新:2026-11-05模型以官方模型广场为准 ↗