DEEIX Chat 的计费由计费模式、模型单价、多级倍率和独立的工具定价共同决定。这一页说明它们如何叠加、该填哪些字段,以及调用日志里记录了哪些计费快照。
入口位置#
管理端 > 计费。页面按顺序分成几段:
- 计费方式和支付配置
- 兑换码
- 订阅方案
- 模型定价
- 工具定价(官方原生工具)
- MCP 工具定价
调用日志在日志里查看,不在这个页面。
一次费用怎么算出来#
最终倍率由基础单价乘以所有命中的倍率:
基础单价 × 服务倍率 × 权限组倍率 × 时段倍率
顺序如下:
- 按模型的
pricingMode取基础单价:按 Token、按次、按秒或阶梯。 - 叠加供应商服务倍率(Anthropic 快速模式,OpenAI
flex、priority)。 - 当用户的有效权限组命中当前模型时,乘以权限组的计费倍率。多个组命中时取最低倍率。
- 服务器本地时间命中某个时段时,乘以时段倍率。
- 按 Token 和阶梯计费时,根据缓存写计价基准和缓存时长确定缓存写单价。
- 加上按次计费的官方工具和 MCP 工具项。
- 免费模型把模型费用清零;自用模式只记录用量,不扣费。
计费模式#
| 模式 | 作用 | 用户侧 |
|---|---|---|
| 自用模式 | 只记录用量,不涉及购买、充值或套餐扣减。 | 只有用量记录。 |
| 周期计费 | 套餐发放周期额度,调用消耗额度。 | 订阅状态和剩余额度。 |
| 按量计费 | 调用从账户余额扣费。 | 余额和充值。 |
单次预留金额(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: flex | 0.5× |
OpenAI service_tier: priority | 2× |
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 |