跳到主要内容

账户与余额

Bita API 的账户余额用于支付模型调用产生的费用。账户下的所有 API 密钥共享同一个账户余额,但每枚 API 密钥可以另外设置自己的额度上限。

查看账户余额

登录 Bita API 并进入控制台,可以在账户概览或钱包相关页面查看当前可用余额。

查看余额时,建议同时确认:

  • 当前可用余额
  • 累计消耗
  • API 密钥自身的额度设置
  • 最近的模型调用记录

余额会在模型请求产生费用后更新。刚完成调用时,页面数据可能需要短暂刷新。

账户余额与 API 密钥额度

账户余额和 API 密钥额度是两个不同的限制:

项目账户余额API 密钥额度
作用范围当前账户下的所有 API 密钥仅限制指定 API 密钥
用途支付账户产生的全部模型费用控制单个应用或项目最多可以消耗多少
耗尽后的影响账户下所有密钥通常都无法继续产生付费调用只有该密钥无法继续调用
设置位置账户或钱包页面创建或编辑 API 密钥时设置

例如,账户余额还有 100,某枚 API 密钥的独立额度只剩 10。这枚密钥最多只能继续消耗自己的剩余额度,其他 API 密钥仍可使用账户余额。

无限额度不等于无限余额

API 密钥开启「无限额度」,只表示该密钥没有单独的消耗上限。所有请求仍会扣减账户余额,并受到站点计费和调用规则限制。

余额如何产生消耗

实际费用取决于模型的定价方式、请求用量和 API 密钥分组倍率。

按量计费

按量计费的模型通常根据输入和输出 Token 数量计算费用:

模型基础消耗 = 输入用量费用 + 输出用量费用
实际消耗 = 模型基础消耗 × API 密钥分组倍率

部分模型还会单独计算缓存、图片、音频或其他项目,最终以模型广场展示的价格和调用记录为准。

按次计费

按次计费的模型通常按照每次成功调用的固定价格扣费,实际消耗同样可能受到分组倍率影响。

可以在模型广场中通过「定价类型」筛选按量计费或按次计费模型。

分组倍率对余额的影响

API 密钥创建时选择的分组会参与最终计费。例如,在其他条件相同的情况下:

分组倍率模型基础消耗实际消耗
1x100100
0.7x10070
0.6x10060

这里只演示分组倍率的作用。不同分组可用的模型和模型基础价格可能不同,因此不能只根据倍率判断最终成本。

关于分组选择的详细说明,参见创建 API 密钥:分组

预扣与实际结算

部分模型请求会在调用开始前按照预计用量预扣一部分余额,调用完成后再根据实际用量结算:

  1. 请求开始前,系统检查账户余额和 API 密钥额度。
  2. 系统可能按预计用量进行预扣。
  3. 模型响应完成后,根据实际输入和输出用量重新计算费用。
  4. 预扣金额与实际金额之间的差额会被调整。

因此,在请求进行中看到的余额变化可能不是最终消费金额,应以调用完成后的使用记录为准。

核对余额变化

如果需要确认某次请求扣除了多少余额,可以进入调用记录或使用记录页面,并按时间、API 密钥和模型筛选记录。

重点检查以下信息:

  • 请求使用的 API 密钥
  • 模型 ID
  • 输入和输出 Token 数量
  • API 密钥分组
  • 分组倍率
  • 本次实际消耗

如果余额下降与预期不符,应先核对模型价格、分组倍率以及是否存在其他 API 密钥的调用。

余额不足时

余额或 API 密钥额度不足时,请求可能失败并返回额度相关错误。可以依次检查:

  1. 刷新控制台,确认账户当前余额。
  2. 检查 API 密钥是否设置了独立额度。
  3. 检查 API 密钥是否已经过期或被停用。
  4. 查看最近调用记录,确认是否存在异常消耗。
  5. 根据需要联系平台人员进行线下充值。

如果发现不认识的调用记录,应立即停用相关 API 密钥并创建新密钥。

下一步

需要增加账户余额时,继续阅读线下充值