DEEIX Chat 的计费由计费模式、模型单价、多级倍率和独立的工具定价共同决定。这一页说明它们如何叠加、该填哪些字段,以及调用日志里记录了哪些计费快照。

入口位置#

管理端 > 计费。页面按顺序分成几段:

  1. 计费方式和支付配置
  2. 兑换码
  3. 订阅方案
  4. 模型定价
  5. 工具定价(官方原生工具)
  6. MCP 工具定价

调用日志在日志里查看,不在这个页面。

一次费用怎么算出来#

最终倍率由基础单价乘以所有命中的倍率:

基础单价 × 服务倍率 × 权限组倍率 × 时段倍率

顺序如下:

  1. 按模型的 pricingMode 取基础单价:按 Token、按次、按秒或阶梯。
  2. 叠加供应商服务倍率(Anthropic 快速模式,OpenAI flex、priority)。
  3. 当用户的有效权限组命中当前模型时,乘以权限组的计费倍率。多个组命中时取最低倍率。
  4. 服务器本地时间命中某个时段时,乘以时段倍率。
  5. 按 Token 和阶梯计费时,根据缓存写计价基准和缓存时长确定缓存写单价。
  6. 加上按次计费的官方工具和 MCP 工具项。
  7. 免费模型把模型费用清零;自用模式只记录用量,不扣费。

计费模式#

模式作用用户侧
自用模式只记录用量,不涉及购买、充值或套餐扣减。只有用量记录。
周期计费套餐发放周期额度,调用消耗额度。订阅状态和剩余额度。
按量计费调用从账户余额扣费。余额和充值。

单次预留金额(billing.prepaid_amount_usd)是周期和按量模式下,每个付费调用开始前预留的风险预算,最终仍按真实账单扣费。设为 0 时按剩余槽位动态分配可用预算,最多支持 5 个并发付费调用。请求形状确定后,平台会把预留提高到预估成本,余额不足的请求会在产生任何上游费用前被拒绝。

费用展示币种(billing.display_currency)只控制用户看到的币种。账务、扣费和接口字段仍按 USD / 纳美元记录。美元兑人民币汇率(billing.usd_to_cny_rate)用于人民币展示和人民币支付金额。

模型定价模式#

模式计费依据适用场景
按 Token(token)输入、输出、缓存读、缓存写,按每 1M Token。文本和多模态模型。
按次(call)每次调用固定价格。固定成本的操作。
按秒(duration)按生成秒数计费。仅视频生成模型。
阶梯(tiered)按输入规模命中不同 Token 单价。长上下文或供应商分层价格。

模型还可以标记为免费。免费模型不计模型费用,原生工具计费也会跳过。给不具备视频生成能力的模型设置按秒计费会被拒绝。

Token 与缓存定价#

按 Token 计费有四个独立字段:输入、输出、缓存读、缓存写。缓存定价用于匹配供应商对缓存 Token 的差异化收费。

缓存写计价基准决定配置的缓存写单价如何解释:

基准行为
direct所有供应商都直接使用配置值。
anthropic_5m配置值已包含 5 分钟溢价,1 小时缓存写按 8/5 计算。

基准未设置时,Anthropic 的 5 分钟缓存写按配置值的 5/4 计算,1 小时按 2 倍计算。非 Anthropic 供应商始终使用配置值。用量快照会记录 cache_timeout、cache_write_5m_multiplier 和 cache_write_1h_multiplier,方便事后核对。

服务倍率#

来源倍率
Anthropic 快速模式(speed: fast)6×
OpenAI service_tier: flex0.5×
OpenAI service_tier: priority2×
OpenAI service_tier: priority 且模型属于 GPT-5.5 系列2.5×
权限组计费倍率1–10000 的百分比,100 为原价

权限组倍率在权限组里配置。启用模型访问控制时,平台在用户有效权限组与模型权限组的交集中取最低倍率。0 表示未填写,按 100 处理。

时段倍率#

时段倍率按服务器本地时间在基础单价上叠加百分比,适用于所有定价模式。

  • 一条时段包含名称(不超过 32 字)、一个或多个星期、开始和结束时间,以及倍率。
  • 100 表示原价,120 表示 120%。倍率必须是 1–10000 之间的整数。
  • 结束时间不晚于开始时间表示跨过午夜,星期按开始时间所在的自然日判断。
  • 同一模型的时段不允许重叠,任一时刻最多命中一条,最多 32 条。
  • 结果写入计费快照的 schedule_period_name 和 schedule_rate_percent,并在调用日志中展示。

阶梯定价#

阶梯定价按输入规模命中不同的 Token 单价。每一档有 Token 上限(upToTokens)以及输入、输出、缓存读、缓存写单价。填写完整 Token 数,最后一档填 0 表示不限量。最多 100 档,每一档的上限必须大于前一档。

阶梯按输入侧总量匹配:输入 Token + 缓存读 Token + 缓存写 Token。快照记录 tiered_from_tokens 和 tiered_up_to_tokens。

官方工具计费#

打开工具定价。原生工具计费(billing.native_tool_billing_enabled)默认开启。

  • 价格按次计算。填 0 表示仍然记录用量,但不计费。
  • 只有成功执行的调用会计费,失败调用不计费。
  • 自用模式只记录用量。
  • 免费模型免除原生工具计费,但 MCP 工具计费不豁免。
  • 工具周围的模型 Token 仍按模型定价计算。
  • 上游没有返回调用次数时,不会生成工具费用。

