OpenPAI 是一个 API 网关:你的应用 → OpenPAI → 上游模型厂商。
在使用前,先理解以下几个关键概念能帮助你少踩坑。
账号(User)
代表一个真实的用户或团队。账号下持有 额度(Quota),所有 API 调用都会从账号额度中扣费。
账号属于某个 分组(Group),分组决定了该账号使用模型时的倍率。
令牌(Token / API Key)
形如 sk-XXXXXXXX 的字符串,是调用 API 时的身份凭证。
一个账号可以创建多个令牌,每个令牌可单独配置:
- 额度上限:该令牌允许消耗的最大金额(
-1 表示不限制)。
- 过期时间:留空表示永不过期。
- 模型范围:允许调用的模型白名单(留空表示全部)。
- IP 白名单:仅允许指定 IP 调用(可选)。
建议为不同应用 / 环境(测试、生产)分别创建独立令牌,便于追踪消耗与吊销。
分组(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
模型(Model)
模型 ID 与上游官方保持一致,例如 gpt-5.5、claude-opus-4-8、gemini-3.1-pro-preview。
在 OpenPAI 控制台或 模型总览 中可以查看:
- 模型 ID 与对应上游
- 输入 / 输出价格倍率
- 上下文窗口
- 支持的能力(视觉、工具、流式、缓存等)
Token 与 Quota
OpenPAI 采用 Token 计费 方式,与 OpenAI 官方一致:
- prompt_tokens:你发送给模型的输入 Token 数。
- completion_tokens:模型返回的输出 Token 数。
- cached_tokens:命中提示缓存的 Token,按更低倍率结算。
- reasoning_tokens:推理模型产生的思考链 Token(不可见但计费)。
最终扣费公式(简化):
扣费 = (prompt × 输入倍率 + completion × 输出倍率 + cached × 缓存倍率)
× 模型分组倍率
× 用户分组倍率
端点(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- 密钥与账号额度,你只需选择最贴近现有应用的协议即可。 
