# 价格与计费

> Fileverity API 的模型、价格和限制，预付余额及其有效期和退款，免费额度，支出上限，自动充值和余额不足提醒。

来源： https://fileverity.com/zh/docs/pricing

API 采用预付费方式。您为工作区余额充值，每次检测从中扣费。无需订阅，一份余额适用于所有模型。

## 模型与价格

| 模型 | 类型 | 价格 | 输入 | 快照 |
| --- | --- | --- | --- | --- |
| `fvimg-2`（FVIMG V2） | 图片 | 每次图片检测 US$1.99 | jpeg、png、webp；最大 10 MB，最高 4000 万像素 | `fvimg-2-2026-10-30` |
| `fvdoc-3`（FVDOC V3） | 文档 | 每次文档检测 US$5.99 | pdf、docx、doc、rtf、odt、pptx、txt；最大 50 MB，最多 100 页 | `fvdoc-3-2026-11-03` |
| `fvdoc-3-text`（FVDOC V3 Text） | 文本 | 每 1,000 字符 US$0.14 | en、fr、de、es、zh；至少 100 个词，最多 100,000 个字符 | `fvdoc-3-text-2026-11-03` |

价格以美元计，`GET /models` 也会以美分为单位在 `pricing.unit_amount` 中返回。模型 ID 指向其当前快照。将快照 ID 作为 `model` 传入，即可固定请求所用的版本。关于文本的计数方式，参见[文本检测](https://fileverity.com/zh/docs/text-detections.md)。

## 免费额度

您的第一个工作区含 5 次免费图片或文档检测，以及 5,000 个免费文本字符。免费额度每人一次，每个企业邮箱域名的次数有限。一次性邮箱地址不享有免费额度。团队成员应通过邀请加入。免费额度优先于余额使用。使用免费额度的图片或文档检测会返回 `usage.funding: trial` 和 `usage.amount: 0`。超出免费字符的文本字符按正常价格计费。

## 预付余额

- 在控制台的**余额**页充值。最低充值金额为 US$19。收据也在同一位置。
- 创建分析时，其价格会从余额中预留。分析成功后结算。
- 失败的分析、已取消的分析，以及服务在评估之前就拒绝的请求都不收费。预留的金额会被释放。
- 余额不足以支付请求时，API 返回 `insufficient_balance`（HTTP 402）。

> **注意。** 测试密钥不会扣除余额，也不会使用免费额度。

## 支出上限

每个 API 密钥可以设置以整数美元计的每月支出上限，每月 1 日（UTC）重置。只有工作区所有者和管理员可以设置或更改。会超出上限的请求将返回 `spend_limit_reached`，且不收费。参见[身份验证与密钥](https://fileverity.com/zh/docs/authentication.md#spend-limits)。

## 余额不足提醒与自动充值

- **余额不足提醒**：在控制台中设置阈值。余额低于阈值时，所有者和管理员会收到邮件，同时会发送 `balance.low` [Webhook](https://fileverity.com/zh/docs/webhooks.md)。
- **自动充值**：在控制台中保存银行卡，然后选择阈值和金额。余额低于阈值时，会从该银行卡扣款并充入相应金额。如果扣款失败或需要银行确认，自动充值会自行关闭，并向所有者和管理员发送邮件。

## 余额有效期与退款

- **有效期**：余额自工作区最近一次充值起 12 个月内有效，无论是手动充值还是自动充值。每次充值都会延长整笔余额的有效期，而不只是新充入部分。自最近一次充值起 12 个月后仍未使用的余额将过期。
- **提醒**：在到期日前约 30 天，负责账单管理的所有者和管理员会收到一封邮件，说明余额金额和到期日期，并告知任何一次充值都会延长余额的有效期。针对最近一次充值，该邮件只发送一次，且仅在余额大于零时发送。
- **免费额度**：免费额度没有现金价值，不可转让或兑换，也不适用此到期规则。
- **退款**：充值款项概不退款，法律另有规定或书面协议另有约定的除外。失败的检测不收费，预留的金额会自动释放。如果 Fileverity 停止通过控制台和 API 提供付费检测，将退还全部未使用的余额。
- **归属**：余额归其所属工作区所有，不能转移到其他工作区，也不能兑换为网站额度。在网站上购买的额度是单独的产品，适用各自的条款。

价格以美元计，另加适用税费。完整条款参见[服务条款](https://fileverity.com/zh/legal/terms)。

## 查看扣费明细

每次分析以美分为单位在 `usage.amount` 中报告费用。文本检测返回 `usage.billed_units` 和 `usage.free_characters`。控制台提供支出、用量图表和 CSV 导出。