获取 API Key
本页面是 从 0 注册到拿到 sk- 令牌的实拍教程，每一步均按当前线上版本截图。 走完之后即可在 Claude Code、OpenCode、Cline、Cherry Studio 等客户端用同一把 Key 接入 700+ 模型。
1 分钟版本
一、注册账号
字段说明（红 * 全部必填）：
| 字段 | 要求 | 备注 |
|---|---|---|
| 用户名 | 4–12 位 字母/数字 | 登录用，注册后不可修改 |
| 密码 | 8–20 位 | 建议含字母 + 数字 |
| 确认密码 | 与密码一致 | 实时勾选校验 |
| 邮箱地址 | 真实可收信邮箱 | 用于找回密码 + 通知 |
| 邮箱验证码 | 邮箱收到的 6 位数字 | 见下方 |
| 邀请码 | 选填 | 留空也能注册；填写双方均得返利 |
也可以直接走顶部 GitHub 登录 一键跳过本节。
验证流程：两道关卡
ClaudeHub 在邮件发送和最终注册两个环节各有一道图形验证码。
- 填好邮箱后点「获取验证码」
- 弹出"邮箱验证"对话框 → 输入图形里的 4 个字符（区分大小写）→ 确认
- 邮箱在 1 分钟内会收到 6 位数字验证码（QQ/163 容易被拦，优先 Gmail/Outlook）
- 把 6 位码填入"邮箱验证码"字段
- 点「注 册」→ 弹出"注册验证"对话框 → 再输入一次图形验证码 → 确认
常见失败
- 用户名提示长度 → 必须 4–12 位
- 图形验证码看不清 → 点击图片可刷新
- 邮箱收不到 6 位码 → 换 Gmail/Outlook，并检查垃圾邮件
- Cloudflare 一直转圈 → 刷新或换浏览器
注册成功会有烟花动画：
注册即送
- 自动到账 ¥0.20 体验额度（长期有效），可直接跑模型
- 自动创建一把 "<用户名>的初始令牌"，无需手动建第一把
- 自动获得专属邀请码（个人中心可查）
点「进入工作台」会跳到登录页 → 用刚才的 用户名 + 密码 登录。
二、面板总览
登录后默认到 /token 页。新版 UI 是顶部导航条（不是老版本的左侧栏）：
| 顶部菜单 | 用途 |
|---|---|
| 🏠 主页 | 概览 |
| 📊 分组状态 | 实时查看每个分组的可用率（成功率统计） |
| 🔒 令牌 | API Key 管理 ⭐ 最常用 |
| 📄 日志 | 调用明细 / 计费明细 |
| 🖼 绘图 | Midjourney 任务 |
| ▶ 异步任务 | 视频/图像生成任务 |
| 👤 账户 | 余额充值 / 个人中心 / 费用说明 ⭐ |
| 🔍 查询 | 按 Key 查询用量（无需登录） |
| 🛒 代理加盟 | 代理商专区 |
| 📡 服务状态 | 公开服务监控 |
| 📚 文档 | 跳转本站 |
右上角头像 → 修改密码 / 系统令牌 / 退出。
三、充值余额
重要变化
- 最低充值 $10 美金起（约 ¥70+，不再是 ¥10）
- 充值币种以 美金 标价，按当时汇率折算人民币
- 余额不支持提现，但可在同用户组内转账
进入 账户 → 余额充值：
- 顶部 Tab 选「在线充值」（或「兑换码核销」如果你有码）
- 输入金额 → 选支付方式（支付宝 / 微信）
- 扫码支付 → 几分钟内自动到账（个别延迟可联系客服）
还能这样充
- 每日签到 —— 账户 → 个人中心 → 立即签到，每日送少量额度（无需充值）
- 兑换码 —— 收到运营/客服发的码，到「兑换码核销」Tab 输入
充值与等级
充值后系统按累计金额自动升级用户等级（影响"用户分组倍率"，等级越高倍率越低 = 更便宜）。具体当前倍率：账户 → 费用说明 顶部"您的用户分组倍率为：x.xx"。
四、创建 API 令牌
注册时已有一把"初始令牌"够你跑 demo 了，按需为不同项目再建独立令牌。
4.1 进入令牌列表
顶部导航 令牌 → 看到表格（含初始令牌）：
列含义：
- 令牌名称 / 令牌分组 / 计费方式 / 状态 / 可用模型 / 消耗额度 / 剩余额度 / 创建/最后使用/过期 时间
- 行尾 4 个图标按钮：复制 Key、查看用量、备注、操作
点右上角「新增」打开创建弹窗。
4.2 创建令牌弹窗
| 字段 | 默认 / 推荐 | 说明 |
|---|---|---|
| 令牌名称 | 自动 用户名的令牌 MM-DD | 改为有辨识度的，如 cc-prod / test-script |
| 无限额度 | 开启 | 关闭后可设令牌级上限（仍受账户余额制约） |
| 永不过期 | 开启 | 关闭后必须设过期时间 |
| 计费模式 | 按量优先 | 也可选其他模式（如套餐优先），按量适合大多数 |
| 选择分组 ⭐ | — | 必填，决定可用模型与计费倍率 |
| 兜底分组（Beta） | 留空 | 多选；主分组挂了自动 fallback |
| 令牌备注 | 选填 | 标记用途 |
| Discord 代理 | 选填 | 走 Discord 调 MJ 时填 |
| MJ 翻译配置 | 关闭 | 中文 prompt 自动翻英给 MJ 用 |
| 启用高级选项 | 关闭 | 勾上后可设 IP 限制、模型限制等 |
4.3 选择分组（重点）
点击"选择分组"展开下拉，支持搜索分组名称、描述或倍率——下拉默认只显示一部分，剩余的需要在搜索框输入关键词（如 codex、gemini、官key）才会出现：
选分组前先看可用率
打开 https://qinzhiai.com/groupAvailability（顶部导航也叫"分组状态"），实时显示 13 个分组的真实成功率。先看健康度，再做选择——同样的模型挂在 0% 分组上等于不能用。详细看法见 § 六。
按使用场景对应分组
| 你要用什么 | 推荐主分组 | 倍率 | 兜底分组（Beta） |
|---|---|---|---|
| Claude Code（生产/工作） | claude官key | ×4.5 | Claude Code 稳定分组 |
| Claude Code（性价比） | Claude Code 稳定分组 | ×2.2 | claude官key |
| Codex CLI | codex转发 | ×0.2 | openai官key |
| 第三方平台聊天（Cherry Studio / Lobe / ChatBox 等日常对话） | Claude-官网逆向 | ×0.1 | 开源模型-1 |
| GPT 系列（ChatGPT API、o3、GPT-5） | openai官key | ×3 | Azure分组 |
| Gemini 系列 | Gemini | ×1.5 | 多模型转发 |
| Azure OpenAI | Azure分组 | ×1 | openai官key |
| Midjourney 绘图 | midjourney | ×1 | — |
| 开源模型（DeepSeek / Qwen / Llama 等） | 开源模型-1 | ×0.35 | 开源模型-2 |
| AWS Bedrock Claude | AWS-Claude | ×1.8 | claude官key |
| 海外综合 | 多模型转发 | ×5 | openrouter官转 |
| OpenRouter | openrouter官转 | ×4.5 | 多模型转发 |
用例选分组的核心原则
- 生产/工作 → 官 key 类（
claude官key/openai官key/Gemini/Azure）：稳，对应官方通道 - codex 用 codex 专属分组：
codex转发 ×0.2是为 codex CLI 调优过的，又便宜又能跑 - 日常聊天 / 试玩 → 逆向类便宜分组（
Claude-官网逆向 ×0.1）：偶尔波动可接受 - MJ / 视频 / 嵌入 / 开源模型 都有专属分组，按模型属性选
"逆向" vs "官 key"
- 官 key（
claude官key/openai官key等）= 直接走厂商官方 API → 最稳定、最贵 - 逆向（
Claude-官网逆向）= 走 Web 端反向解析 → 极便宜，但偶有波动；不建议用于生产 - 稳定分组（
Claude Code 稳定分组）= 在官 key 与逆向之间，性价比折衷
兜底分组的扣费规则
fallback 到兜底分组时，按 当时实际命中 的分组倍率计费，不是按主分组倍率。所以不要随便挂个 ×5 的兜底，否则故障切过去会被高价扣费。
建议：兜底分组选倍率接近主分组的（同档位备份），而不是"什么都挂上"。
4.4 提交并复制令牌
点「创 建」。新令牌出现在列表中：行尾复制按钮点一下即可拷到剪贴板（格式 sk-xxxxxxxxx）。
令牌 = 你的钱
- ❌ 不要硬编码到代码里
- ❌ 不要提交到 GitHub / Gitee（公开仓库 30 秒内会被爬虫扫到盗刷）
- ❌ 不要发到群聊 / 截图
- ✅ 用环境变量 / 1Password / .env（加 .gitignore）
- ✅ 怀疑泄露立即在列表中禁用并新建
五、查看可用模型 + 价格
个人中心：可用模型一览
账户 → 个人中心，下方"可用模型"区域按分组 Tab 列出当前账户可调用的全部模型 + 各分组可用率：
新账户开箱即得 154 个可用模型 / 总可用率 80.5%（实时变化）。
费用说明：实时定价
账户 → 费用说明，按厂商分类列出 323 项模型 / 9 个平台的当前定价：
计费公式（页面顶部三段提示，记下来很重要）：
转换率 = (新充值倍率 / 原充值倍率) × (新分组倍率 / 原分组倍率)
按量计费费用（USD） = 转换率 × 分组倍率 × 模型倍率 ×
（提示 token 数 + 补全 token 数 × 补全倍率） / 500000实际扣费：USD × 当时汇率 = ¥。
详细举例与缓存命中折算见 计费说明。
视频/图像模型按"项目化"计费
不同于文本按 token，下面这些走按时长/按次/按秒计费：
| 平台 | 项数 | 计费维度 |
|---|---|---|
| Kling 可灵 | 47 | 模型版本 + 模式(std/pro) + 时长 + 音频 |
| Hailuo 海螺 (MiniMax) | 20 | 模型版本 + 分辨率 + 时长 |
| VEO (Google) | 32 | 按秒，模型版本 + 分辨率 + 音频 |
| Vidu | 113 | 模型版本 + 分辨率 + 时长（积分制） |
| Wan 万象 (阿里) | 18 | 按秒，模型版本 + 类型 |
| Sora (OpenAI) | 2 | 按秒，720p 标准 / Pro |
| Runway | 12 | 动作类型 + 模型版本 + 时长 |
六、监控分组健康度（选分组前必看 ⭐）
直达地址：https://qinzhiai.com/groupAvailability（登录后可访问；顶部导航 分组状态 也是同一个页面）
页面显示全部 13 个分组的实时成功率，数据来自全平台真实调用统计：
- 顶部统计卡：正常 / 部分可用 / 不可用 / 暂无数据 的分组数
- 时间维度：1 小时 / 24 小时 / 7 天 / 30 天 / 全部
- 筛选：搜索分组 / 搜索模型 / 状态过滤
- 每行显示：分组名 + 内部别名 + 描述 + 当前状态 + 成功率进度条 + 更新时间
选分组前 30 秒：先看这里
本文档表格里的"推荐分组"是按正常通道写的。但分组的可用率会变——比如某段时间 Claude Code 稳定分组 可能 0%，AWS-Claude 可能只有 14%——这时候即使倍率再低也用不了。
养成习惯：建/换令牌前打开 /groupAvailability 瞄一眼。看到目标分组红了，就按文档表挑同类的备选。
状态含义
- 正常（绿）：成功率 ≥ 95%，可放心用
- 部分可用（黄）：成功率 50–95%，能跑但偶有重试
- 不可用（红）：成功率 < 50%，别用，主路挂这里会大量报错
- 暂无数据：近期没有真实请求积累统计，调用是否能通需自己测
七、令牌管理操作
| 操作 | 路径 | 说明 |
|---|---|---|
| 复制 Key | 列表行 → 复制按钮 | 一键到剪贴板 |
| 查看用量 | 列表行 → 第二个图标 | 调用次数、消耗额度 |
| 改备注 | 列表行 → 第三个图标 | 标记用途 |
| 编辑 / 禁用 / 删除 | 列表行 → 第四个图标 | 改分组、临时停用、彻底删除 |
| 按量明细 | 顶部"日志" | 每次调用的 token / 缓存 / 实际扣费 |
| MJ 任务 | 顶部"绘图" | Midjourney 历史 |
| 视频任务 | 顶部"异步任务" | Sora / Kling / Vidu 等 |
八、安全建议
# ✅ 推荐：环境变量
export ANTHROPIC_AUTH_TOKEN="sk-你的APIKey"
export ANTHROPIC_BASE_URL="https://api.qinzhiai.com"
# ✅ 推荐：项目根 .env（务必加进 .gitignore）
echo 'ANTHROPIC_AUTH_TOKEN=sk-xxx' >> .env
echo '.env' >> .gitignore
# ❌ 危险：硬编码
const apiKey = "sk-xxxxxx" // 千万别这样！最佳实践 checklist：
- [ ] 每个项目独立令牌（出问题方便定位 + 单独禁用）
- [ ] 每 90 天轮换一次
- [ ] 生产环境启用"高级选项 → IP 限制"
- [ ] 怀疑泄露 → 立即在列表禁用 → 新建一把
- [ ] 大额使用前在「分组状态」确认目标分组健康
九、常见问题
Q: 注册后没收到邮箱验证码？ A: 优先用 Gmail / Outlook（QQ/163 经常被拦）。检查垃圾邮件。仍未收到，60 秒后再点"获取验证码"刷新。
Q: 图形验证码看不清？ A: 点击图片可刷新一张。或刷新整个页面重来。
Q: 调用立即返回 401？ A: 多半是 base URL 写错了。正确格式：https://api.qinzhiai.com，末尾不要加斜杠，不要再拼 /v1 两次。
Q: 调用返回 402 余额不足？ A: 账户 → 个人中心 看"账户余额"。注册送的 ¥0.20 用完会显示 0；充值后秒生效。
Q: 调用返回 403 / 模型不支持？ A: 该分组不包含目标模型。换分组试，或在 账户 → 个人中心 → 可用模型 搜索目标模型看哪个分组覆盖。
Q: 同一把 Key 能多客户端用吗？ A: 可以。账户级有 RPM 限制，详见 等级/限制（账户页内）。
Q: 令牌丢了能找回吗？ A: 不能。直接列表里找到行 → 复制按钮重新拷一次（新版可重复读取，无需重建）；或禁用旧的、新建一把。
Q: 注册送的 ¥0.20 能用多久？ A: 长期有效，不会过期。够你跑几十次小请求验证接入。
Q: 充值最低多少？ A: $10 USD，按当时汇率折算 RMB 支付。
下一步
- 🤖 Claude Code 配置 — 官方 AI 编程 CLI
- 🛠 OpenCode — 开源 Claude Code 替代
- 🧩 Cline — VS Code 插件
- 💬 Cherry Studio — 桌面聊天
- 📚 全部应用教程
还没注册？
👉 立即注册 ClaudeHub（送 ¥0.20 体验额度 + 一把初始令牌）