> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 核心概念

> 理解 OpenPAI 的账号、令牌、分组、通道、模型与计费关系

OpenPAI 是一个 **API 网关**:你的应用 → OpenPAI → 上游模型厂商。
在使用前,先理解以下几个关键概念能帮助你少踩坑。

## 账号(User)

代表一个真实的用户或团队。账号下持有 **额度(Quota)**,所有 API 调用都会从账号额度中扣费。
账号属于某个 **分组(Group)**,分组决定了该账号使用模型时的倍率。

## 令牌(Token / API Key)

形如 `sk-XXXXXXXX` 的字符串,是调用 API 时的身份凭证。
一个账号可以创建多个令牌,每个令牌可单独配置:

* **额度上限**:该令牌允许消耗的最大金额(`-1` 表示不限制)。
* **过期时间**:留空表示永不过期。
* **模型范围**:允许调用的模型白名单(留空表示全部)。
* **IP 白名单**:仅允许指定 IP 调用(可选)。

<Tip>建议为不同应用 / 环境(测试、生产)分别创建独立令牌,便于追踪消耗与吊销。</Tip>

## 分组(Group)

分组用于实现 **多档定价**。例如:

| 分组        | 倍率   | 适用场景          |
| --------- | ---- | ------------- |
| `default` | 1.0× | 普通用户          |
| `vip`     | 0.8× | 充值满 100 元自动升级 |
| `svip`    | 0.5× | 企业客户          |

不同分组在调用同一个模型时,实际扣费会乘以分组倍率。
分组也可以与 **通道分组** 联动 —— 高级分组分配到更稳定的上游通道。

## 通道(Channel)

通道是 OpenPAI 与上游模型服务的连接配置。一个模型可以由多个通道提供:

```
gpt-5.5
  ├── Channel A: OpenAI 官方,权重 70
  ├── Channel B: Azure OpenAI,权重 20
  └── Channel C: 备用代理,权重 10
```

每次请求会按权重随机选择健康通道,若失败则自动重试下一通道。
通道层面的细节对调用方完全透明 —— 你只需要使用模型 ID 即可。

## 模型(Model)

模型 ID 与上游官方保持一致,例如 `gpt-5.5`、`claude-opus-4-8`、`gemini-3.1-pro-preview`。
在 OpenPAI 控制台或 [模型总览](/models/overview) 中可以查看:

* 模型 ID 与对应上游
* 输入 / 输出价格倍率
* 上下文窗口
* 支持的能力(视觉、工具、流式、缓存等)

## Token 与 Quota

OpenPAI 采用 **Token 计费** 方式,与 OpenAI 官方一致:

* **prompt\_tokens**:你发送给模型的输入 Token 数。
* **completion\_tokens**:模型返回的输出 Token 数。
* **cached\_tokens**:命中提示缓存的 Token,按更低倍率结算。
* **reasoning\_tokens**:推理模型产生的思考链 Token(不可见但计费)。

最终扣费公式(简化):

```
扣费 = (prompt × 输入倍率 + completion × 输出倍率 + cached × 缓存倍率)
       × 模型分组倍率
       × 用户分组倍率
```

详细规则见 [计费机制](/pricing/billing)。

## 端点(Endpoint)

OpenPAI 同时暴露 3 套协议端点,你可以按现有代码选择:

| 协议              | 端点前缀                                         | 鉴权头                                       |
| --------------- | -------------------------------------------- | ----------------------------------------- |
| OpenAI 兼容       | `https://openp.ai/v1/...`                    | `Authorization: Bearer sk-...`            |
| Claude Messages | `https://openp.ai/v1/messages`               | `x-api-key: sk-...` + `anthropic-version` |
| Gemini 原生       | `https://openp.ai/v1beta/models/{model}:...` | `x-goog-api-key: sk-...`                  |

三套端点共用同一个 `sk-` 密钥与账号额度,你只需选择最贴近现有应用的协议即可。