Fileverity API 文档
价格与计费
Fileverity API 的模型、价格和限制，预付余额及其有效期和退款，免费额度，支出上限，自动充值和余额不足提醒。
查看 Markdown更新于 2026-11-04
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 传入，即可固定请求所用的版本。关于文本的计数方式，参见文本检测。
免费额度
您的第一个工作区含 5 次免费图片或文档检测，以及 5,000 个免费文本字符。免费额度每人一次，每个企业邮箱域名的次数有限。一次性邮箱地址不享有免费额度。团队成员应通过邀请加入。免费额度优先于余额使用。使用免费额度的图片或文档检测会返回 usage.funding: trial 和 usage.amount: 0。超出免费字符的文本字符按正常价格计费。
预付余额
- 在控制台的余额页充值。最低充值金额为 US$19。收据也在同一位置。
- 创建分析时，其价格会从余额中预留。分析成功后结算。
- 失败的分析、已取消的分析，以及服务在评估之前就拒绝的请求都不收费。预留的金额会被释放。
- 余额不足以支付请求时，API 返回
insufficient_balance（HTTP 402）。
测试密钥不会扣除余额，也不会使用免费额度。
支出上限
每个 API 密钥可以设置以整数美元计的每月支出上限，每月 1 日（UTC）重置。只有工作区所有者和管理员可以设置或更改。会超出上限的请求将返回 spend_limit_reached，且不收费。参见身份验证与密钥。
余额不足提醒与自动充值
- 余额不足提醒：在控制台中设置阈值。余额低于阈值时，所有者和管理员会收到邮件，同时会发送
balance.lowWebhook。 - 自动充值：在控制台中保存银行卡，然后选择阈值和金额。余额低于阈值时，会从该银行卡扣款并充入相应金额。如果扣款失败或需要银行确认，自动充值会自行关闭，并向所有者和管理员发送邮件。
余额有效期与退款
- 有效期：余额自工作区最近一次充值起 12 个月内有效，无论是手动充值还是自动充值。每次充值都会延长整笔余额的有效期，而不只是新充入部分。自最近一次充值起 12 个月后仍未使用的余额将过期。
- 提醒：在到期日前约 30 天，负责账单管理的所有者和管理员会收到一封邮件，说明余额金额和到期日期，并告知任何一次充值都会延长余额的有效期。针对最近一次充值，该邮件只发送一次，且仅在余额大于零时发送。
- 免费额度：免费额度没有现金价值，不可转让或兑换，也不适用此到期规则。
- 退款：充值款项概不退款，法律另有规定或书面协议另有约定的除外。失败的检测不收费，预留的金额会自动释放。如果 Fileverity 停止通过控制台和 API 提供付费检测，将退还全部未使用的余额。
- 归属：余额归其所属工作区所有，不能转移到其他工作区，也不能兑换为网站额度。在网站上购买的额度是单独的产品，适用各自的条款。
价格以美元计，另加适用税费。完整条款参见服务条款。
查看扣费明细
每次分析以美分为单位在 usage.amount 中报告费用。文本检测返回 usage.billed_units 和 usage.free_characters。控制台提供支出、用量图表和 CSV 导出。