文档
计费
从预付钱包按量付费。每次调用都会精确计量到微美分，并记入不可变账本。无需订阅或承诺，余额永不过期。
通过 Stripe 充值 → 余额存入钱包 → 每次 API 调用实时扣除相应费用。余额降至零时，调用会返回 402 insufficient_quota，直到再次充值。
计价方式
对于每次调用，Kunavo 会取以下两个数值中较大的一个作为用户费用：
- 目录成本 — 模型卡上显示的价格（每 1M token、每张图像、每秒视频等）× 实际用量。
- 上游成本 — 上游提供方就该次具体调用向 Kunavo 收取的费用，以额度计价，其中 1 credit = $0.005。
- 加价系数 — 通常为
1.5（在上游成本基础上加价 50%）。对于部分中国供应商的模型，由于上游批发价格更接近供应商的官方价格，系数会降至1.2，以确保我们的价格低于官方价格。
max() 可确保：(a) 你的支付金额不会低于公布的目录价格；(b) 当上游成本意外飙升时，我们不会因该次调用而亏损。
各模态的计费单位
| 模态 | 单位 | 粒度 |
|---|---|---|
| 聊天 | 每 1M 输入 token + 每 1M 输出 token | 精确到 token；推理 token 按输出费率计费。 |
| 图像（t2i / 编辑） | 每张图像 | 按每张生成的图像计费；未完成的生成不收费。 |
| 视频 | 每段视频 | 每段视频采用固定价格，按分辨率档位计价。 |
长提示会按提供方的长上下文档位计费。对于 GPT-5.5、GPT-5.6 Sol 和 Terra，以及 GPT-6 Astra，当提示的输入 token 超过 272K 时，整个请求都按 2× 输入价格计费 — 包括缓存读取和写入 — 输出则按 1.5× 计费，这是 OpenAI 公布的档位。Claude 不收取长上下文附加费：其 1M 上下文按标准价格计费。
缓存 token
聊天模型会缓存稳定的提示前缀。缓存读取费用远低于普通输入费率 — Claude 和 OpenAI 均为 0.10×，以及 0.025× on Claude Fable 5.1, 0.05× on Claude Opus 5.5。所有 Claude 模型的缓存写入均按 1.25× 输入价格计费，包括 1 小时 TTL 的写入（低于 Anthropic 的 2×）；GPT-5.6 Sol、Terra 和 Luna，以及 GPT-6 Astra 也采用这一价格；其他所有模型则按普通输入费率计费。每种类别均采用该模型自身的折扣，因此缓存价格相对提供方标价享有与输入和输出相同的折扣。上文的 max() 下限已考虑缓存因素，因此折扣会实际反映到你的费用中，不会被目录价格抵消。
完整价格表、如何启用 cache_control，以及 Kunavo 的亲和路由如何保持缓存热状态，请参见提示缓存指南。
精度
Kunavo 的所有金额均以 micro_cents 存储：
1 USD = 100,000,000 micro_cents1 cent = 1,000,000 micro_cents- 最低可计金额：
0.0001 cent（$0.000001）。实际聊天调用经常按此最低金额计费。
控制面板以美元（USD）显示金额：小额金额四舍五入到小数点后 6 位，超过美分级别后四舍五入到小数点后 2 位。内部记账精确无误差。
充值
通过 Stripe Checkout 在 /app/billing 为钱包充值：Stripe 覆盖的地区均支持银行卡（Visa、Mastercard、Amex、JCB、UnionPay），除印度外的所有地区均支持 Apple Pay、Google Pay 和 Link。按买家所在市场提供受国家限制的支付方式——美国支持 Cash App Pay、Klarna、Afterpay、ACH 银行借记（3–5 个工作日结算）和加密货币（稳定币），充值金额达到 $100 时还支持 Affirm，充值金额为 $100 至 $1,500 时支持 Zip；中国大陆支持 Alipay 和 WeChat Pay；韩国支持 KakaoPay、Naver Pay、PAYCO、Samsung Pay 以及韩国本地银行卡；印度支持 UPI；巴西支持 Pix；荷兰支持 iDEAL，比利时支持 Bancontact，奥地利支持 EPS，葡萄牙支持 MB WAY，意大利支持 Satispay；波兰支持 BLIK；英国支持 Bacs Direct Debit；英国、爱尔兰和芬兰的买家支持 Pay by Bank。
分档定价
| 充值 | 你可享有 | 额外奖励 |
|---|---|---|
| $10 | $10.00 | — |
| $100 | $110.00 | +$10 (10%) |
| $1,000 | $1,200.00 | +$200 (20%) |
| $5,000 | $6,250.00 | +$1,250 (25%) |
/app/keys 中为每个 API 密钥设置月度支出限额，为单个工作负载设定硬性上限：如果该密钥在自然月的支出将超过你设置的金额，其调用就会被拒绝并返回 402 insufficient_quota，且不产生任何费用。其他密钥仍可正常使用。同一页面还可为每个密钥设置 IP 允许列表 — 从其他地址发出的调用会返回 403。自动充值
可选功能。在 /app/billing 保存一次银行卡，并设置三个数值：触发充值的余额下限、每次充值金额，以及月度上限。之后钱包会自动补充余额 — 在结算导致余额低于阈值后的几秒内完成充值；如果在此期间有请求因余额不足而被拒绝，则会在答复该请求之前完成充值 — 这样，无人值守的智能体就不会因 402 而停止运行。
| 设置 | 范围 | 备注 |
|---|---|---|
| 触发余额 | $5 – $1,000 | 设置为高于你的最大单次请求金额。 |
| 每次充值金额 | $10 – $1,000，整数美元 | $100 和 $1,000 享有与手动充值相同的奖励；其他金额不享有奖励。 |
| 月度上限 | 每次充值金额 – $20,000 | 按每个自然月的扣费金额计算，不含奖励金额。 |
KUNAVO* AUTOTOPUP。自动充值正在处理期间，被拒绝的请求会收到带有 Retry-After: 3 的 402；其他所有拒绝响应都会说明下一步操作。你可以随时在同一页面关闭自动充值或修改数值。
Webhook 触发时间
完成 Stripe Checkout 后，余额会通过 webhook 更新。付款确认后，webhook 通常会在 5–10 秒内触发。银行卡支付几乎会立即到账；仅能异步确认的支付方式可能需要数天才能结算。这些订单在资金到账前会显示为 processing，结算 webhook 会在资金到账时为钱包入账 — 无需再次付款，也不会有任何内容在等待期间过期。未完成的订单会显示为 pending，我们的清理任务会在 24 小时后将其标签改为 expired；该标签仅用于显示，不会取消任何内容。
额度账本
每次余额变动都会记入仅追加的账本：
| 类型 | 方向 | 何时 |
|---|---|---|
| topup | 增加额度 (+) | Stripe 付款已确认。 |
| consume | 扣减额度 (−) | API 调用完成后计费。 |
| refund | 增加额度 (+) | Stripe 退款或管理员手动添加额度。 |
| manual_ | 额度变动 (+/−) | 运营人员调整（例如事故退款）。 |
每一行都会记录 balance_after_micro_cents，提供对应事件发生时的快照。请在 /app/billing 查看完整历史记录。
用量日志
每次 API 调用都会在 usage_logs 中生成一条记录：
- 模型、状态（成功 / 错误）、HTTP 状态码
- 输入 / 输出令牌、缓存及写入缓存的令牌数、图像数量、秒数、字符数
upstream_cost_micro_cents— Kunavo 向上游支付的费用cost_micro_cents— 您支付的费用（加价后）- 延迟、请求 IP、用户代理、API 密钥前缀
可在 /app/usage 查看，并使用筛选条件和逐次调用的详细信息页面。
失败的调用会产生费用吗？
不会。 Kunavo 只会在 status = success 时收费。如果上游返回 4xx / 5xx，或我们的任务超时，系统会记录此次调用，但费用为 $0。我们自行承担上游费用，不会将其转嫁给您。
退款
退款会由 support@kunavo.com 按具体情况处理。以下是常见的退款情形：
- Kunavo 方面的服务中断导致您损失了预算。
- 定价错误导致实际收费高于目录中显示的价格。
- 通过 Stripe 意外重复充值。
默认以额度形式退还至您的钱包；您也可以提出申请，通过 Stripe 退款至银行账户。