# 计费与退款

对话、图片、视频分别怎么计费，预扣怎么结算，什么情况不扣费，怎么查消费、充值和退款。

> https://docs.kovapi.com/guide/billing

## 积分

账户余额用积分表示，1 美元 = 200 积分。价格页和文档里的价格都用美元标注，扣费时按这个比例换算成积分。接口 `/v1/usage` 同时返回美元余额和积分。

## 三类模型怎么算钱

| 类别 | 计费单位 | 说明 |
| --- | --- | --- |
| **对话** | 按 token：输入和输出分别计价（美元 / 百万 token） | 缓存命中按更低的缓存读价格计；思考 token 按输出价计。 |
| **图片** | 按张，按分辨率档位（1K / 2K / 4K）计价 | 按实际交付的张数计费，失败的不收。 |
| **视频** | 大多按秒（单价 × 时长），少数型号按条 | 每个型号是按秒还是按条，在价格页和它的文档里写明。 |

[各模型价格 →](https://kovapi.com/pricing)

## 对话的细节

- `usage.prompt_tokens` 是输入，`usage.completion_tokens` 是输出；缓存命中的部分单独按缓存读价格计费。

- 思考型模型的思考 token 计入输出，按输出价计费，不管你读不读思考内容；多数模型会在 `usage.completion_tokens_details.reasoning_tokens` 里给出思考用了多少 token。

- 流式输出中途断开时，按断开前已经产生的用量结算，不会按完整回答收费。

- Claude 的提示缓存还有「缓存写入」价格，每个模型的缓存读、缓存写价格在它的文档和价格页里。

## 预扣与结算

- 每个请求开始前先按预估预扣积分，余额不够直接返回 402 `insufficient_quota`，不会调用模型。

- 对话按实际用量结算，多扣的预扣退回；图片按实际交付的张数结算；视频按下单的时长或条数结算，和预扣一致。

- 同时在跑的请求越多，被预扣的积分越多；余额紧张时可能因为预扣不够返回 402，等前面的请求结算后就恢复。

## 失败不扣费

任何失败的请求都不扣费：上游出错、超时、内容审核拒绝、网关错误都一样。异步任务失败时，预扣的积分自动全额退回，原因写在调用日志里。

## 由其他模型代答时

部分对话模型暂时不可用时，网关可能改由其他模型代为作答，让请求不至于失败。这时按两个模型中较低的价格计费，调用日志会写明由哪个模型作答、按哪个价格计费。

## 查看消费

- 控制台「调用日志」：近 60 天的每一次调用，模型、耗时、用量、扣费，失败的会写明原因。

- 控制台「用量」：按天、按模型、按 Key 汇总，可以导出 CSV。

- 程序里：`GET /v1/usage` 返回余额、总消费、今日消费和按模型的用量，详见 [API 手册](https://docs.kovapi.com/api#balance)。

## 充值与退款

在控制台「账单」页充值：微信最低 ¥10（260 积分），USDT 和银行卡最低 $5。积分不过期。注册和首充的赠送规则见 [常见问题](https://kovapi.com/faq#credits-expire)。

充值后 7 天内，未使用的充值积分可以联系客服退款，每笔扣手续费（2026 年 10 月 29 日起的充值 $1.40，之前的充值 $0.40）；赠送的积分不退。USDT 支付同样可以退。

## USDT 充值

在控制台「账单」页选 USDT、套餐和链，会生成一张付款单，上面写着网络、要转的精确金额和收款地址。按这三项转一笔账，链上确认后积分自动到账，通常几分钟。

- **选哪条链**：默认是 **BEP20**，交易所里叫 **BSC / BNB Smart Chain**，提币手续费最低（币安参考约 0.01 USDT），扫码后要手动选这个网络，别选 ETH、opBNB。**Solana**：用币安、欧易扫码会自动选好网络，但提币手续费较高（币安参考约 0.3 USDT）。**TRC20**（交易所里选 TRX · Tron）手续费最高（币安参考约 1.5 USDT）。务必用付款单上写的那条链，转到别的链上的钱无法追回。

- **金额要分毫不差**：同一条链的订单共用一个收款地址，系统靠精确到小数位的金额认出是哪一笔，所以到账金额必须正好等于付款单上的数字，多了少了都不会自动入账。

- **手续费从你填的数里扣**：从交易所提币时，提币手续费是从你输入的数量里扣的，所以要看「到账数量 / Recipient receives」那一栏，让它正好等于付款单上的金额。在币安，可以点「到账数量」旁边的 ⇆，直接输入到账数量。

- **付款单 60 分钟内有效**：请在有效期内转账；过期后再转的钱不会自动入账，请重新下单。

- **付了没到账**：请不要重复付款。联系我们，带上订单号（在付款单底部）和转账哈希（TxID），我们会人工核对入账，通常一小时内处理完。