# 模型选择指南

模型不是越贵越好，**选对任务用对模型**才最省心。本页帮你快速判断该用哪个，并解释控制台里的渠道、平台、分组、模型与倍率关系。

> 具体有哪些模型、各自倍率，以控制台 [api.clomio.ai](https://api.clomio.ai) 你所在[分组](#/api-key)显示为准。下面讲的是“怎么选”和“为什么实际模型可能不同”的通用思路。

---

## 渠道 → 平台 → 分组 → 模型

一次请求大致按这条链路选择模型：

1. **渠道（Channel）**：网关里配置的一条上游线路，决定请求能发到哪里。
2. **平台（Platform）**：OpenAI、Anthropic、xAI/Grok、Gemini 等能力类型。
3. **分组（Group）**：你的 API Key 绑定的分组，决定你能用哪些渠道/平台/模型，以及用户侧倍率。
4. **模型（Model）**：你在请求里写的模型名，可能经过模型映射后变成上游真实模型。

所以控制台用量里可能同时看到：

- **请求模型**：你传入的模型名。
- **上游模型**：模型映射后真实发给上游的模型。
- **模型映射链**：从别名到真实模型的映射过程（若有）。

排查“为什么表现不像预期模型”时，请先看用量明细里的上游模型。

### 模型名、别名、路由不是一回事

控制台和 API 里常见三种“模型名”:

| 口径 | 你在哪里看到 | 说明 |
|------|--------------|------|
| 请求模型 | 请求体 `model`、`GET /v1/models` | 客户端可填写的名字;可能是平台自定义别名 |
| 路由模型 / 映射目标 | 分组开放模型、模型映射、分组默认路由 | 网关用它改写请求；左侧通常是请求名，右侧通常是上游目标 |
| 上游真实模型 | 控制台用量明细、错误详情里的 upstream model | 实际发到 OpenAI、Anthropic、Grok 等上游的模型 |

所以“列表里能看到某模型”只代表当前分组允许你用这个**请求名**；它不保证上游真实模型同名。若遇到质量、价格、能力和预期不一致，按顺序核对：控制台分组开放模型 → 模型映射/默认路由 → 本次用量明细里的上游模型。

`GET /v1/models` 返回的是**当前这把 Key 可见**的模型：会综合 Key 分组、平台和当前分组开放模型；没有显式模型列表时才回退到平台默认模型。控制台 `/channels/available` 也是“当前用户已有 active 可用 Key 的线路视图”，不是全站所有渠道或全部模型表。

---

## 倍率怎么理解

- **默认倍率 / 分组倍率**：分组或模型默认倍率，决定用户侧基础扣费规则。
- **用户专属倍率**：平台可对特定用户设置专属倍率，最终会体现在 `actual_cost`。
对用户来说，余额/订阅真正减少的是用量明细里的 `actual_cost`；`cost` / `total_cost` 主要用于理解基础模型成本。

---

## Claude 系列（Anthropic）

| 档位 | 特点 | 适合 |
|------|------|------|
| **Haiku** | 最轻、最快、最省 | 简单问答、格式整理、批量小任务 |
| **Sonnet** | 性价比之王，多数人日常首选 | 日常写代码、改文件、一般推理 |
| **Opus** | 能力最强，价格也最高 | 复杂架构设计、深度推理、攻坚难题 |

**建议：默认用 Sonnet，遇到啃不动的难题再升 Opus，简单杂活交给 Haiku 省钱。** 在工具里用 `/model` 随时切换。

---

## GPT / Codex 系列（OpenAI）

GPT 系列除了选型号，还能调**推理强度**（`model_reasoning_effort`：`low`→`high`/`xhigh`）：

- 快速、简单的活：低推理强度，又快又省
- 需要细致分析：高推理强度，更可靠但更慢更费

配置见 [Codex 配置详解](#/codex-config)。

---

## Grok（xAI）/ 国产模型

- **Grok**：擅长快速代码任务与对话，还支持图像/视频/联网搜索，见 [API 调用指南](#/api-usage)。
- **Videos 仅 Grok**：视频生成目前只走 Grok 视频能力；创建 Key 时请选择支持 Grok Videos 的 Grok 分组。
- **国产模型**：中文场景、成本敏感时的实惠选择，以控制台清单为准。

### 能力先看端点,再看模型

不同平台开放的端点不一样,不要只看模型名:

- Claude 分组主路径是 `/v1/messages`;`/v1/messages/count_tokens` 主要用于 Claude/Anthropic 兼容分组。
- OpenAI 分组主路径是 `POST /v1/responses`、`/v1/chat/completions`、`/v1/embeddings`、`/v1/images/*`;若要用 `/v1/messages`,当前分组必须开放 Messages 兼容能力。
- Grok 分组支持 `POST /v1/responses`、`/v1/chat/completions`、`/v1/images/*`、`/v1/videos/*`、`/v1/web_search`；`/v1/messages` 需当前分组开放 Messages 兼容能力，`/v1/embeddings` 仍只支持 OpenAI 分组。
- Gemini 分组走 [Gemini 原生兼容](#/api-gemini) 的 `/v1beta/models...`,Base URL 不带 `/v1`。
- Antigravity 分组走 [Antigravity 接入](#/antigravity) 的 `/antigravity/v1...` 或 `/antigravity/v1beta...`,不会和普通 Claude/OpenAI/Grok 混合调度。
- `GET /v1/responses` 是 Codex/Responses WebSocket 入口,不是按 ID 查历史;当前也没有 `GET /v1/models/{id}`。

---

## 快速决策

| 你的任务 | 推荐 |
|----------|------|
| 日常写代码、改 bug | Claude Sonnet / GPT 中档 |
| 复杂架构、深度推理 | Claude Opus / GPT 高推理 |
| 简单问答、整理格式 | Haiku / 轻量模型 |
| 执行任务、排查问题 | Codex（GPT） |
| 理思路、聊方案 | Claude |
| 生成图片 | 图像模型按分组选择 |
| 生成视频 | Grok Videos 分组 |
| Gemini 原生 SDK/CLI | Gemini 分组 + [Gemini 原生兼容](#/api-gemini) |
| Antigravity 客户端 | Antigravity 分组 + [Antigravity 接入](#/antigravity) |

分不清就记：**日常 Sonnet，难题 Opus，杂活 Haiku；思考用 Claude，执行用 Codex；视频只选 Grok。**

---

## 确认模型表现是否符合预期

换了模型或分组后，想确认它发挥正常，可以简单自测：

- **长上下文**：贴一篇较长的文档，让它总结中间某一段——能准确总结，说明上下文窗口够用。
- **推理能力**：出一道经典逻辑/数学题，看回答质量是否符合该档位模型的水平。
- **看使用记录**：在控制台核对本次调用的请求模型、上游模型、token、缓存和 `actual_cost`，做到心里有数。

如果表现和预期差距明显，换个[分组或线路](#/gateway-lines)再试，或在控制台联系支持。

---

## 模型不可用时先看哪个报错

模型、分组和服务可用性是三层判断,报错含义不同:

- `The current group does not support the requested model "xxx". Available models: ...`:分组明确不支持该模型,按列表换模型或换分组。可见模型很多时,报错只展示前一部分并追加 `and N more`,完整列表请看控制台或 `GET /v1/models`。
- `model_not_found` / `Model "xxx" is not supported by any configured account in this group`:当前分组没有可提供该模型的服务,常见于模型名写错或分组能力不匹配。
- `No available accounts supporting model: xxx`:该模型服务暂时不可用,可能是限速、额度或并发导致。
- `No available accounts`:当前分组暂时没有可用服务资源。

查可见模型用 `GET /v1/models` 或控制台模型清单;当前没有 `GET /v1/models/{id}`。Responses 历史也不能用 `GET /v1/responses/{id}` 查询,多轮续接交给 Codex/SDK 或在下一次 `POST /v1/responses` 传 `previous_response_id`。

---

> 选好模型后，怎么省着用见 [计费与额度](#/billing)。