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

​
账号(User)

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

​
令牌(Token / API Key)

形如 sk-XXXXXXXX 的字符串,是调用 API 时的身份凭证。 一个账号可以创建多个令牌,每个令牌可单独配置:
  • 额度上限:该令牌允许消耗的最大金额(-1 表示不限制)。
  • 过期时间:留空表示永不过期。
  • 模型范围:允许调用的模型白名单(留空表示全部)。
  • IP 白名单:仅允许指定 IP 调用(可选)。
建议为不同应用 / 环境(测试、生产)分别创建独立令牌,便于追踪消耗与吊销。

​
分组(Group)

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

​
通道(Channel)

通道是 OpenPAI 与上游模型服务的连接配置。一个模型可以由多个通道提供:
每次请求会按权重随机选择健康通道,若失败则自动重试下一通道。 通道层面的细节对调用方完全透明 —— 你只需要使用模型 ID 即可。

​
模型(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(不可见但计费)。
最终扣费公式(简化):
详细规则见 计费机制。

​
端点(Endpoint)

OpenPAI 同时暴露 3 套协议端点,你可以按现有代码选择: 三套端点共用同一个 sk- 密钥与账号额度,你只需选择最贴近现有应用的协议即可。