登录令牌存在哪里？会被后端拿到吗？

保存在浏览器本地存储（qstar_token / qstar_user），每次请求以 Authorization: Bearer … 注入。令牌只用于鉴权，不存在源码或构建产物里；清除本地数据即可彻底登出本设备。

退出登录后，旧令牌还能继续用吗？

不能。服务端除了校验 JWT 签名与过期时间，还会检查 Redis 会话键 users/ 是否存在。用户登出后会话键被删除，令牌立即失效，不等过期时间。

连续登录失败被拒绝，是被封号了吗？

不是。平台有防暴破限流：同一用户 10 次 / 15 分钟（后台入口 8 次 / 10 分钟），计数存在 Redis。另外登录类端点失败时返回的是 HTTP 200 + 信封 code != 0，不是 401，客户端请按 code 判错而不是只看状态码。自动化脚本请加退避重试，不要并发猛打登录接口。

API Key 和登录令牌有什么区别？

登录令牌是浏览器会话身份，随登出失效；API Key 是给程序化调用用的长期凭据。在密钥页自助创建 / 重命名 / 启用禁用 / 撤销，明文只在创建接口返回一次，请即时保存。

怎么计费？余额不够会怎样？

每次对话按模型标定预留算力，请求结束后结算；余额不足直接返回 402 insufficient_quota，需要充值后重试。

上游失败或部分输出，还会扣费吗？

不会。非流式上游失败会返回 502 并退还已预留算力；流式中途失败会在最后一个分片追加失败提示后照常收尾并退还。

为什么接口里的 usage 全是 0？

上游模型服务未回传 token 计数，usage 目前恒为 0。计费与限额请以用量页的周期额度（quota.limit / quota.used）为准，不要拿 usage 做判断。

目前有哪些限制？

已实现：按次预留算力、余额校验、失败退还、登录防暴破。未实现：并发数限制、RPM / TPM 配额、Usage 精确统计 —— 近期排期中，接入前请按「按次预留」做容量规划。

baseURL 应该填什么？

公网：https://qstar.center/v1，OpenAI SDK 会自动拼接 /chat/completions。同源部署时留空，由 nginx 挂载 /api/ 与 /v1/（前端 API_BASE 环境变量为空即同源直连）。

为什么提示模型不存在？

model 必须用 GET /v1/models 返回对象里的 id 字段（如 gpt-4o-mini），不能用展示名 name（如 GPT-4o mini）。不在列表内的模型直接返回 404 model_not_found。

流式输出看起来是「一次性返回」？

先确认服务端：nginx 对 /v1/ 必须 proxy_buffering off，且响应带 X-Accel-Buffering: no。再确认客户端：curl 需要加 -N 关闭本地缓冲；某些网关也会攒包，需逐段透传。

与 OpenAI 官方协议有哪些差异？

支持：chat/completions（流式 / 非流式）、models.list、role 三件套、temperature / max_tokens 透传。忽略（不报错）：n / top_p / presence_penalty / frequency_penalty / stop / seed / logprobs / response_format / stream_options。未支持：tools / function_call、视觉输入、/v1/embeddings、/v1/images、/v1/audio。

未登录请求却返回了 200 / 别人的数据？

这是中间层缓存投毒的典型症状：缓存键不含 Authorization，登录用户的响应被回给了未登录请求。复测方法：同一 URL 加随机 query 串，若结果变回正确，即确认按键缓存命中。处置：任何中间层（CDN / EO / nginx / 宝塔 site_speed）都不要对 /v1/* 做响应缓存；若必须缓存，缓存键须包含 Authorization。

返回 502 怎么办？

上游模型服务异常。该次已退还算力，按指数退避重试即可，不需要额外补偿逻辑。

发版后行为没变化？

边缘节点可能还是旧内容：发版后必须回源刷新（EO purge），前端静态产物也要同步到回源节点。

本地 curl 出现 403 / 520 / 000？

多为出口代理或沙箱造成的假故障，并非服务端问题。在集群节点内改用 curl -sLk --noproxy '*' 复测，再判断是否为真实故障。

主题和语言会记住吗？

会。主题三态（浅色 / 深色 / 跟随系统）与界面语言都持久化在本地存储 + Cookie，下次访问在首屏绘制前生效，无闪烁。

换设备能看到之前的会话吗？

当前会话与消息保存在浏览器本地存储，可在设置页一键清除；跨设备同步属于服务端持久化能力，仍在推进中。

怎么把对话分享给别人？

对话页的分享按钮会生成只读分享链接，接收方无需登录即可查看，不会泄露令牌与密钥。

常见问题

Q: 退出登录后，旧令牌还能继续用吗？

不能。服务端除了校验 JWT 签名与过期时间，还会检查 Redis 会话键 users/ 是否存在。 用户登出后会话键被删除，令牌立即失效，不等过期时间。

Q: API Key 和登录令牌有什么区别？

登录令牌是浏览器会话身份，随登出失效；API Key 是给程序化调用用的长期凭据。 在密钥页自助创建 / 重命名 / 启用禁用 / 撤销，明文只在创建接口返回一次，请即时保存。

Q: 为什么接口里的 usage 全是 0？

上游模型服务未回传 token 计数，usage 目前恒为 0。 计费与限额请以用量页的周期额度（quota.limit / quota.used）为准，不要拿 usage 做判断。

Q: 目前有哪些限制？

已实现：按次预留算力、余额校验、失败退还、登录防暴破。 未实现：并发数限制、RPM / TPM 配额、Usage 精确统计 —— 近期排期中，接入前请按「按次预留」做容量规划。

账户权限、计费用量、API 接入、故障排查、界面个性化 —— 高频问题都在这。

本页目录

按主题分组，点击问题展开答案。若这里没覆盖，请把复现步骤与时间点发给技术支持。

常见问题

账户与权限

计费与用量

API 接入

故障排查

界面与个性化