报错“未设置 API 密钥”：先把 Codex 的三行配置补齐
独立开发者用 Codex 接 SwiftRelay，最常撞上的第一道关，就是启动后提示“未设置 API 密钥”。这类报错不用慌，它通常不是代码写错，而是终端里缺少环境变量。SwiftRelay 的接入方式很直接：复制三行，跑一次命令，几分钟就能连上。
在终端里依次执行下面三行，把尖括号里的内容替换成你自己的 swft_ 密钥：
01 export OPENAI_BASE_URL=https://api.fastapirelay.com/v1 02 export OPENAI_API_KEY=<your swft_ key> 03 export OPENAI_API_KEY=<your swft_ key>
codex
如果你看到的是“密钥无效”，先确认复制时没有带空格、换行或多余引号。SwiftRelay 的密钥以 swft_ 开头，在控制台里可以查看和使用。一个账号最多可同时启用 20 个 API 密钥，建议按项目分开管理，出问题时也更容易定位是哪一把密钥在用。
报错“无法连接到接口地址”：核对主机与路径
密钥补上之后，如果 Codex 提示“无法连接到接口地址”或“请求地址不可达”，检查点就两个：主机名和路径。OpenAI 兼容客户端统一使用 https://api.fastapirelay.com/v1 作为基础地址，API 密钥填 swft_ 开头的密钥。
常见的小坑包括：路径后面多写了一个斜杠，把 /v1 写成了 /v1/chat/completions，或者把基础地址直接填到了模型名上。另一个常见原因是环境变量只在某个终端窗口里生效，换一个窗口就失效。做法很简单：在准备运行 codex 的那个窗口里重新导出变量，再启动 Codex。
如果地址和密钥都确认无误，却仍然提示“连接失败”，那就回到控制台里的消息功能核对一下。SwiftRelay 的支持通过登录后的控制台消息提供，没有单独的邮箱入口，把报错现象和你已经做过的排查写清楚，沟通会更顺。
报错“模型不可用”：Codex 该配哪些模型
Codex 走的是 SwiftRelay 的 OpenAI 兼容端点，因此模型名必须与端点支持范围匹配。如果提示“找不到该模型”或“模型不可用”，多半是把别处的模型标识直接搬了过来，或者把模型名写错了。
本文只推荐 SwiftRelay 定价页上列出的四个模型：
- GPT-6 Astra，模型标识 gpt-6-astra；
- GPT-6.1 Sol，模型标识 gpt-6.1-sol；
- DeepSeek V4 Flash，模型标识 deepseek-v4-flash；
- DeepSeek V4 Pro，模型标识 deepseek-v4-pro。
在 Codex 的模型配置里填入上面这些标识，再配合前面三行环境变量启动。模型名大小写要一致，连接方式保持 OpenAI 兼容即可，不需要额外的适配脚本。
报错“余额不足”：按量计费与充值怎么选
跑通连接后，如果 Codex 提示“余额不足”，说明该充值了。SwiftRelay 是按令牌计费的中转站，没有月费，也没有什么套餐要订阅：先充值余额，之后每次调用只扣实际用掉的部分，用多少扣多少。
可选的充值金额是 ¥10.00、¥50.00、¥100.00、¥200.00、¥500.00 和 ¥1,000.00。新用户注册还有 ¥1.6 的赠送额度，可以先用它跑通一个小流程，确认调用记录和费用明细都能正常显示，再决定充多少。
想算得更清楚，可以看一个示例。假设某一天你用 GPT-6.1 Sol 处理了 100 万输入令牌和 100 万输出令牌，按 SwiftRelay 定价页每 100 万令牌的价格计算，输入为 ¥1.25，输出为 ¥6.15，合计 ¥7.40。同样这一天量，如果换成 DeepSeek V4 Flash，输入为 ¥1.90，输出为 ¥7.60，合计 ¥9.50。
再比如用 GPT-6 Astra，输入 100 万令牌是 ¥4.75，输出 100 万令牌是 ¥23.65，合计 ¥28.40。缓存读取也有单独价格：GPT-6 Astra 为 ¥0.47，GPT-6.1 Sol 为 ¥0.25，DeepSeek V4 Flash 为 ¥0.05，DeepSeek V4 Pro 为 ¥0.28。示例只用于说明算法，实际扣费以你当天的真实用量为准。
报错“看不到调用记录”：用量和费用明细在哪里
有的开发者反馈“调用完成了，但账单对不上”，这类问题的答案在控制台的用量列表里。SwiftRelay 会列出每次调用的令牌数量和费用，你可以按时间逐条核对，看看是不是把多次请求记成了单次。
排查时先确认三件事：请求确实经过了 SwiftRelay 的地址，密钥属于预期的那一个账号，模型标识没有写错。如果这些都对得上，明细里的数字就是实际扣费依据，不用凭感觉估算。
退款规则也写得很清楚：充值后 11 天内，未使用的额度可以申请退款，扣除已经用掉的部分和支付手续费。也就是说，测试阶段少充一点、验证清楚再追加，是相当稳妥的做法。
报错“邀请奖励未到账”：奖励规则与提现门槛
如果你在做开发者分享，顺带邀请同行使用 SwiftRelay，可能遇到“奖励未到账”的疑问。规则是：你邀请的人每次充值，你获得该次充值的 14%；你邀请的人再往下邀请的人充值，你获得其中 3% 的部分。
奖励到账后可以提现，最低提现金额为 ¥35.00；也可以直接转入余额继续使用，不必等提现。核对时注意区分直接邀请和间接邀请两段比例，避免把 14% 和 3% 混在一起算。
一周下来，从配置、连接、选模型到看用量，SwiftRelay 的路径都不复杂：复制三行就能跑，按令牌扣费，用多少算多少。现在就注册 SwiftRelay，把 ¥1.6 的赠送额度用起来，让你的 Codex 马上进入工作状态。