API密钥、分组与计费
先看懂API密钥、分组和付费方式之间的关系,再去创建API密钥。
一句话说明
API密钥负责鉴权;分组决定模型和倍率;余额或订阅决定扣费方式。
"API密钥"和"Token"的区别:本文说的API密钥是调用凭证(一把钥匙);你在别处看到的"token 数量"是 LLM 处理文本的最小计费单位。两者含义不同,不要混淆。
四个核心概念
API密钥:调用凭证
作用只有一个:让请求能证明"这是你的账号在调用"。
不管有没有余额、有没有订阅,发请求都需要API密钥。它不等于余额,也不等于模型权限。
分组:决定模型和倍率
每个API密钥绑定一个分组,分组决定两件事:
- 能调用哪些模型
- 按什么倍率计费
分组名称、模型范围、倍率和套餐归属由服务端动态配置。创建 API Key 前:
- 在模型广场打开目标模型。
- 查看当前 分组价格 和支持分组。
- 在钱包/订阅页确认余额或套餐权益。
- 创建属于该分组的 API Key。
不要从教程、截图或历史 FAQ 复制固定倍率;生产事实以当前模型广场、套餐页和账单记录 为准。
普通余额:按量扣费
充值后按模型价格和分组倍率扣费,适合用量不稳定、想先试用或按量控成本的场景。
订阅套餐:账号权益
开通后账号获得订阅权益,但仍然需要API密钥。调用链路是:
- 客户端用API密钥发请求
- 系统读取API密钥所属分组
- 结合账号权益判断如何处理
订阅和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密钥之前做。
- 打开模型广场
- 点击你要用的模型
- 查看 分组价格 里的"分组"列
那一列出现的分组,才是这个模型支持的分组。如果你的API密钥分组不在里面,先换模型或换分组。
核对实际消耗
模型价格、分组倍率、输入/输出构成和缓存计费都可能变化。请在模型广场核对调用时的 配置,并以对应请求的账单明细为准;缺少时间、分组和请求构成的历史样本不能用于估算 当前成本。