Skip to content

错误排查 ​

401 / 403 ​

检查 API Key 是否完整、是否被禁用,以及分组是否允许当前接口。Anthropic 原生接口还要确认客户端发送了正确的 anthropic-version。

404 model not found ​

模型名称必须使用分组实际支持的名称。先请求模型列表,或在控制台查看分组模型配置,不要直接照抄其他平台的模型名。

429 Too Many Requests ​

常见原因:账号并发已满、上游限流、用户或分组 RPM 限制。降低并发、等待 Retry-After、切换可用分组,并在使用记录中确认是否发生了账号切换。

5xx 或 upstream timeout ​

长文本、图片和视频请求可能耗时较长。服务端调用应提高超时;Seedance 创建任务后应轮询任务状态,不要在客户端重复提交创建请求。

Codex 提示没有内置图片生成工具 ​

这通常不是服务端账号或分组未开启生图,而是 Codex 自定义 Provider 仍使用旧的 requires_openai_auth = true,导致新 task 没有注册客户端本地图片执行器。

请改用 API Key Mode,保留 auth.json 中的 API Key,彻底退出所有 Codex 进程后新建 task。完整配置和残留进程检查见 Codex 无法生图排查。

浏览器跨域问题 ​

长期 API Key 不建议放在前端。浏览器直连还会受到 CORS、代理和密钥泄露风险影响,生产环境应通过自己的后端转发。

瑞科 API 文档