1 Switch:为 Codex 配置自有 API 服务
1 Switch 用于让 Codex 使用您自行准备的 API 服务,例如公司自建接口、其他中转服务或模型厂商的 API 接口。它不进行供应商调度,也不比较价格:您选定哪个供应商,请求即按原样发往该供应商。
责任边界
选用自定义供应商后,发往该供应商的请求不经过 123 GPT 的服务器。以下四项由此决定, 开始配置之前请先确认可以接受。
可用性
连接失败、接口报错、限速、模型下线等情况均由该供应商负责。 123 GPT 无法获知这些请求的状态,也无法介入处理。
计费
费用按该供应商的价目结算,从您在该供应商处的余额中扣除,与 123 GPT 的余额无关。
内容与审核
123 GPT 不审核、不精选、不推荐任何供应商。列表中出现哪些条目完全由您自行填写。
余额与用量的统计范围
本应用的余额与用量两页仅统计 123 GPT 的消耗。 自定义供应商的消耗不在其中,属于正常现象。
首次切换到某个自定义供应商前会出现确认弹窗,须勾选「我已知悉」后方可继续。 更换供应商或修改地址后会再次确认,因为责任主体已经改变。切回 123 GPT 不再确认。
切换生效后,应用界面的配色由品牌绿变为琥珀色,顶部、侧栏、底部状态栏与窗口标题 均会标注「请求不经过 123 GPT」。此设计用于在出现故障时快速判断应由哪一方处理。
进入方式
在侧栏打开「1 Switch」
点击 侧栏› 1 Switch,供应商列表位于详情页。123 GPT总览充值用量使用帮助技能中心修复 ChatGPT 界面语言1 Switch更多功能138****8888已登录
添加供应商
点击「添加供应商」,填写三项内容
- 名称:必填,仅供识别。可使用中英文、数字、空格与
- _ ., 不得与已有条目重名。该名称会出现在界面多处,建议使用便于辨认的短名。 - API 地址:供应商提供的接口地址。结尾是否带
/v1均可, 但不应填入/responses等具体接口路径。 - API Key:供应商提供的密钥。官网为选填项, 填写后可从列表直接打开该供应商的网站。
添加供应商名称例如:公司中转、备用供应商API 地址https://api.example.com/v1API Keysk-••••••••••••••••- 名称:必填,仅供识别。可使用中英文、数字、空格与
保存后执行「测试连接」
该功能会读取供应商的模型列表供您选择,随后发送一次真实请求并显示返回内容, 可用于区分地址错误与密钥错误。
接入前提:该 API 须支持 OpenAI 的 Responses 接口,即 Codex 使用的接口规范。 仅支持 Chat Completions 的服务无法接入。请求按原样转发,模型名称取自您在 Codex 中的选择, 因此还需确认该供应商支持对应的模型。
API Key 仅保存在本机,并按登录账号隔离,不会上传至 123 GPT。 但其存储形式为明文,请按此前提管理第三方密钥。
从 CC Switch 导入
若本机安装了 CC Switch,列表标题行会出现 从 CC Switch 导入供应商。 点击后会列出其中已配置的 Codex 服务,勾选并确认地址后即可导入。
仅读取
导入过程只读取 CC Switch 的配置,不会修改其中的任何内容。
一次性
导入后两处配置相互独立。CC Switch 后续的改动不会同步到此处。
导入前请逐条核对地址。CC Switch 的部分配置中保存的是其自身的本地端口, 直接导入将得到一个无法连接的供应商,而该故障的表现与导入操作没有明显关联,不易排查。 确认页中可直接修改地址。
两种切换方式
页面顶部用于选择供应商的切换位置,两种方式的适用场景不同。
在哪里切换供应商
在 1 Switch 中切换
在本页选择供应商,Codex 模型列表不变。
在 Codex 中切换
在 Codex 的模型菜单中直接选择供应商。
在 1 Switch 中切换(默认)
同一时间只有一个供应商生效,在本页点击选择进行切换。 Codex 的模型菜单保持原样。
在 Codex 中切换
将「供应商 × 模型」逐条写入 Codex 的模型菜单,在 Codex 内直接选择。 适用于需要频繁切换供应商的场景。
在 Codex 中切换的效果
选择该方式后,需在 1 Switch 页为每个供应商勾选要使用的模型 (在供应商的编辑弹窗中,从自动获取的列表选择或手动添加;也可整批映射 123 GPT 提供的模型)。保存后点击「应用更改」。 Codex 的模型菜单随之变为下图的形式。
Codex · 选择模型
菜单中不带前缀的模型仍走 123 GPT 并照常计费。原有模型不会减少, 无需、也不应将它们再勾选一遍。
菜单变更需完全退出 Codex 后重新打开才会显示,该文件由 Codex 在启动时读取。
查看自定义供应商的用量
在用量页标题下方的下拉菜单中选择对应供应商。该栏与 123 GPT 栏的数据来源不同, 不可直接比较,也不应相加。
123 GPT 栏
数据取自计费账单,含金额,可用于对账。
自定义供应商栏
数据取自本机代理的请求统计,不含金额(123 GPT 不掌握该供应商的定价), 且服务未运行期间的请求不计入其中。
实际账单请在该供应商自己的后台查询。
切回 123 GPT
在 1 Switch 页选中列表首行的 123 GPT 即可切回,界面配色随之恢复为品牌绿。
服务正在运行时,供应商切换会立即应用,无需重启 Codex。服务停止时,选择只会记录下来, 下次开启服务时生效;已保存的供应商列表会一直保留,直至您主动删除。
