Codex 编码助手用户文档

主题

常见问题 ​

本页按“现象 -> 原因 -> 处理方式”的顺序整理，建议先确认地址、API Key 和模型名是否填对。

401 鉴权失败 ​

现象 ​

客户端提示未授权、鉴权失败，或者请求直接返回 401。

常见原因 ​

  • 填入的是平台登录账号密码，不是 API Key
  • API Key 复制时遗漏了字符
  • API Key 前后多了空格或换行

处理方式 ​

  1. 回到平台后台重新检查 API Key。
  2. 重新复制后粘贴到客户端。
  3. 如果仍然失败，删除旧 Token 并重新创建一个新的。

余额不足 ​

现象 ​

请求发出后提示额度不足、余额不足，或者无法继续调用模型。

常见原因 ​

  • 账号还没有充值
  • 充值尚未到账
  • 余额已经被之前的调用消耗完

处理方式 ​

  1. 回到后台确认当前余额。
  2. 如果刚充值，刷新页面并检查账单记录。
  3. 余额不足时重新充值后再试。

模型不可用 ​

现象 ​

客户端提示模型不存在、模型不可用，或者请求返回模型相关错误。

常见原因 ​

  • 模型名填写错误
  • 当前客户端选择的模型不是平台默认推荐模型

处理方式 ​

  1. 将模型名改为 gpt-5.4。
  2. 保存后重新发起一次请求。

Base URL 填错 ​

现象 ​

客户端无法连接，或者始终报地址错误、请求失败、找不到接口。

常见原因 ​

  • 漏写 /v1
  • 把后台页面地址当成 API 端点
  • 手动输入时多写或少写了字符

处理方式 ​

请统一使用：

text
https://codex.xiamp.net/v1

Token 复制不完整 ​

现象 ​

看起来已经填了 Token，但仍然请求失败。

常见原因 ​

  • 创建后没有立刻复制完整内容
  • 粘贴时只粘贴了一部分
  • 复制时带上了额外空格

处理方式 ​

  1. 删除客户端里的旧值。
  2. 从后台重新复制完整 Token。
  3. 粘贴后确认前后没有空格。

请求超时 ​

现象 ​

客户端长时间没有返回，或者直接提示超时。

常见原因 ​

  • 当前网络不稳定
  • 客户端配置虽然正确，但连接状态不稳定
  • 发送的请求较大，等待时间较长

处理方式 ​

  1. 先用一个简短问题测试连接。
  2. 确认 Base URL、API Key 和模型名都正确。
  3. 更换网络后再次尝试。