跳转到内容

额度、价格与折扣

额度决定还能调用多少,价格决定一次调用扣多少。先确认系统配置中的计费币种与业务时区,再为用户设置额度和折扣。

额度适用场景消费与重置
周期额度按日、周或月发放的套餐按用户周期规则重置
永久额度加购、注册赠额、退款或补偿不随套餐周期自动清零

一次调用先消耗周期额度,不足部分再从永久额度扣除。周期额度上限为 0、永久额度仍有余额时,用户依然可以调用。周期不限额时,总剩余可能显示为不限额。

用户详情中的周期额度与永久额度

日常加购应通过 Admin 的永久额度加额接口完成,并传入唯一业务流水号保证幂等;不要通过反复增加周期预算发放购买额度。接口契约见 Admin API。

  • 目录标准价(Standard):模型的目录价与命中的模型官方时段规则。
  • 供应成本(Metered):本次向上游供应商支付的估算成本。
  • 用户计费(Charged):本次向用户计算的费用,用于扣减额度。

路由可分别设置用户计费与供应成本倍率;供应商倍率在其有效期内作用于两侧,不改变目录标准价。官方时段与路由时段也应分开维护。保存前查看价格预览,调用后用请求日志核对当次快照。

用户可以按模型设置统一倍率,也可以为同一模型的不同路由组分别设置倍率。具体分组优先,* 用作其余分组兜底;未匹配时保持路由价格。

网关配置 USER_CHARGED_COST_FACTOR_MODE 决定合成方式:

模式作用路由有效倍率 0.8、用户倍率 0.5
multiply(默认)两个倍率相乘最终倍率 0.4
min取两者较小值最终倍率 0.5

最终用户费用基于官方当刻目录价 × 合成后的用户计费倍率。用户折扣不会修改供应成本;字段级规则见 用户 API 与计费语义。

按模型与路由组配置用户倍率

文本与向量通常按 Token;图片按其目录配置使用 Token 或按张计费;音频可能按 Token、时长或字符计费。以所选模型和适配器的实际用量为准。

REST 工具与 MCP 使用自己的标准价和倍率,不套用模型路由时段或用户模型折扣。MCP 当前只按成功工具调用次数计费;REST 搜索按请求,AI 检测按配置的字符单元。

  1. 在用户详情核对周期、永久额度与模型分组倍率。
  2. 用模拟器或真实客户端发一次请求。
  3. 在请求流程的「用量与记账」核对费用,再看账户审计中的两种额度变化。
  4. 调用用户侧 GET /v1/me,确认余额变化符合预期。

用户管理 · 账户审计 · 路由配置