token.xu55.cn 是给人看的网站（你正在看的这个），
api.xu55.cn 是给程序调用的 API 地址。配置客户端时填的是后者。
两者不可互换——填错会得到 404 或一份 HTML 页面而不是 JSON。
开始之前
你只需要准备三样东西，都不花钱：
- 一个邮箱
- 用于注册与找回密码。不接收营销邮件。
- 一个客户端
- 想先试试效果，用 Cherry Studio / ChatBox 这类桌面程序即可，不用写代码。
- 少量余额
- 按量计费，充多少用多少。具体充值档位以控制台充值页显示为准。
另外，本站的接口与 OpenAI 官方格式完全兼容。这意味着任何"支持自定义 OpenAI 接口" 的软件都能直接接入，不需要为本站单独装插件。
五步跑通第一次调用
注册账号
发邮件到 support@xu55.cn 申请开通，我们会为你建好账号并给出初始密钥。 登录后进入的是控制台，后面所有操作都在这里完成。
充值余额
进入控制台的「钱包 / 充值」页，选择金额并完成支付。 余额到账后即可使用，不会过期，也不存在月租或席位费—— 没有调用就不产生消耗。
如果支付后余额长时间未变，先点「刷新」，仍不对再带上订单号联系支持。
创建一个 API 令牌
进入控制台的「令牌」页，点「添加令牌」。只需填一个你自己看得懂的名字
（比如 cherry-studio），其余保持默认即可保存。
保存后会得到一串以 sk- 开头的字符串，这就是你的密钥。
这串字符只显示一次，请当场复制并妥善保存。 没有保存也没关系——删掉重建一个即可，成本为零。
把地址和密钥填进客户端
在你用的软件里找到「自定义 API / OpenAI 兼容」之类的设置项，填两样东西：
API 地址填 https://api.xu55.cn/v1，密钥填上一步复制的
sk- 开头那串。具体入口见下方的
客户端配置对照表。
发一句话验证
在客户端里随便问一句"你好"。能正常收到回复就说明通了。 如果偏好命令行，也可以用下面这条命令验证：
curl https://api.xu55.cn/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat",
"messages": [{"role": "user", "content": "你好"}]
}'
返回一段 JSON（里面有 choices 字段）即为成功。
同时可以在控制台的「日志」页看到这次调用与扣费明细。
客户端配置对照表
下面都是常见软件。它们的共同点是需要两个值：API 地址与 API Key。不同版本的菜单名称可能略有差异，按含义找即可。
| 客户端 | 设置入口（大意） | API 地址填 | API Key 填 |
|---|---|---|---|
| Cherry Studio | 设置 → 模型服务 → 添加提供商（类型选 OpenAI） | https://api.xu55.cn/v1 |
sk-你的令牌 |
| ChatBox | 设置 → 模型 → 添加自定义提供方（API 模式：OpenAI 兼容） | https://api.xu55.cn/v1 |
sk-你的令牌 |
| NextChat（ChatGPT-Next-Web） | 设置 → 自定义接口 | https://api.xu55.cn |
sk-你的令牌 |
| LobeChat | 设置 → 语言模型 → OpenAI（开启自定义接口） | https://api.xu55.cn/v1 |
sk-你的令牌 |
| Cursor | 设置 → Models → OpenAI API Key（需打开 Override Base URL） | https://api.xu55.cn/v1 |
sk-你的令牌 |
| 沉浸式翻译等浏览器插件 | 设置 → 翻译服务 → OpenAI（自定义） | https://api.xu55.cn/v1 |
sk-你的令牌 |
/v1：
多数客户端要带，少数会自动补上（如 NextChat 通常只填域名）。
若带 /v1 报 404，去掉再试；反之亦然。两种写法本站都支持。
模型名请填模型列表里列出的标识
（如 deepseek-chat、qwen-max）。
客户端里如果有个"手动输入模型名"的选项，用这个最稳，不要依赖自动拉取。
常见报错速查
遇到报错时先对号入座。这里只列接入阶段最常碰到的几类。
| 现象 | 最可能的原因 | 怎么解决 |
|---|---|---|
401 未授权 |
密钥填错、多复制了空格，或令牌已被禁用 | 重新复制完整令牌（含 sk-）；在控制台确认该令牌状态为启用 |
402 余额不足 |
账户余额已耗尽 | 充值后自动恢复，无需重启客户端 |
404 找不到 |
API 地址写错（常见于漏了或多了 /v1，或误填了带 www 的站点域名） |
改回 https://api.xu55.cn/v1 |
404 模型不存在 |
模型名拼错，或该模型不在当前分组可用范围内 | 对照模型列表逐字核对；注意大小写与连字符 |
429 请求过快 |
短时间内并发过高，触发速率限制 | 降低并发或稍后重试；确有需要可联系支持提升额度 |
500 服务错误 |
上游通道临时故障 | 可安全重试，本次不计费；持续出现请查看服务状态 |
| 客户端显示 HTML 或一堆乱码 | 把站点域名当成了 API 地址 | 换成 https://api.xu55.cn/v1，不要带 www |
| 一直转圈没有回复 | 模型名不被支持，或客户端开启了联网/插件等额外能力 | 换一个模型名试；关掉客户端的联网搜索功能再试 |
表里没覆盖到的情况，见支持中心的自查清单， 或参考接口文档的错误码一节。
令牌安全
令牌（sk- 开头那串）等同于你的账号密码——谁拿到它，
就能用你的余额调用模型。它不能用来登录控制台，
但足以花掉你的钱。所以：
- 不要提交到代码仓库
- 写代码时请从环境变量读取，不要把令牌硬编码进源文件。一旦推送到公开仓库， 爬虫最快几分钟就会扫描到并盗用。
- 不要放进前端页面
- 浏览器里能看到的一切都不是秘密。需要在前端调用时，应由你自己的后端转发。
- 按用途分开建令牌
- 给每台设备或每个项目单独建一个令牌。这样某一个泄露时可以只吊销它， 不影响其它设备继续使用。
- 泄露后立刻吊销
- 到控制台「令牌」页把它禁用或删除，余额就不会再被消耗。处理完再新建一个。
另外建议在令牌上设置额度上限——万一泄露，损失被限制在你设定的范围内。 对于面向公众的服务，这一步几乎是必须的。