很多人买了 Codex 会员或中转额度,却卡在「我的 API 链接到底是哪个」这一步:后台翻半天只看到一串 key,客户端里又填了错误地址,请求一直报错。这篇按「先去哪找、长什么样、填到哪、怎么验证」的顺序走一遍,给你一份能照着操作的自查流程。
很多人买了 Codex 会员或中转额度,第一步就卡住:后台翻半天只看到一串 key,却找不到该往客户端里填哪个地址;有的人随手把 key 当成链接粘进去,请求一直报错,还以为是自己网络有问题。其实「我的 API 链接是哪个」这件事有固定答案,只是它分散在几个地方,得按顺序找。
下面按「先去哪找、长什么样、填到哪、怎么验证」走一遍,你照着做基本能自查出来。如果中途发现站点给的信息自相矛盾,先别急着调参数,那多半是接入说明本身写得含糊。
先去哪找:API 地址通常出现在三个位置
找地址的第一原则是:谁卖给你额度,就先去谁那里找接入信息。不要从别人的截图或教程里抄一条域名,那是别人的账号对应的入口,你填进去只会一直连不上。三个高频位置按优先级排一下。
- 订阅或额度后台的「接入信息」区块,通常地址和 key 挨着放,key 旁边那一行才是地址,别把 key 本身当链接
- 下单后收到的邮件、订单详情或激活说明,有些渠道把地址写在卡密说明里,后台反而不展示
- 客户端自带的配置文档或示例,里面出现的默认地址属于模板值,必须换成你自己账号对应的那条
如果三个地方都翻遍还是只有 key,那说明这个渠道本身没把接入信息交代清楚。这时与其猜,不如先按下面这张表确认自己缺的是哪一类信息,再去问客服会更有针对性。
| 你手上有什么 | 大概率对应什么 | 下一步动作 |
|---|---|---|
| 只有一串 key | 缺少服务地址 | 去后台接入信息区或订单说明里找域名 |
| 有一条域名但不确定对不对 | 可能是模板默认值 | 和后台/邮件里的原文逐字比对 |
| 地址和 key 都有但仍报错 | 写法或路径有问题 | 按下一节的格式规则逐项排查 |
一条合格的 API 地址长什么样
判断地址对不对,不用懂技术,看格式就够了。合格的地址通常是 https 开头的域名,路径一般只到 /v1 这一层为止,后面不应该再接具体的接口名。多写一段路径,是最常见也最容易被忽略的错误来源。
这里要分清两个概念:服务地址和调用路径。服务地址是你填进客户端的那个根,调用路径由客户端自己在你填的根后面拼接。很多人把两者混在一起,手动写全了完整接口路径,结果客户端又拼了一次,自然就 404 了。
- 服务地址
- 填进客户端的那一段根,通常以 https 开头、到 /v1 为止
- 调用路径
- 客户端自动拼接的后续部分,不需要你手写
- Base URL / 端点
- 不同客户端叫法不同,指的都是同一个东西,只填一次
填进客户端的动作顺序
找到了地址也别一口气全填完。地址和 key 是两个独立字段,混着填很容易错位,尤其是粘贴时多带一个空格或换行,肉眼几乎看不出来。分开做、每步验一下,返工成本最低。
- 先只填地址把服务地址粘进 Base URL 那一栏,保存后确认没有多余空格,先不要动 key 和其他字段。
- 再填 key在单独的密钥字段里填 sk- 开头那串,别和地址填在同一格;填完检查首尾有没有带换行。
- 只填一个地址字段配置里若同时有「Base URL / 接口地址 / 端点」多个输入框,只填其中一个,其余留空,重复填写会互相覆盖。
- 先测连通再调参数发一条最小请求确认能返回,再去调模型名、超时和代理设置,一次改三四项会让你分不清是哪一步出的问题。
怎么验证填对了,以及报错先查哪一项
验证标准很朴素:能正常返回一次结果,就说明地址、key、模型名这三者至少是自洽的。剩下的调优是后话。反过来,报错信息本身就是线索,按它先定位到具体字段,比从头重填快得多。
| 报错表现 | 先怀疑谁 | 检查方向 |
|---|---|---|
| 401 / 鉴权失败 | key | 是否过期、是否复制不完整、有没有多带空格 |
| 404 / 找不到路径 | 地址 | 是不是多写了接口路径、是不是填了模板默认值 |
| 连接超时 | 网络或地址 | 域名能否访问、是否需要改网络环境 |
| 能连但结果异常 | 模型名或参数 | 模型名是否填错、参数格式是否符合文档 |
- 换过站点或换过网络环境后要重新确认一次,地址没变但链路可能变了
- 同一条地址在不同客户端里的写法要求可能不一样,优先按该客户端自己的接入说明来
- 拿不准延迟基线,可以到 /tools/speed-test 量一遍再对比
- 想了解各站点当期接入情况,去 /codex-radar 看一眼,比翻聊天记录靠谱
需要说明的是,上面这套流程主要适用于你从某个渠道拿到的服务地址。如果你用的是官方直连、地址由客户端内置好不需要手动填,那整篇基本用不上;同理,纯网页版聊天入口也不涉及填地址这件事。
下一步套完上面的步骤还对不上,就去站点信息页核对当期各渠道的接入说明和延迟情况,比自己在客户端里反复试要快。→常见问题
后台里只有一串 key,没看到地址怎么办?
先看订单详情和激活说明,很多渠道把接入地址写在那里而不是后台首页;再翻客户端的接入文档示例,示例里的域名换成你自己账号域名通常就对了。两边都没有,就直接问客服要一条可用的接入地址,问的时候把「用于 Codex 客户端」说清楚。
地址能打开但客户端一直报错,是地址错了吗?
不一定。地址能打开只说明域名通,还要看路径层级对不对、key 有没有粘错位、模型名是否在该站点支持下。排查顺序是:先只测地址加 key 的最小请求,通过后再加模型名,最后加代理和其他参数,一次只动一项。
换成另一个站点后,旧地址还能继续用吗?
能不能用取决于旧站点本身,跟你的客户端无关。换站后要重新填新地址和新 key,并且把旧的配置项清掉,避免客户端在两个地址之间来回切。旧账号里如果有余额,处理方式参考 /guides/stop-loss-and-migrate。