TokenDuo

常见错误与排查

调用接口时常见的错误提示、原因和处理方法。

更新于 2026-11-15

调用失败时,接口会在响应中返回错误信息。下表列出常见的提示及处理方法。

密钥相关

错误提示(节选) 原因 处理方法
未提供令牌 请求头中没有 API 密钥 检查请求头 Authorization: Bearer sk-xxxx,或 Claude Code 的 ANTHROPIC_AUTH_TOKEN 是否已设置
无效的令牌 密钥不存在、复制不完整或已被删除 在控制台「API 密钥」页面重新复制密钥
该令牌已过期 密钥超过了设置的过期时间 编辑密钥,修改过期时间,或改为永不过期
该令牌额度已用尽 达到了密钥自身的额度上限 编辑密钥,提高额度或开启无限配额
该令牌状态不可用 密钥已被禁用 在「API 密钥」页面重新启用

余额与权限

错误提示(节选) 原因 处理方法
额度不足 / user quota is not enough 账户余额不足以支付本次请求 在「钱包」页面充值
该令牌无权访问模型 xxx 密钥设置了「模型限制」,不包含该模型 编辑密钥的模型限制,或换用允许的模型
无权访问该分组 密钥所选分组对当前账号不可用 编辑密钥,改选可用的分组
分组 xxx 下模型 xxx 无可用渠道 该模型在当前分组下不可用,或模型名称写错 核对模型名称;在模型详情页查看它支持哪些分组

请求频率

错误提示(节选) 原因 处理方法
您已达到请求数限制 短时间内请求次数超过了限制 降低并发或请求频率,稍后重试

排查建议

  1. 先看使用日志:控制台「使用日志」会记录请求的模型和结果,可以确认请求是否到达平台。
  2. 核对 Base URL:OpenAI 格式用 https://niul-ai.cn/v1;Claude Code 用 https://niul-ai.cn,不加 /v1。
  3. 核对模型名称:必须与「模型与价格」页面一致,并且该模型支持你使用的接口格式。

如果以上方法都无法解决,请通过公告中的联系方式联系我们,并附上请求时间和错误信息(不要发送完整的 API 密钥)。

上一篇:CC Switch 一键导入

下一篇:Token 是什么