常见问题
返回 401
确认请求包含 Authorization: Bearer YOUR_API_KEY,并检查 Key 是否被删除、复制不完整或包含多余空格。
返回 403
检查 Key 所属分组、目标模型权限和网络访问策略。若返回的是安全服务拦截页面,而不是 JSON 错误,需要更换正常网络后再测试。
返回 404
依次检查:
- Base URL 是否为
https://ai.akaii.top/v1; - 接口路径是否正确;
- 模型 ID 是否来自当前控制台或
/v1/models; - 目标模型是否支持当前协议。
返回 429
可能原因包括余额不足、并发限制、速率限制或上游临时繁忙。不要立即无限重试;使用退避策略并查看控制台用量。
CLI 读取不到新配置
环境变量通常只对当前终端及其子进程有效。修改后重新打开终端,并确认 CLI 没有读取另一份旧配置文件。
如何提交问题
准备以下信息:发生时间、请求路径、HTTP 状态码、错误响应和客户端版本。隐藏 API Key、账户信息和请求中的敏感内容。