SwiftRelay

← 全部冲刺笔记

Codex API 中转站教程:SwiftRelay 三行接入

头几圈ZH

Codex 连不上 SwiftRelay?先看这几个常见报错

很多朋友第一次用 Codex 接 SwiftRelay,终端里蹦出一行认证失败或者端点无法访问的提示,心里就慌了。其实这类报错十有八九不是模型的问题,而是环境变量没有生效。SwiftRelay 是按 token 计费的 API 中转站,API 主机是 https://api.fastapirelay.com,只要把请求指到这个地址,再配上以 swft_ 开头的密钥,Codex 就能跑起来。

还有一种常见情况是密钥和地址写反了位置:有人把 swft_ 密钥粘进了 base URL 栏,或者把地址粘进了密钥栏。排查时记住两点:地址必须是 https://api.fastapirelay.com/v1,密钥必须是你的 swft_ key。这两样对不上,任何客户端都会报错,跟模型本身完全无关。

第三个常见报错是余额不足。SwiftRelay 没有任何订阅项目,也不需要办理会员,你充值多少余额就用多少,每次调用只扣除本次实际消耗的 token 费用。余额扣光之后再调用就会直接报错,充值之后立刻恢复,不需要重新配置任何东西。

另外注意,swft_ 密钥是个人凭证,不要分享给他人。一个账户最多可以同时使用 20 个可用的 API 密钥,万一某个密钥泄露,直接新建一个替换掉旧的即可,旧密钥立刻失效,不影响其他项目。

三行命令,几分钟接好 Codex

SwiftRelay 的接入速度很快,快得像短跑起跑:复制三行,粘贴,回车,第一单就能跑起来。官方给出的 Codex 接入命令就是下面这样,每一行单独执行:

01  export OPENAI_BASE_URL=https://api.fastapirelay.com/v1
02  export OPENAI_API_KEY=<你的 swft_ 密钥>

codex

跑完第三行,Codex 就会通过 SwiftRelay 的 OpenAI 兼容端点发起调用。整个过程不需要安装额外插件,不需要任何订阅,打开终端就能开始。对习惯命令行的开发者来说,这三行就是全部的配置成本,几分钟之内就能完成从零到第一单调用。

按 token 计费:花了多少,一笔一笔都有账

在 SwiftRelay 充值进去的余额就是你的全部预算,每次调用只扣除本次实际使用的 token 费用,没有任何隐藏 Charges。用量列表里会清清楚楚列出每次调用的 token 数和对应费用,账目透明,随时翻看,心里有数。

举个例子:假设你用 GPT-6.1 Sol 跑了一天,消耗了 100 万输入 token 和 100 万输出 token。按 SwiftRelay 定价页,输入每百万 token ¥1.25,输出每百万 token ¥6.15,这一天总共就是 ¥7.40,全部从余额里实时扣除。

同一套端点还可以接入 DeepSeek 和 GPT 系列的其他模型。比如 DeepSeek V4 Flash 输入每百万 token ¥1.90、输出 ¥7.60、缓存读取 ¥0.05;DeepSeek V4 Pro 输入 ¥8.40、输出 ¥25.25、缓存读取 ¥0.28;GPT-6 Astra 输入 ¥4.75、输出 ¥23.65、缓存读取 ¥0.47。不同项目用不同密钥,最多 20 个密钥并行,互不干扰。

充值、赠送与推荐奖励怎么算

新用户注册 SwiftRelay 就送 ¥1.6 体验金,可以直接用来跑第一单,亲身感受三行接入的速度。充值档位固定为 ¥10.00、¥50.00、¥100.00、¥200.00、¥500.00、¥1,000.00,按自己的节奏选择,随用随充。

推荐朋友注册并充值,你可以拿到对方每次充值 14% 的奖励;朋友再邀请的人充值,你还能拿到 3%。奖励可以提现,最低 ¥35.00 起提,也可以直接转进余额继续使用。另外,充值后 11 天内未使用的余额可以申请退款,扣除已使用部分和支付手续费之后原路退回。

遇到问题,去仪表盘里留言

如果按照上面的步骤操作之后仍然报错,排查顺序建议是:先确认 base URL 和 swft_ 密钥没有填反,再确认余额是否充足,最后查看用量列表里那次失败的调用返回了什么提示。SwiftRelay 的支持渠道就在仪表盘的站内消息里,登录之后直接留言即可,没有邮件支持,所以记得常看消息中心的回复。

总结一下:Codex 接 SwiftRelay 只需要三行命令,按 token 扣费,注册送 ¥1.6,有问题去站内消息问。现在就打开 SwiftRelay 官网注册账号,复制那三行命令,跑起你的第一单吧!

接着读

又来跑一圈?登录