API密钥、分组与计费

先看懂API密钥、分组和付费方式之间的关系,再去创建API密钥。

一句话说明

API密钥负责鉴权;分组决定模型和倍率;余额或订阅决定扣费方式。

"API密钥"和"Token"的区别:本文说的API密钥是调用凭证(一把钥匙);你在别处看到的"token 数量"是 LLM 处理文本的最小计费单位。两者含义不同,不要混淆。

四个核心概念

API密钥:调用凭证

作用只有一个:让请求能证明"这是你的账号在调用"。

不管有没有余额、有没有订阅,发请求都需要API密钥。它不等于余额,也不等于模型权限。

分组:决定模型和倍率

每个API密钥绑定一个分组,分组决定两件事:

  • 能调用哪些模型
  • 按什么倍率计费

分组名称、模型范围、倍率和套餐归属由服务端动态配置。创建 API Key 前:

  1. 在模型广场打开目标模型。
  2. 查看当前 分组价格 和支持分组。
  3. 在钱包/订阅页确认余额或套餐权益。
  4. 创建属于该分组的 API Key。

不要从教程、截图或历史 FAQ 复制固定倍率;生产事实以当前模型广场、套餐页和账单记录 为准。

普通余额:按量扣费

充值后按模型价格和分组倍率扣费,适合用量不稳定、想先试用或按量控成本的场景。

订阅套餐:账号权益

开通后账号获得订阅权益,但仍然需要API密钥。调用链路是:

  1. 客户端用API密钥发请求
  2. 系统读取API密钥所属分组
  3. 结合账号权益判断如何处理

订阅和API密钥不是二选一,而是两层不同职责。

额度、倍率和实际购买力

账户上显示的余额单位是美元,等于你实际充值的金额。

概念公式:

实际扣除 = 当前模型计价 × 当前分组倍率

下面的数字只用于演示公式,不对应当前生产分组或价格。假设某模型计价为 $15,示例 倍率为 0.02:

$15 × 0.02 = $0.30

在这种纯倍率示例里,理论购买力可写作 账户余额 ÷ 倍率。实际账单还可能受到缓存、 输入/输出计价、套餐规则、模型路由和其他计费维度影响。

<svg viewBox="0 0 720 288" xmlns="http://www.w3.org/2000/svg" font-family="system-ui, sans-serif">
  <!-- Background -->
  <rect x="1" y="1" width="718" height="286" rx="14" fill="#FAFAFA" stroke="#E5E7EB" stroke-width="1"/>

  <!-- Title -->
  <text x="360" y="35" text-anchor="middle" font-size="15" font-weight="bold" fill="#374151">你的钱包:显示金额 vs 实际购买力</text>

  <!-- Wallet icon area -->
  <rect x="40" y="55" width="140" height="90" rx="10" fill="#DBEAFE" stroke="#3B82F6" stroke-width="1.5"/>
  <text x="110" y="85" text-anchor="middle" font-size="28" font-weight="bold" fill="#1E40AF">$5</text>
  <text x="110" y="110" text-anchor="middle" font-size="12" fill="#374151">钱包余额</text>
  <text x="110" y="128" text-anchor="middle" font-size="11" fill="#6B7280">你充值的金额</text>

  <!-- Multiply sign -->
  <text x="210" y="95" text-anchor="middle" font-size="22" font-weight="bold" fill="#6B7280">×</text>

  <!-- Rate -->
  <rect x="240" y="55" width="120" height="90" rx="10" fill="#ECFDF5" stroke="#10B981" stroke-width="1.5"/>
  <text x="300" y="85" text-anchor="middle" font-size="28" font-weight="bold" fill="#065F46">50</text>
  <text x="300" y="110" text-anchor="middle" font-size="12" fill="#374151">购买力倍数</text>
  <text x="300" y="128" text-anchor="middle" font-size="11" fill="#6B7280">1 ÷ 0.02</text>

  <!-- Equal sign -->
  <text x="390" y="95" text-anchor="middle" font-size="22" font-weight="bold" fill="#6B7280">=</text>

  <!-- Effective value -->
  <rect x="420" y="55" width="260" height="90" rx="10" fill="#FEF3C7" stroke="#F59E0B" stroke-width="1.5"/>
  <text x="550" y="85" text-anchor="middle" font-size="28" font-weight="bold" fill="#92400E">$250</text>
  <text x="550" y="110" text-anchor="middle" font-size="12" fill="#374151">等效官方消费额度</text>
  <text x="550" y="128" text-anchor="middle" font-size="11" fill="#6B7280">对标官方 API 的 $250 消费量</text>

  <!-- Comparison table -->
  <text x="360" y="175" text-anchor="middle" font-size="13" font-weight="bold" fill="#374151">公式示意(非当前生产分组或价格)</text>

  <!-- Table header -->
  <rect x="60" y="190" width="600" height="30" rx="0" fill="#F3F4F6"/>
  <text x="170" y="210" text-anchor="middle" font-size="12" font-weight="bold" fill="#374151">分组</text>
  <text x="330" y="210" text-anchor="middle" font-size="12" font-weight="bold" fill="#374151">倍率</text>
  <text x="500" y="210" text-anchor="middle" font-size="12" font-weight="bold" fill="#374151">等效官方消费额度</text>

  <!-- Example A -->
  <line x1="60" y1="220" x2="660" y2="220" stroke="#E5E7EB" stroke-width="1"/>
  <text x="170" y="240" text-anchor="middle" font-size="12" fill="#374151">示例 A</text>
  <text x="330" y="240" text-anchor="middle" font-size="12" fill="#6B7280">0.02</text>
  <text x="500" y="240" text-anchor="middle" font-size="13" font-weight="bold" fill="#065F46">$250</text>

  <!-- Example B -->
  <line x1="60" y1="252" x2="660" y2="252" stroke="#E5E7EB" stroke-width="1"/>
  <text x="170" y="272" text-anchor="middle" font-size="12" fill="#374151">示例 B</text>
  <text x="330" y="272" text-anchor="middle" font-size="12" fill="#6B7280">0.025</text>
  <text x="500" y="272" text-anchor="middle" font-size="13" font-weight="bold" fill="#065F46">$200</text>
</svg>

不做固定 Plus 等价换算

官方订阅额度、滑动窗口、模型价格和本站分组倍率都会变化,不能用固定 $450、固定 倍率或固定汇率承诺“充值多少等于一个月 Plus”。需要估算时,应使用当前模型广场、 当期套餐页和自己的账单样本,并注明采样日期。

最容易犯的错

"我已经有API密钥了,应该能调所有模型" — 不成立。

决定调用是否成功的链路是:API密钥 → 分组 → 模型是否支持 → 按倍率处理。

最常见的错误就是API密钥选错了分组,导致模型明明存在但请求直接失败,报错通常是:

  • No available channel for model ... under group ...
  • group 相关错误

怎么查看模型支持哪些分组

建议放在创建API密钥之前做。

  1. 打开模型广场
  2. 点击你要用的模型
  3. 查看 分组价格 里的"分组"列

那一列出现的分组,才是这个模型支持的分组。如果你的API密钥分组不在里面,先换模型或换分组。

核对实际消耗

模型价格、分组倍率、输入/输出构成和缓存计费都可能变化。请在模型广场核对调用时的 配置,并以对应请求的账单明细为准;缺少时间、分组和请求构成的历史样本不能用于估算 当前成本。