<!-- Generated by web/scripts/generate-public-discovery.mjs from web/src/data/onboarding-md. Do not edit by hand. -->

# 分组与模型 · 选对 group 是接入第一步

> **令牌选什么 group, 就决定能用哪些模型和走哪套价格配置**。选错最常见后果：`model_not_found` 404。
>
> 分组价格、可用模型和模型描述会随运营配置调整，文档不写固定价格数字；实际以 **模型广场** 和控制台日志为准。

---

## 一句话总览

| group         | 适合谁                    | 模型范围 / 特点                                   |
| ------------- | ------------------------- | ------------------------------------------------- |
| `gpt-plus`    | **大多数 GPT 用户**       | 覆盖常用 GPT / Codex / 图片模型，适合日常主力使用 |
| `gpt-pro`     | 重度 Codex / 高强度推理   | GPT 高阶资源池，适合长上下文、记忆和重度任务      |
| `gpt-vip`     | **⚠️ 老分组，不建议新建** | 老分组可能不可用或不稳定                          |
| `claude-vip`  | **大多数 Claude 用户**    | Claude 全量资源池，包含 Opus / Sonnet / Haiku     |
| `claude 特惠` | 想用 Claude 但不用 Opus   | Claude 常用资源池，通常覆盖 Sonnet / Haiku        |

实时模型和价格配置以 **模型广场** 展示为准。

---

## 价格怎么看

不要按文档里的历史数字估价。实际扣费由 **模型价格、分组价格配置、输入/输出用量** 共同决定，可能随运营配置调整。

你应该看两个地方：

1. **模型广场**：看当前 group 下可用模型和实时价格配置。
2. **控制台 → 日志**：看每次请求的实际扣费明细。

日常只用 Sonnet / Haiku 可优先看 `claude 特惠`；需要 Opus 再看 `claude-vip`。最终仍以模型广场当前展示为准。

---

## 常见模型类型

### OpenAI 系列（gpt-plus / gpt-pro）

| model 示例      | 用途                       |
| --------------- | -------------------------- |
| `gpt-5.5`       | 主力模型，对标 ChatGPT Pro |
| `gpt-5.4`       | 上代主力                   |
| `gpt-5.4-mini`  | 轻量任务 / 客服            |
| `gpt-5.3-codex` | Codex 专用编码版本         |
| `gpt-image-2`   | 画图                       |

### Anthropic Claude（claude-vip / claude 特惠）

| model 示例          | 用途                          |
| ------------------- | ----------------------------- |
| `claude-opus-4-7`   | 复杂推理 / 高质量输出         |
| `claude-opus-4-6`   | Opus 系模型                   |
| `claude-sonnet-4-6` | **主力推荐**，速度 + 质量平衡 |
| `claude-haiku-4-5`  | 轻量快速任务                  |

> 这里只列常见模型类型，完整可用模型和价格配置以 **模型广场** 为准。

---

## 我应该选哪个 group？

### 决策树

**只用 Claude？** → 不用 Opus 选 `claude 特惠`，要 Opus 选 `claude-vip`

**只用 GPT / Codex？** → 普通选 `gpt-plus`，重度长上下文选 `gpt-pro`

**两个都要？** → **建两个令牌**，分别选不同 group，分工具用：

- `claude-code-mac` 令牌 → `claude-vip` group
- `codex-mac` 令牌 → `gpt-plus` group

### 不要为了"全能"勉强用 gpt-vip

`gpt-vip` 是老分组，新建令牌不要再选。已有 `gpt-vip` 令牌建议重建令牌，改选 `gpt-plus` / `gpt-pro`。

---

## 模型广场看实时清单

顶部 nav "**模型广场**" → 左侧选 group → 右侧看该 group 包含的全部 model、实时价格配置和描述：

![模型广场](/docs-onboarding/02-pricing-square.png)

---

## 防 `model_not_found` 4 步排查

1. **检查令牌 group**：控制台 → 令牌 → 看你这个 key 用的 group
2. **对照本页表格**：你要的 model 是不是在这个 group 的清单里
3. **改正其一**：
   - 改令牌 group（删了重建，旧 key 同时失效）
   - 改工具配置 model 名拼到正确 group 包含的模型
4. **仍然 404**：去 https://beefapi.com 看 "**模型广场**" 实时清单（有可能新模型刚上 / 旧模型刚下）

---

## 下一步

- [客户端配置](/docs/onboarding/clients) - 拿 key + group 配工具
- [错误码排查](/docs/onboarding/errors) - 401 / 429 / 524 / model_not_found