常见问题

这里整理的是面向客户的新手常见问题，重点解决登录、Token、额度、客户端配置、日志和接口调用中的高频问题，不涉及管理员后台配置。

重点先看

如果你只想先解决最常见的问题，优先看这 4 个点：

重点	说明
Base URL	一般填 http://ai.t1qq.com/v1
请求头	必须是 Authorization: Bearer 你的Token
接入顺序	先用 curl 跑通，再配置客户端
额度概念	账户余额和 Token 配额不是一回事

如果你刚开始接入，建议先阅读：

• 新手指引
• 客户新手使用指南
• API 快速接入

---

一、登录与账号

1. 登录后反复回到登录页怎么办？

通常是浏览器会话没有正确保存。

优先检查下面这些项：

• 浏览器 Cookie 是否被禁用或清理
• 是否开启了无痕模式
• 代理、VPN 或公司网络是否影响登录
• 账号本身是否正常可用

如果换浏览器后正常，通常就是本地浏览器环境问题。

2. 登录后看不到控制台内容怎么办？

先确认你已经成功进入主页，而不是只停留在登录页。

建议检查：

• 页面是否被浏览器插件拦截
• 是否有缓存导致页面未刷新
• 网络是否稳定
• 当前账号是否有访问权限

如果页面显示异常，先尝试刷新、重新登录或更换浏览器。

---

二、Token 与接入方式

3. Token 创建后要怎么使用？

Token 就是调用接口时的 API Key。

接入时一般这样填写：

配置项	填写内容
Base URL	http://ai.t1qq.com/v1
API Key	你创建的 Token
Model	控制台可用的模型名称

如果你不确定模型名，先到控制台确认可用列表。

4. 一个 Token 能给多个客户端共用吗？

技术上可以，但不建议长期共用。

更推荐的做法是：

• 不同设备使用不同 Token
• 不同应用使用不同 Token
• 需要排查问题时，能更容易定位是谁发起了请求

如果多人共用同一个 Token，日志会更难区分，也不利于后续管理。

5. Base URL 到底怎么填？

一般填写接口地址：

http://ai.t1qq.com/v1

不要填成首页地址，也不要重复拼接 /v1/v1。

如果客户端要求填根地址，再按客户端说明处理，但第一次建议先用 curl 跑通标准接口。

---

三、额度与计费

6. 余额和 Token 配额有什么区别？

两者不一样。

概念	说明
账户余额	整个账号可用的总额度
Token 配额	单个 Token 自己能使用的额度上限

如果账户余额还有，但 Token 配额已经用完，这个 Token 仍然不能继续调用。

7. 我余额用完了怎么办？

如果账户余额已经不足，就需要先补充额度。

你可以先检查：

• 账户可用额度是否已经为 0
• 当前 Token 是否还有单独配额
• 是否还有其他可用 Token

如果是团队账号，通常需要联系管理员处理。

8. 充值后为什么还是不能调用？

通常是因为充值后还需要确认账号本身和 Token 是否都可用。

请检查：

• 账户余额是否已经到账
• 当前 Token 是否还有独立配额限制
• Token 是否已经过期或被禁用
• 当前模型是否还在可用范围内

如果换一个新 Token 可以调用，通常说明问题在旧 Token 的限制上。

9. 为什么调用一次后额度减少得很多？

通常和模型本身的计费方式有关。

可能原因：

• 使用的是高消耗模型
• 输入内容太长
• 输出内容很长
• 开启了多轮上下文，累计了更多 token 消耗

如果你发现扣费明显偏高，可以先用更短的提示词和更小的输出长度测试。

10. 为什么扣费金额和我的预期不一样？

不同模型的计费标准不一样。

常见影响因素：

• 高级模型通常更贵
• 输入 token 和输出 token 都会计费
• 长上下文会增加总消耗
• 不同模型的单价不同

如果你只是想先验证链路，建议先用短提示词和简单模型测试。

---

四、Token 与权限

11. 返回 401 Unauthorized 是什么原因？

通常表示认证失败。

常见原因：

• Token 填错了
• Token 复制不完整
• 请求头格式不对
• Token 已过期、被删除或被禁用

正确格式一般是：

Authorization: Bearer 你的Token

12. 返回 403 Forbidden 怎么处理？

通常表示当前 Token 没有权限使用该模型或来源 IP 不被允许。

请检查：

