大约 4 分钟
（5）测试令牌可用性
这一步要做什么
- 用一个最简单的办法验证你的令牌真的能调通模型
- 不会用命令行也没关系，推荐先用图形客户端测
- 看懂常见错误代码（401 / 403 / 模型不可用）的意思
- 全程 2 分钟以内
完成这一步，意味着你从注册到能调模型已经完整跑通了。后面就可以放心去配你想用的工具了。
推荐：先用图形客户端测（小白优先）
不会敲命令？没关系
如果你完全没用过命令行，强烈推荐第一次验证就用图形客户端（GUI 工具）。点点鼠标就能测，比命令行直观 10 倍。
最简单的两个选择：
| 客户端 | 特点 | 教程 |
|---|---|---|
| Chatbox | 安装最简单，桌面应用 | Chatbox 配置教程 |
| NextChat | 浏览器直接用，一个 URL 搞定 | NextChat 配置教程 |
最快的测试路径：
- 装一个 Chatbox（或打开 NextChat 网页）
- 在设置里把 API 地址 填
https://www.yuzhixiaolongxia.com - API 密钥 粘贴你的令牌（用 Claude 家族分组的那把）
- 模型 填
claude-opus-4-7（或在 模型广场 查最新 ID） - 新建对话，发一句"你好"
- 能收到回复 = 令牌可用 ✅
验证图片 / 视频也是同样思路
要测画图、视频这类，可以装 Cherry Studio，配置方式类似。教程：Cherry Studio 配置。
进阶：会命令行的人这样测
这部分是给会用 cmd / 终端的人看的
如果你不知道什么是 cmd / 终端 / curl，直接跳过这部分，走上面图形客户端就行。
打开你电脑的终端（Windows 是 PowerShell 或 CMD，Mac 是 Terminal）。
测试 1：查询模型列表
把下面这段整段复制进终端，把 你的令牌 替换成实际值，回车：
curl -s https://www.yuzhixiaolongxia.com/v1/models \
-H "Authorization: Bearer 你的令牌" \
-H "Content-Type: application/json"判断标准：
- 返回一长串 JSON，里面能看到一堆模型名 → ✅ 令牌可用
- 返回
401→ 令牌字符串有问题（复制不全 / 多了空格 / 已删除） - 返回
403→ 余额不足，或者令牌被禁用
测试 2：发一句简单对话
把下面这段复制进终端（同样替换令牌，模型 ID 用你令牌分组里有的）：
curl https://www.yuzhixiaolongxia.com/v1/chat/completions \
-H "Authorization: Bearer 你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-7",
"messages": [
{ "role": "user", "content": "只回复 OK" }
]
}'判断标准：
- 返回 JSON，里面
"content": "OK"→ ✅ 完整跑通 - 返回报错 → 看下方排错表
常见错误对照表
三种最常见的错误
| 错误代码 / 提示 | 意思 | 怎么解决 |
|---|---|---|
401 Unauthorized | 令牌错了 | 重新去 令牌管理页 复制完整令牌，确认前后没多空格 |
403 Forbidden | 余额不足或令牌被禁用 | 回 钱包页 看余额；看令牌状态 |
该模型在分组下不可用 / model_not_found | 分组选错了 | 换一把对应分组的令牌（比如调 Claude 要用 Claude 家族令牌） |
429 Too Many Requests | 请求太频繁 | 等几秒再试，或减小并发 |
5xx 系列 | 服务端临时抖动 | 稍后重试 1 ~ 2 次 |
测试成功后干什么
恭喜，你已经完成了从零到第一次成功调用的全过程！下一步根据你想用的工具走：
| 想用的场景 | 跳到 |
|---|---|
| 聊天图形客户端（最简单） | Chatbox 教程 / NextChat 教程 |
| 画图 / 视频 | Cherry Studio 教程 |
| 写代码：Claude Code | Claude Code 配置 |
| 写代码：Codex | Codex 配置 |
| 写代码：Gemini CLI | Gemini CLI 配置 |
| 一键装全套命令行工具 | 一键安装包 |
| 自动化工作流 | n8n 教程 |
验证失败按这个顺序排查
如果两种方式都试了但还是不行：
- 令牌字符串是不是复制完整了（前后多空格 / 漏字符是最常见的）
- 令牌的分组对不对（图片分组的令牌测不通文本聊天）
- 账号有没有余额（注册赠送 50 万 Token 应该够用，但如果你之前跑过大任务可能已经扣完）
- 模型 ID 写对了吗（去 模型广场 复制最新 ID）
- 网络通不通（用浏览器打开
https://www.yuzhixiaolongxia.com看能不能打开首页） - 都试了还不行 → 看 常见问题 FAQ 或联系客服