MCP 工具定价在MCP 工具定价里单独配置。MCP 调用属于外部上游成本,所以免费模型也不豁免。

订阅方案#

一个套餐包含名称、说明、价格、周期(月、年、永久)、周期用量额度和权限组。订阅该套餐的用户自动获得权限组的模型访问权限。套餐用稳定的 code 标识;内置的 free 套餐不能作为兑换奖励。

续费、升级和切换会生成订阅权益队列。新权益可能立即生效,也可能排在已有权益之后,取决于已有权益的结束时间。

兑换码#

兑换码可以发放余额(usage)或套餐权益(period)。在兑换码里创建。

字段说明
兑换码3–64 位字母、数字、连字符或下划线。留空则生成 UUID。手动填写的码只能创建一次。
数量每批 1–100 个。
计费模式usage 或 period,必须与当前平台模式一致。
兑换金额usage 模式下必须大于 0。
套餐period 模式下必须选择启用中的非免费套餐。
有效天数period 模式下必须大于 0,最大 3660。
总次数上限正整数,留空表示不限。
单用户上限1–100,且不能大于总次数上限。
过期时间必须晚于当前时间。
说明自由文本。

平台处于自用模式时兑换码不可兑换,且兑换码只在自身模式下生效。兑换码删除后仍保留历史兑换记录。

计费快照与调用日志#

价格变更只影响后续调用。每次调用都会写入一份快照,记录当时实际应用的单价和倍率,历史账单因此仍可解释。日志的用量详情里可以看到这些字段:

分组字段
身份platform_model_name、model_vendor、provider_protocol、upstream_name、upstream_model_name、routed_binding_code
模式billing_mode、pricing_mode、service_only、is_free_model、currency
倍率rate_multiplier、billing_service_tier、fast_mode、schedule_period_name、schedule_rate_percent
缓存cache_timeout、cache_write_5m_multiplier、cache_write_1h_multiplier
单价input_nanousd_per_m_tokens、cache_read_nanousd_per_m_tokens、cache_write_nanousd_per_m_tokens、output_nanousd_per_m_tokens、call_nanousd_per_call、duration_nanousd_per_second
阶梯tiered_pricing_json、tiered_from_tokens、tiered_up_to_tokens
计费金额input_billed_nanousd、cache_read_billed_nanousd、cache_write_billed_nanousd、output_billed_nanousd、call_billed_nanousd、duration_billed_nanousd
工具server_side_tool_usage、native_tool_billing_enabled、native_tool_billed_nanousd、mcp_tool_usage、mcp_tool_billed_nanousd、service_items

核对账单时打开用量详情看快照,不要只对比当前价格表。

导入导出模型定价#

导入和导出用 JSON 交换模型价格。根节点是以平台模型名为 key 的对象:

json

规则:

  • pricingMode 必须是 token、call、duration 或 tiered。
  • duration 只对视频生成模型有效。
  • 阶梯计费可以使用 tieredPricing 对象或 tieredPricingJSON 字符串。
  • 时段倍率可以使用 schedulePricing 对象或 schedulePricingJSON 字符串,时段不能重叠。
  • cacheWritePriceBasis 取 direct 或 anthropic_5m。
  • 出现未知的平台模型名时整次导入会被拒绝。

常见问题#

现象原因处理方式
付费调用还没开始就被拒绝预留金额高于剩余余额或周期额度。调低 billing.prepaid_amount_usd,或先充值。
模型没有产生费用模型被标记为免费、计费模式是自用模式,或没有配置价格。检查免费状态、计费模式和模型价格。
费用高于价格表服务倍率、权限组倍率或时段倍率放大了基础价。在快照里看 rate_multiplier、schedule_rate_percent、billing_service_tier。
相近 Token 量费用不同缓存读、缓存写或缓存时长不同。对比快照里的 cache_* 字段和 cache_write_*_multiplier。
工具调用没有计费计费关闭、价格为 0、模型免费,或上游没有返回次数。检查工具定价和快照里的 server_side_tool_usage。
兑换码无法兑换模式不匹配,或兑换码已停用、过期、用尽。对照当前计费模式检查兑换码的模式和状态。

参考#

项目配置键或字段
计费模式billing.mode(self、period、usage)
单次预留金额billing.prepaid_amount_usd
费用展示币种billing.display_currency(USD、CNY)
美元兑人民币汇率billing.usd_to_cny_rate
原生工具计费billing.native_tool_billing_enabled、billing.native_tool_pricing_json
支付渠道billing.payment_providers、billing.stripe_publishable_key、billing.stripe_secret_key、billing.stripe_webhook_secret、billing.epay_gateway_url、billing.epay_types、billing.epay_pid、billing.epay_key
模型定价接口platformModelName、currency、isFree、pricingMode、inputUSDPerMTokens、cacheReadUSDPerMTokens、cacheWriteUSDPerMTokens、cacheWritePriceBasis、outputUSDPerMTokens、callUSDPerCall、durationUSDPerSecond、tieredPricingJSON、schedulePricingJSON

相关页面#