找到下一项该检查的设置。
结合 HTTP 状态码与错误信息定位问题。每次只改一项设置,方便确认究竟是哪一步解决了请求。
本页目录
先核对请求信息
- 确认目标域名是 codex.aicpr.icu,且 URL 中只有一次 /v1。
- 确认接口与模型支持的 API 一致:Chat Completions 使用 messages,Responses 使用 input。
- 确认应用实际运行时能够读取 PRISMROUTE_API_KEY。在另一个终端设置的变量,或仅在前端构建时设置的变量,不一定能传给服务端进程。
- 从模型目录复制准确的模型 ID,并检查 API 密钥的分组与限制。
对照 HTTP 状态码
| 状态码 | 需要检查的内容 |
|---|---|
| 400 / 422 | 查看错误指出的参数、请求 JSON 与模型能力,先用最简文字示例,再逐项增加可选参数。 |
| 401 | 确认密钥有效,并使用 Authorization: Bearer … 请求头;检查多余空格、引号或其他服务商的密钥。 |
| 403 | 阅读返回信息,检查密钥权限、账户限制以及目标模型的访问权限。 |
| 404 | 检查完整接口路径和准确模型 ID。接口不存在与模型不可用,需要采取不同的修复方式。 |
| 429 | 查看具体限制说明、请求频率、密钥限制与账户状态。如返回 Retry-After,请按提示等待,避免立即循环重试。 |
| 5xx | 保留请求 ID 与发生时间,可能是服务或上游异常;重新发起请求前,先检查请求记录。 |
明确处理超时
客户端超时,并不代表服务端已经停止处理。若控制台有请求记录,请先检查结果。需要重试时,应设置次数上限与退避间隔,避免反复提交结果未知的操作。
如果同一个请求在终端中成功、在应用中失败,请比较基础地址、环境变量、代理设置与 SDK 版本。API 调用应放在服务端,不要为了绕过浏览器限制而暴露私有密钥。
核对流式输出格式
Chat Completions 的文字增量通常位于 choices[].delta.content;Responses 使用有类型的事件,例如 response.output_text.delta。空文字或只含元信息的数据块,不一定代表失败。
若文字总是在最后一次性出现,请检查应用或你所控制的反向代理是否缓冲响应。收到响应头之前失败,与已经输出部分文字后中断,是不同的问题,请记录具体表现。
向客服提供有效信息
请提供带时区的发生时间、接口路径、模型 ID、HTTP 状态码、返回的请求 ID(如有)、SDK 或客户端版本,以及脱敏错误信息。不要附上 API 密钥、密码或私人提示词内容。
客服邮箱:321921230@qq.com