主题
Key 分组与权限
Shuro 用分组（group） 控制每把 Key 能用哪些模型。理解分组规则可以避免"明明买了为什么调不通"的踩坑。
一句话
一把 Key 看到多少模型，取决于它在哪个分组。 不同分组对应不同价格/权限/上游通道。
怎么看你的 key 在哪个分组
进 Shuro 控制台 → 「令牌」 → 编辑你那把 key → 看「可用分组」字段。
Shuro 当前的分组及计费倍率（2026-07 实查 /api/pricing）：
| 分组 | 分组倍率 | 说明 |
|---|---|---|
default | 1X | 默认分组 |
Claude | 0.45X | Claude 系列专用通道 |
Codex | 0.05X | GPT / Codex 专用通道，倍率最低 |
AWS | 0.6X | Claude 走 AWS 通道 |
分组倍率会乘在模型倍率之上，最终价格以控制台「价格」页为准。分组划分可能随运营调整，以你的 Shuro 控制台为准。
验证当前 Key 能用哪些模型
最准方式：直接调 /v1/models 接口：
bash
curl -sS 'https://shuro.vip/v1/models' \
-H 'Authorization: Bearer <您的 API Key>' \
| jq -r '.data[].id' | sort返回的就是你这把 key 实际有权限的全部模型。
Shuro 全站在售模型共 9 个（6 个 Claude + 3 个 GPT，2026-07 实查）：
| 返回数 | 说明 |
|---|---|
| 9 | 全模型 key |
| 6 | 仅 Claude 分组 |
| 3 | 仅 GPT / Codex 分组 |
| 0 | Key 没分配到任何分组（异常） |
典型权限错误信号
信号 1：/v1/models 返回 0 个
bash
$ curl https://shuro.vip/v1/models -H "Authorization: Bearer sk-xxx" | jq '.data | length'
0原因：Key 未分配分组 / 被禁用 / 已过期。 解决：去控制台编辑 key，确认「可用分组」非空、状态启用、未过期。
信号 2：调某模型返 503 model_not_found
json
{"error":{"message":"分组 Claude 下模型 gpt-5.5 无可用渠道","type":"new_api_error"}}原因：你的 key 分组里没有该模型。 解决：
- 在控制台调整 key 的「可用分组」
- 或换有权限的模型（先
/v1/models看可用列表）
信号 3：调某模型返 403 permission denied
原因：Key 显式被限制了某些模型。 解决：检查 key 的「模型限制白名单」字段，确保目标模型在内。
多分组组合
一把 key 可以同时属于多个分组：
可用分组：default,Claude,Codex
↓
可见模型 = 各分组的并集
↓
计费时按请求实际走的分组取对应倍率控制台编辑 key 时勾多个分组即可。
Key 的其他权限字段
除了分组，每把 key 还有这些限制：
| 字段 | 含义 | 默认 |
|---|---|---|
| 状态 | 启用 / 禁用 | 启用 |
| 过期时间 | Unix 时间戳 | 永不过期 |
| 额度上限 | 总额度 | 无限 |
| 已用额度 | 累计消费 | 0 |
| 模型白名单 | 显式限定可调模型 | 空（=全部） |
| IP 白名单 | 限定调用 IP | 空（=全部） |
| 每分钟请求数 | RPM 限速 | 0（=不限） |
| 每分钟 token 数 | TPM 限速 | 0（=不限） |
设置合理的限制 = 防止 key 泄露后被滥用。
不同分组的价格差异
同一个模型在不同分组里单价可能不同（分组倍率 × 模型倍率）：
| 分组 | 分组倍率 | 说明 |
|---|---|---|
Codex | 0.05X | GPT / Codex 专用，最便宜 |
Claude | 0.45X | Claude 专用通道 |
AWS | 0.6X | Claude 走 AWS 通道 |
default | 1X | 默认 |
便宜分组 ≠ 一定划算
低倍率分组的上游通道与缓存表现未逐一验证；若你的工作流高度依赖缓存命中，建议按提示缓存优化自测各分组的实际命中率后再选。
客户实战场景
场景 A：买了 Claude 分组套餐但想用 Codex
bash
curl /v1/models # 只返回 6 个 Claude，没 GPT
codex # 报错 model_not_found解决：在控制台把 key 加入 Codex 分组（或另建一把 Codex 分组的 key，推荐多 key 分离管理）。
场景 B：一把 key 给多个客户用
不推荐：所有人共享额度 + 出问题难追溯。
推荐：每个客户独立 key，分配同一分组。控制台批量创建，每把限定个人额度。
场景 C：测试环境 vs 生产环境
- 测试 key：小额度 + 限定便宜模型分组 + IP 白名单
- 生产 key：大额度 + 全模型 + IP 白名单 + 严格 RPM/TPM 限速
调试技巧
探活某分组下的所有模型
bash
#!/bin/bash
# probe-all-models.sh
TOKEN="<您的 API Key>"
# 拉所有模型
MODELS=$(curl -sS "https://shuro.vip/v1/models" \
-H "Authorization: Bearer $TOKEN" \
| jq -r '.data[].id')
# 挨个 ping
for M in $MODELS; do
CODE=$(curl -sS -o /dev/null -w "%{http_code}" \
-X POST "https://shuro.vip/v1/chat/completions" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d "{\"model\":\"$M\",\"max_tokens\":5,\"messages\":[{\"role\":\"user\",\"content\":\"hi\"}]}")
echo "$M $CODE"
done | tee model-health.txt输出形如：
claude-opus-4-7 200 ✅
gpt-5.5 200 ✅
gpt-5.4-mini 503 ❌ 该分组没此通道Key 切换最快方式
用 CC Switch 管理多 key —— 切到不同分组 key 一键完成。