常见问题
使用过程中的常见疑问解答
基础问题
Access Token 和官方 API Key 有什么区别？
Access Token 是本系统发放的统一密钥，可以调用所有支持的供应商 API，统一计费。无需在各供应商处分别申请 API Key。
为什么推荐使用 Claude Code / Codex？
这两款是官方推出的终端编程工具，可以直接在你的项目目录中运行，理解整个代码库上下文，进行代码修改、Bug 修复等操作。比网页聊天更高效。
环境变量设置后不生效？
请确保：
- 设置后重新打开终端
- 检查变量名拼写（区分大小写）
- Windows 用户注意使用「用户变量」而非「系统变量」
认证相关
报错 "API key is Missing"（401）
原因： 请求中缺少鉴权 Header。
解决方案： 根据使用的供应商添加对应的鉴权 Header：
- OpenAI：
Authorization: Bearer sk-pat-xxx - Anthropic：
x-api-key: sk-pat-xxx - Google：
x-goog-api-key: sk-pat-xxx或 Query 参数?key=sk-pat-xxx
报错 "Incorrect API key format is provided"（401）
原因： 使用 OpenAI 端点时，Header 格式不正确。
解决方案： OpenAI 端点要求使用 Bearer 格式：
✗ Authorization: sk-pat-xxx
✓ Authorization: Bearer sk-pat-xxx
报错 "Incorrect API key is provided"（401）
原因： Access Token 无效或已被删除。
解决方案：
- 检查 Token 是否以
sk-pat-开头 - 确认 Token 是否仍然有效（可能已被重置或删除）
- 前往平台「个人令牌」页面重新创建一个新的 Token
Anthropic 端点用了 Authorization: Bearer 还是不行?
原因： Anthropic 端点使用的鉴权 Header 与 OpenAI 不同。
解决方案： Anthropic 端点必须使用 x-api-key，而不是 Authorization: Bearer。同时需要添加 anthropic-version: 2023-06-01 Header。
额度与限流
报错 "You have reached your usage limits."（402）
原因： 账户余额 + 信用额度已耗尽。
解决方案：
- 前往平台查看当前余额和消费情况
- 联系管理员充值或调整信用额度
- 检查是否有异常高消费（可在用量统计中查看明细）
报错 "Too many requests!"（429）
原因： 每分钟请求次数（RPM）超出限制。
系统使用令牌桶算法，在租户级别和单个 Access Token 级别分别控制请求频率。
解决方案：
- 降低请求频率，适当添加延时/退避策略
- 如果是 Token 级别限流，可以创建多个 Token 分散请求
- 联系管理员提升 RPM 上限
模型相关
报错 "Model xxx is not accessible: Not Found!"（403）
原因： 请求的模型 ID 在系统中不存在。
解决方案：
- 检查模型 ID 是否拼写正确（注意大小写、日期后缀等）
- 调用 List Models 接口查看当前可用的模型
- 确认该模型是否已在平台上配置
报错 "Model xxx is not accessible: Not Allowed!"（403）
原因： 您的租户不在该模型的访问白名单内，或被列入了黑名单。
解决方案： 联系平台管理员，确认您的租户是否有权限使用该模型。
还有其他问题？
如果您遇到了未在上述列表中的问题，请联系平台管理员获取帮助。