| 1 | # 计费、展示币种与费用报价 |
| 2 | |
| 3 | Reasonix 将三类事实分开： |
| 4 | |
| 5 | 1. `original`：按公开/自定义价表计算的原币估算，不是发票或实际扣款。 |
| 6 | 2. `valuations`：调用发生时记录的 `identity`，以及可用时同模型另一官方区域的 |
| 7 | `official_table` 估算。 |
| 8 | 3. 钱包余额：供应商接口返回的原币事实。 |
| 9 | |
| 10 | 运行时不再下载、缓存或刷新 FX，也不换算钱包。旧 JSON 中的 `fx`、 |
| 11 | `rateSnapshot` 仍可读取为历史估值；新报价永远不会生成它们。 |
| 12 | |
| 13 | ```toml |
| 14 | [billing] |
| 15 | display_currency = "auto" # auto | CNY | USD |
| 16 | |
| 17 | [[providers]] |
| 18 | billing_currency = "USD" # 价表基准币种，不代表实际结算币种 |
| 19 | billing_mode = "payg" # payg | subscription_equivalent |
| 20 | ``` |
| 21 | |
| 22 | 旧 `[desktop].currency` 仍可读并迁移到 `[billing].display_currency`。 |
| 23 | `auto` 在配置层保持未解析：单一有效钱包币种可以成为当前 tab/session 的运行时 |
| 24 | 提示；否则单一原币直接展示，混币则按币种分桶。语言、浏览器 locale、主机区域都不再 |
| 25 | 改变价表。 |
| 26 | |
| 27 | ## CostQuote |
| 28 | |
| 29 | `usage.costQuote` 是所有主机表面的规范 usage 载荷： |
| 30 | |
| 31 | | 字段 | 含义 | |
| 32 | | --- | --- | |
| 33 | | `original` | 原币价表估算 | |
| 34 | | `originalTotals[]` | 混币聚合时按 ISO 排序的原币桶 | |
| 35 | | `valuations.*.basis` | 新报价只有 `identity` 或 `official_table` | |
| 36 | | `selected` | 只有形成单一展示总额时才存在 | |
| 37 | | `costComplete` | usage 与价表事实完整 | |
| 38 | | `displayComplete` | 已形成请求的单币种展示总额 | |
| 39 | | `complete` | 兼容别名，始终镜像 `displayComplete` | |
| 40 | | `displayStatus` | `matched`、`fallback_original`、`bucketed`、`unavailable` | |
| 41 | | `aggregateMode` | `single_currency`、`common_valuation`、`currency_buckets` | |
| 42 | | `rateBand` | DeepSeek 发生时刻档位：`peak`、`off_peak`，聚合时可为 `mixed` | |
| 43 | | `ratedAt` | 用于选择时间费率的请求完成时刻（UTC） | |
| 44 | |
| 45 | 目标币种缺失但所有原币相同时，使用 `fallback_original` 展示原币；混币输出 |
| 46 | `originalTotals`，不写伪造的 0。只有缺少 usage/价格时才是 `unavailable` 并显示 `—`。 |
| 47 | 旧标量别名（`cost`、`costUsd`、`total_cost`）仅在存在 `selected` 时双写。 |
| 48 | |
| 49 | ## DeepSeek 峰谷计价 |
| 50 | |
| 51 | DeepSeek 官方 OpenAI、Responses 与 Anthropic 端点上的 Flash 与 V4 Pro 按请求发生时刻 |
| 52 | 计价。北京时间 09:00–12:00、14:00–18:00 为高峰，区间左闭右开，其余为低峰。由于供应商 |
| 53 | 不提供逐 token 计费时刻，Reasonix 使用取得 usage 的请求完成时刻，并继续把报价标记为估算。 |
| 54 | 发给支持图片的模型的图片按供应商 usage 计入输入 token。 |
| 55 | |
| 56 | 目前记录了两期价目。北京时间 2026-08-17 00:00 起：V4 Flash、 |
| 57 | `deepseek-v4-flash-vision-exp`（价卡与 Flash 相同）和 V4 Pro。北京时间 2026-09-10 12:00 |
| 58 | 起：`deepseek-flash` 采用更低的 Flash 价格，已下线的 `deepseek-v4-flash` 与 |
| 59 | `deepseek-v4-flash-vision-exp` 由该模型承接并按同一价格计费；V4 Pro 在供应商将其路由到 |
| 60 | V4.1 Flash 之前仍按自身价格计费。报价按发生时刻生效的那期价目解析，因此被取代的 8 月 |
| 61 | 价格仍然可查。 |
| 62 | |
| 63 | 配置中保存的价格仍是高峰基准价。只有 PAYG 且完整价格精确匹配某一期官方高峰基准价时才 |
| 64 | 启用动态档位。仍停留在上一期基准价的配置会被识别为未经改动的官方价格，并按**当前**价目 |
| 65 | 计费，因此供应商调价无需用户重新保存配置即可生效。自定义端点、自定义价格和未知模型仍 |
| 66 | 使用静态费率。已经写入 session、ledger、stats 的历史报价不会回填或重算。 |
| 67 | |
| 68 | ## 钱包与诊断 |
| 69 | |
| 70 | 钱包余额不换算、不跨币种求和。显式目标有对应钱包时显示该钱包；没有时显示真实币种 |
| 71 | 并加 ISO 前缀。自动模式只有一个有效钱包币种时才作为运行时费用提示；多钱包、未知币种 |
| 72 | 或请求失败不会影响费用事实。 |
| 73 | |
| 74 | ```sh |
| 75 | reasonix doctor billing |
| 76 | reasonix doctor billing --json |
| 77 | ``` |
| 78 | |
| 79 | 兼容保留的 `fx` 对象固定为 `enabled=false`、无缓存；正文同时展示自动选择策略、价表 |
| 80 | 基准币种和官方目录匹配情况。 |
| 81 |