Skip to content
Codex 安装接入与使用

常见报错以及解决方法 ​

先记录客户端、时间、分组、模型 ID 与报错原文,再按状态码排查。一次只修改一个参数,方便确认问题来源。

一、401:认证失败 ​

  1. 重新从控制台复制 API Key,清除首尾空白。
  2. 确认密钥仍处于启用状态,且不是网页登录令牌。
  3. 核对请求的服务地址是否为 Omini API。
  4. 检查客户端使用的认证头:Bearer 与 x-api-key 应按协议填写。
  5. 完全退出仍读取旧配置的客户端,再重新启动。

二、403:分组或模型权限 ​

查看密钥绑定的分组,确认它开放了目标模型与相应接口。若客户端还会调用其他辅助模型,也要检查这些模型的权限。

三、404:路径或模型不匹配 ​

  • OpenAI 兼容 Base URL 通常为 https://api.omini.cn/v1。
  • Claude Code 的网关根地址示例为 https://api.omini.cn。
  • 检查是否拼出了 /v1/v1。
  • 检查模型 ID、接口协议与分组说明是否一致。

四、429:频率、并发或额度限制 ​

查看错误内容和控制台状态,区分请求频率、同时执行数与用量额度。减少同时运行的任务;对临时限流按响应提示等待后有限重试。

五、5xx 或请求超时 ​

先用短消息复现,检查服务状态与网络。长输出可能需要更长的读取超时。对于已经生成结果的请求,确认控制台状态后再重试,避免重复操作。

六、切换配置后仍使用旧模型 ​

核对 CC Switch 中当前启用项、终端环境变量和项目级配置。保存服务商并不等于启用它,修改后也应重启正在运行的旧进程。

七、模型能聊天,但工具或图片报错 ​

聊天、工具调用、图像输入、图像生成和长上下文是不同能力。检查当前客户端、接口和分组是否同时支持该功能。

八、联系支持时需要什么 ​

提供请求 ID、时间、客户端版本、模型 ID、分组和报错原文,按 使用帮助 联系支持。截图中遮挡完整 API Key。

Omini API · 安装、接入与使用指南