常见错误与排查
调用接口时常见的错误提示、原因和处理方法。
更新于 2026-11-15
调用失败时,接口会在响应中返回错误信息。下表列出常见的提示及处理方法。
密钥相关
| 错误提示(节选) | 原因 | 处理方法 |
|---|---|---|
| 未提供令牌 | 请求头中没有 API 密钥 | 检查请求头 Authorization: Bearer sk-xxxx,或 Claude Code 的 ANTHROPIC_AUTH_TOKEN 是否已设置 |
| 无效的令牌 | 密钥不存在、复制不完整或已被删除 | 在控制台「API 密钥」页面重新复制密钥 |
| 该令牌已过期 | 密钥超过了设置的过期时间 | 编辑密钥,修改过期时间,或改为永不过期 |
| 该令牌额度已用尽 | 达到了密钥自身的额度上限 | 编辑密钥,提高额度或开启无限配额 |
| 该令牌状态不可用 | 密钥已被禁用 | 在「API 密钥」页面重新启用 |
余额与权限
| 错误提示(节选) | 原因 | 处理方法 |
|---|---|---|
额度不足 / user quota is not enough |
账户余额不足以支付本次请求 | 在「钱包」页面充值 |
| 该令牌无权访问模型 xxx | 密钥设置了「模型限制」,不包含该模型 | 编辑密钥的模型限制,或换用允许的模型 |
| 无权访问该分组 | 密钥所选分组对当前账号不可用 | 编辑密钥,改选可用的分组 |
| 分组 xxx 下模型 xxx 无可用渠道 | 该模型在当前分组下不可用,或模型名称写错 | 核对模型名称;在模型详情页查看它支持哪些分组 |
请求频率
| 错误提示(节选) | 原因 | 处理方法 |
|---|---|---|
| 您已达到请求数限制 | 短时间内请求次数超过了限制 | 降低并发或请求频率,稍后重试 |
排查建议
- 先看使用日志:控制台「使用日志」会记录请求的模型和结果,可以确认请求是否到达平台。
- 核对 Base URL:OpenAI 格式用
https://niul-ai.cn/v1;Claude Code 用https://niul-ai.cn,不加/v1。 - 核对模型名称:必须与「模型与价格」页面一致,并且该模型支持你使用的接口格式。
如果以上方法都无法解决,请通过公告中的联系方式联系我们,并附上请求时间和错误信息(不要发送完整的 API 密钥)。