常见问题
注册登录、邀请码、密钥和调用报错——最常被问到的都在这里。
账号与登录
登录状态能保持多久?
30 天。而且每次打开页面都会自动把有效期续回 30 天,所以只要两个月内来过一次,就不会掉线。
换浏览器、清过站点数据、或者用了无痕窗口的话,需要重新登录一次——这是浏览器层面的限制,不是账号问题。
为什么打开控制台被踢回登录页?
三种可能:会话已过期、浏览器清掉了 Cookie、或者你在别的设备上改过密码(改密码会让其它设备的登录立即失效)。
重新登录即可。如果刚登录就被踢回,检查一下浏览器是不是禁用了本站的 Cookie。
收不到验证邮件怎么办?
先看垃圾邮件 / 推广 / 订阅邮箱,邮件标题是「验证你的邮箱 · 聚流」。
- 同一邮箱 60 秒内不能重发,等一会儿再点。
- 同一邮箱 每小时最多 8 封,点太多次会被暂时挡住。
- 确认邮箱地址没有拼错,尤其是 QQ 邮箱后面的数字。
还是收不到,把邮箱地址发给管理员,手动排查一下投递记录。
验证链接和令牌有有效期吗?
有。链接和令牌都是 30 分钟内有效,并且只能用一次。
过期就回注册页重新发一封,旧链接会失效。链接被点过一次之后再打开,会提示「这个链接已经用过了」。
验证令牌在哪里看?邮件里为什么没有?
令牌不在邮件正文里,只在点开邮件里的「验证我的邮箱」按钮之后打开的页面上显示。
这样做是为了确认邮箱真的是你能打开的,而不是拿一个地址乱填。页面上有复制按钮,复制后粘回注册页第 2 步即可。
忘记密码了怎么办?
目前没有自助找回。联系管理员,说明注册邮箱,由管理员重置成一个临时密码,登录后到「设置」里自己改掉。
能换绑邮箱吗?
暂不支持改邮箱。账号和邮箱是一对一绑定的,需要换邮箱就用新邮箱重新注册(需要新的邀请码)。
邀请码
怎么拿到邀请码?
聚流目前是邀请制。请联系管理员说明来意,获取一个邀请码。
一个邀请码能用几次?
一次。注册成功后邀请码立即作废,别人再填会提示已被使用。
填了邀请码提示无效或已被使用?
邀请码不区分大小写,但连字符和空格要留意。如果确认没输错,多半是这个码已经被别人用掉了。
找管理员要一个新的即可。
API 密钥
密钥忘了 / 丢了怎么办?
找不回来。数据库里只存密钥的哈希,连管理员也看不到原文。
处理办法:在控制台撤销那把旧的,重新创建一把。撤销是立即生效的。
一个账号能建几把密钥?
最多 20 把有效密钥。建议按用途分开建,比如「博客」「小程序」「本地测试」,哪一把泄露就只废哪一把。
「撤销」和「删除」有什么区别?
撤销是让密钥立刻失效,但记录还在,方便你回看是什么时候废的。
删除是把记录彻底清掉,必须先撤销才能删。不确定的时候就只撤销,别删。
密钥会自己过期吗?
不会自动过期,长期有效,直到你主动撤销。
建议定期轮换:新建一把 → 把服务切过去 → 撤销旧的。这样中途不会断。
控制台里为什么只显示密钥的前几位?
完整密钥只在创建那一刻显示一次,之后只保留前缀用于辨认(sk-jl-…)。
所以创建时那一秒钟要复制走,存进你的密码管理器或服务端环境变量。
调用与报错
base_url 到底填什么?
https://api.lcypvt.online/v1 —— 注意末尾要带 /v1,这是 OpenAI 兼容层的固定前缀。
用官方 SDK 时,填进 base_url(Python)或 baseURL(Node),不要把 /chat/completions 也写进去。
返回 401 是什么原因?
密钥没被认出来。按顺序检查:
- 请求头里是不是
Authorization: Bearer sk-jl-…,Bearer后面有个空格。 - 密钥有没有被截断、有没有多复制了空格或换行。
- 这把密钥是不是已经被撤销了——去控制台的「API 密钥」页看状态。
返回 404 是什么原因?
地址或模型不存在。先确认 base_url 以 /v1 结尾、路径是 /chat/completions。
如果地址没问题,看接入文档页顶部的状态:显示「接入中」说明网关还在接通上游,此时调用会 404 是正常的。
返回 429 怎么办?
触发了频率限制。降低并发,或者做指数退避重试:失败后等 1 秒、2 秒、4 秒,最多重试三四次。
不要原地死循环重试,那只会让限制持续更久。
支持流式(打字机效果)吗?
支持。请求体加 "stream": true,服务端会用 SSE 一段段返回,最后一行的内容是 data: [DONE]。
示例见接入文档 · 流式输出。
能不能在网页或小程序里直接调用?
不能。前端代码是公开的,密钥打包进网页或小程序包等于直接公开给所有人。
正确做法:让密钥留在你自己的服务端,前端调用你的服务端,你的服务端再去调聚流。
原来的 OpenAI SDK / 代码要改多少?
两处:base_url 指向聚流,api_key 换成聚流的密钥。请求参数和返回结构都保持 OpenAI 格式,其余代码不用动。
安全与隐私
密码是怎么存的?
PBKDF2-SHA256,20 万次迭代,每个账号一个独立随机盐。数据库里没有任何明文密码,也无法反推出原密码。
登录状态存在哪里?
存在一个浏览器 Cookie 里,带 HttpOnly、Secure、SameSite=Lax 三个属性——页面脚本读不到它,只能由浏览器自动带上。
页面上唯一存进浏览器本地的东西是「上次登录过」的界面提示,它不参与身份判断,服务端说不认识就会立刻清掉。
改了密码,其它设备会怎样?
其它设备上的登录会立即失效,需要重新登录;当前这台设备保持不变。
如果怀疑账号被别人登过,改一次密码是最快的踢人方式。
我的邮箱会被别人看到吗?
不会。邮箱只用于登录和验证邮件,不对外展示;只有你自己和管理员能看到。