• Token 是否限制了模型
• 当前模型是否对账号开放
• 是否配置了 IP 白名单
• 当前网络出口是否在允许范围内

13. 提示“模型不存在”怎么办？

通常是模型名称写错了，或者当前账号没有这个模型权限。

请检查：

• 模型名是否和控制台一致
• 是否有多余空格
• 是否直接照搬了其他平台的模型名
• 当前账号是否真的开放了这个模型

14. 为什么看不到某个模型？

通常表示当前账号没有该模型的使用权限，或者该模型还没有对你开放。

建议这样排查：

• 刷新控制台的可用模型列表
• 确认模型名是否拼写正确
• 查看当前账号是否有该模型权限
• 如是团队环境，确认管理员是否已经开放

---

五、请求与接口

15. 返回 404 Not Found 是地址错了吗？

大概率是。

请重点检查：

• 是否把控制台地址当成接口地址
• 是否少写或重复写了 /v1
• 客户端是否自动拼接了路径

建议先直接用 curl 测试：

curl http://ai.t1qq.com/v1/chat/completions \
  -H "Authorization: Bearer 你的Token" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"请回复：测试成功"}]}'

16. 返回 429 Too Many Requests 是什么情况？

通常表示请求太频繁，或者触发了当前账号的频率限制。

处理方式：

• 降低请求频率
• 稍后重试
• 检查 Token 或账号是否有频率限制

17. 客户端能发出去，但日志里没有记录？

这通常说明请求没有真正到达平台。

请检查：

• Base URL 是否填对
• 客户端是否走了错误代理
• 本地网络、防火墙、浏览器插件是否拦截了请求
• 域名是否能正常访问

18. 为什么 curl 成功，但客户端失败？

这通常说明平台、Token、地址本身是对的，问题出在客户端配置。

重点检查：

• 客户端是否自动补了 /v1
• 模型名是否填写正确
• 是否选对了 OpenAI Compatible / 自定义 OpenAI 接口
• 是否开启了不兼容的高级参数

19. 为什么回复很慢，甚至像是卡住了？

通常和模型响应速度、网络环境或客户端超时设置有关。

请检查：

• 当前模型是否本身响应较慢
• 你的网络是否不稳定
• 客户端超时时间是否设置过短
• 是否同时开了很多并发请求

如果是长内容生成，建议适当延长客户端超时时间。

20. 为什么返回的内容不完整？

常见原因有两种：

• 客户端或 SDK 设定的最大输出长度太短
• 网络中断导致响应提前结束

你可以先检查：

• 是否设置了较小的 max_tokens
• 是否开启了流式输出但客户端没有正确处理
• 是否在中途被代理、插件或网络工具打断

---

六、客户端配置

21. 支持哪些 AI 客户端？

只要是支持 OpenAI 兼容接口的客户端，通常都可以接入。

常见工具包括：

• Cursor
• Cherry Studio
• ChatBox
• Postman
• OpenAI SDK

22. 客户端配置需要填什么？

通常只需要三项：

配置项	填写内容
API 地址（Base URL）	http://ai.t1qq.com/v1
API Key	你在控制台创建的 Token
模型名称	控制台可用模型列表中的名称

23. 配置后仍然提示 Failed to fetch 或网络错误？

可能的原因包括：

• 跨域问题，浏览器前端直接调用时被拦截
• API 地址填写错误，遗漏了 /v1
• 网络不通，防火墙未放行
• HTTPS 证书问题，客户端不接受自签名证书

建议先用 curl 测试接口，再排查客户端。

24. 第一次接入建议怎么做？

最稳妥的顺序是：

1. 先在控制台创建 Token
2. 用 curl 发一条最小请求
3. 确认日志里有记录
4. 再配置 Cursor、Cherry Studio、ChatBox 或 SDK

这样最容易快速定位问题。

---

七、使用与排查建议

25. 我应该先看哪一页？

如果你是新客户，建议按这个顺序看：

1. 新手指引
2. 客户新手使用指南
3. API 快速接入
4. 本页常见问题

26. 还有别的问题怎么办？

如果以上内容都无法解决问题，请先准备好以下信息再排查：

• 你使用的 Base URL
• 你使用的模型名
• 报错状态码或报错截图
• 你是用客户端、SDK 还是 curl
• 是否能在控制台日志里看到请求记录

这些信息能帮助你更快定位问题。