很多人第一次搞 Codex 中转站,卡的不是原理,而是顺序:先买还是先测、参数从哪抄、填完连不上到底错在哪。这篇按「选站—拿参数—写配置—跑通验收」四步排一遍,每步说清看什么、填什么、哪里最容易填错。读完你能自己判断问题出在站点侧还是配置侧,也知道什么情况下这条路不适合你。
很多人第一次给 Codex 配中转站,卡住的不是原理,而是顺序。先付款还是先测试、参数从哪抄、填完连不上到底该查哪一层,这三点没想清楚,折腾半天还在原地打转。这篇按「选站—拿参数—写配置—跑通验收」四步排一遍,每步只说看什么、填什么、哪里最容易填错。
读完之后你应该能做到两件事:一是自己判断问题出在站点侧还是配置侧,二是知道什么情况下这条路根本不适合你——不是所有人都需要中转站,直连稳定、用量又小的,硬上反而多一层故障点。下面每一步都配了可核对的动作,照着走就行。
第一步:先把站选对,别急着付款
选站之前先想清楚你要的是什么:是能跑 Codex 的对话兼容接口,还是只支持部分模型的站。这两类不是一回事。别只看首页宣传,拿一个你真实会用的小任务去问客服能不能支持,对方答得含糊或者只会复制话术,基本可以先放一边。
| 先看什么 | 合格的样子 | 遇到这种先跳过 |
|---|---|---|
| 上游渠道 | 明示走的哪家、怎么转发 | 只写「稳定」「高速」不给来源 |
| 余额查询 | 能随时看到剩余量、有明细 | 只能问客服查,自己看不到 |
| 退款条款 | 写清楚什么情况能退、怎么退 | 条款含糊或压根没写 |
| 模型列表 | 和服务条款对得上、拼写规范 | 列表和实际能调的模型对不上 |
粗筛之后,把候选列出来横向对一遍。站内的站点目录和排行可以帮你缩小范围,但排行只是参考维度之一,别拿它当唯一依据。真正决定的是你自己的实测:小额试水跑通再谈长充,额度和门槛这类数字到 /prices 看当时的口径,别凭印象估。
- 用真实小任务问客服,看回答是否具体
- 核对上游渠道、余额查询、退款条款三条
- 到 /sites/all 和 /rankings 把候选横向对一遍
- 小额试水,跑通再考虑长期充值
- 额度与门槛到 /prices 看当时的数字,不要估
第二步:把三个参数抄全——Base URL、Key、模型名
拿参数这一步,出错的八成是地址。Base URL 要抄到版本路径那一级,末尾要不要斜杠、带不带版本前缀,各家写法不一样。抄错这一级,最常见的结果就是 404 或 401,而很多人第一反应是怀疑 Key 填错了,白折腾。
- 抄地址从站点文档原样复制 Base URL,先别手动改;复制完对着文档再核一遍有没有少路径段。
- 建 Key单独建一把只给 Codex 用的 Key,别和其它工具混用。日后要吊销、要对账,单独一把最省事。
- 核模型名模型名以站点模型列表的写法为准,不要按官方名自己拼。不确定就到 /models 或该站文档里对拼写。
- Base URL
- 请求的根地址,路径层级各家不同,是 404 的头号来源
- Key
- 一把一用,方便单独吊销和对账
- 模型名
- 以站点列表为准,不能按官方名猜
还有一点容易被忽略:Key 的权限范围。有的站可以限制 Key 只能调某几个模型,如果你的任务只用到一两个模型,顺手限一下,泄露时的损失面小很多。这一步花不了一分钟,但很多人是出了事才想起来。
第三步:配置文件怎么填、填在哪
配置的第一原则是隔离。用环境变量或者独立配置文件把中转参数单独放,别直接覆盖掉原来直连的那份配置。不然以后想切回官方,你得翻半天找改过哪几行。切换和回退,至少自己完整演练一次,确认两条路都能走通再放着。
连不上的时候,按固定顺序排查,不要东一榔头西一棒子:先看地址通不通,到 /tools/speed-test 量个基线;再判断 Key 是不是被拒;最后才怀疑模型名和请求体格式。这个顺序能把大部分问题在两三分钟内定位到层。
| 现象 | 先查哪层 | 常见原因 |
|---|---|---|
| 连接超时、拒绝 | 网络与地址层 | 地址抄错、需要代理没开 |
| 401、无权限 | Key 层 | Key 填错、被吊销、权限没开 |
| 404、模型不存在 | 模型与路径层 | 模型名拼错、路径层级不对 |
| 能连但回话异常 | 站点侧 | 被降级、换模型、限流 |
第四步:跑通之后做验收,别只看「能回话」
能回一句话不算跑通。拿一个会触发长输出、多轮上下文的小任务完整跑一遍,看流式输出断不断、中途会不会被截断、上下文长了之后质量掉不掉。这些才是你日常真正会碰到的场景,一次简单问答测不出来。
还要留意是不是被悄悄换了模型或者降了级。同一段提示词分别发给候选的两家站,对比表现差异;判断方法可以到 /tools/verify 和 /tools/quality-check 对照着做。差异明显到要怀疑换模型的,就别将就了。
- 用一个会触发长输出的小任务完整跑一遍
- 观察流式输出是否断续、是否中途被截断
- 同一提示词跨两家站对比,判断是否被降级
- 记录首次可用时间、报错码和响应耗时,留作排查依据
最后把验收结果记下来:哪天跑通的、用的哪套参数、出现过什么报错码、响应大概多久。真出问题时,这段记录比「就是连不上」有用得多,客服那边也更容易帮你定位。什么情况下不适合继续折腾?如果换了两三家站、排查顺序也走完了还是不稳定,那问题大概率不在你的配置上,该换思路而不是继续调参数。
下一步选站这步最花时间也最影响后面,建议先把候选列在站内站点目录里横向对一遍,再看排行做参考,别一上来就充值。→常见问题
Codex 中转站一定要开代理才能用吗?
不一定,取决于站点域名是否直连可达以及你的网络环境。判断办法是先不开代理直接请求一次,看是超时还是返回鉴权错误:超时多半是网络层,返回 401/403 才是 Key 或权限问题。开了代理反而变慢或报错,就说明这条链路不需要它。
填完配置一直报错,先改哪里?
按顺序来:先确认 Base URL 拼到哪一级、有没有多余斜杠;再确认 Key 是否带空格或复制不全;最后核对模型名写法。这三步都对了还报错,就把完整报错码发给站方客服,同时说明你用的是哪个客户端、什么时候开始的。
跑通了是不是就可以直接充大额?
不建议。先小额试水跑几天,观察延迟稳定性、额度扣减是否对得上、客服响应速度,再按月充。站点故障、限速或调价都可能发生,金额以自己能承受损失为上限,充之前把退款条款抄下来存一份。