文档 · 排查问题

登录与账户

2026-09-24

登录如何与 topxea.com 共用，会话、设备和 TopxAI Desktop 登录怎么管，地区服务说明，以及怎么找客服。

topxea.com 和 TopxAI 共用一个登录

登录走 Clerk，用一个验证过的主邮箱；TopxAI 和 topxea.com 用的是同一个 Clerk 身份。已经在 topxea.com 登录的话，这边直接沿用；没登录就当访客浏览，打开控制台页面（比如 仪表板（Dashboard）或 API 密钥（API keys））时才跳到登录页。余额、API key 和用量都挂在这个 Clerk 用户 id 上。账户不会按邮箱合并：同一个邮箱下如果有个旧的 TopxAI 账户绑着另一个 Clerk id，会报 This email belongs to an existing account. Contact support.，要找客服处理。

控制台界面默认英文，要看中文，去 个人资料（Profile）页的语言（Language）面板切换。下文的界面标签按「中文（英文）」写，两种界面都能对上。

姓名、邮箱、密码和登录方式，在 Clerk 自己的面板里改，入口是个人资料页的 管理 Clerk 资料（Manage Clerk profile）和 管理密码与安全（Manage password and security）。注销账户要找客服，页面上没有自助删除。

登录页卡住

出现「登录等待超时，请重试。」（Sign-in is taking too long. Please try again.）和 重新加载登录页（Reload sign-in）按钮：登录页等配置或 Clerk 脚本等了 30 秒，重载一次。
同一句话配重试（Try again）和 退出登录（Sign out）两个按钮：和 TopxAI 换票超时了，重试一次，或者退出后从头登录。
出现 重新加载登录（Retry loading sign-in）按钮：Clerk 脚本没加载出来。
出现「暂时无法获取登录配置，请重试。」（Unable to load sign-in configuration. Please try again.）：点重试，过一会再试。
在这台设备上退出过，页面只剩一个登录（Sign in）按钮：浏览器里还留着旧的 Clerk 会话，点一下会先结束这个会话，再显示登录表单。

会话和设备

控制台会话最长 30 天，每次访问都会去 Clerk 重新核验；Clerk 那边的会话一旦撤销或过期，下一个请求就会拒绝。Clerk 短暂连不上时，控制台返回 503，稍后重试。

个人资料页的 登录会话（Login sessions）列的是 Clerk 的设备清单，只在 topxea.com 登录过的设备也在里面；过期（Expires）一列是 Clerk 会话自己的到期时间。TopxAI Desktop 的登录也列在这里，显示为 TopxAI Desktop · 电脑名，下面一行是系统和应用版本，登录方式一列写 桌面应用（Desktop app）。这类登录不归 Clerk 管，应用每个月至少用一次，就一直保持登录。

退出登录（Sign out）：退出本机。
撤销（Revoke）：退出另一台设备。撤销 TopxAI Desktop 的登录，应用在那台电脑上创建的 API key 同时停用。
退出其他会话（Sign out other sessions）：撤销其余全部 Clerk 会话（topxea.com 上的登录也会退掉），同时退出所有 TopxAI Desktop 登录，停用各自的 key。桌面端的登录先退出，之后 Clerk 那一步就算出错，它们也已经退出了；Clerk 设备那部分稍后再点一次。

Clerk 的设备清单暂时读不到时，卡片上会注明，列表里只剩本机和 TopxAI Desktop 的登录，这些登录照样可以撤销。

退出设备不影响你自己创建的 API key，key 会一直有效，直到在 API 密钥页禁用（Disable）或删除（Delete）。例外是 TopxAI Desktop 为一台电脑创建的 key：那次登录结束，它就停用；在应用里重新登录会再建一把新的。密钥与登录绑定之前的桌面登录不一样，登录结束后它的 key 照样能用，撤销时的确认框会写明，这把 key 要到 API 密钥 页禁用或删除。账户一旦停用，登录和所有 key 一起失效。

地区服务说明

开启地区访问控制的情况下，控制台 API 和所有 /v1/ 端点会返回 403。消息按请求的语言返回，中文是「你所在的地区暂不提供此服务。」或「无法核验你所在的服务地区，请联系支持。」，英文是 The service is not available in your region. 或 Your service region could not be verified. Please contact support.。判断依据是可信基础设施传来的位置头，不看浏览器里的设置。公开页面和退出登录照常可用。

联系客服

用任意页面右下角的帮助按钮（页脚的支持（Support）链接打开的是同一个对话窗），或者写信到 support@topxea.com。API 报错，把消息末尾的 (request id: ...) 或响应头 x-request-id 一起发过来；网页上遇到拦截，那里没有 request id，就给发生时间（带时区）、打开的页面和账户邮箱。别贴 API key。提示词和回复都不存储，客服只看得到请求的元数据（模型、token 数、状态、耗时、key id）。