跳至正文

Fileverity API

在代码或浏览器中,检测图片、文档和文本中的 AI 生成与篡改。

面向理赔、信贷、人力资源和在线平台团队。每次图片或文档检测都会返回完整的证据报告,包含风险等级、建议措施和任何人都能核验的记录;每次文本检测返回带评分的结果。您可以在浏览器中使用,也可以从自己的软件中调用。

免费开始阅读文档

免费额度:5 次图片或文档检测和 5,000 个文本字符。无需绑卡,无需订阅。

概览

基础 URL
https://api.fileverity.com/v1
身份验证
Bearer API 密钥,Live 或 Test
格式
基于 HTTPS 的 JSON
速率限制
每个密钥每分钟 120 次请求
图片和文档
先上传文件,再发起检测。通过 Prefer: wait 或 Webhook 获取结果。

两种使用方式

同样的检测,可在浏览器里用,也可在代码里用。

两种方式共用同一个工作区、同一份预付余额和同样的报告。按实际操作的人来选择即可。

在浏览器中

控制台

用 Fileverity 账号登录,充值后即可检测文件,无需写代码。

  • 检测图片和文档,或直接粘贴文本
  • 查看历史检测、余额和发票
  • 团队准备好后再创建 API 密钥

在代码中

API

向 api.fileverity.com 提交文件和文本,获得结构化结果。

  • 区分 Live 与 Test 模式的 Bearer 密钥
  • 文本结果随响应直接返回;文件可等待结果或通过 Webhook 通知
  • 提供 OpenAPI 3.1 规范

团队在哪里使用

在每个与文件相关的决定之前,先做一次检测。

可以检测什么

图片、文档和文本。

每次检测都返回结构化 JSON。图片和文档检测返回的报告与网站相同,文本检测返回检测结果。

选择检测类型

选择与您的文件相匹配的检测。

图片和文档需要两次调用,返回完整报告;文本只需一次调用,返回检测结果。一个密钥、一份余额即可覆盖三种检测。

图片、文档和文本检测在模型、输入、输出、价格、接口和返回方式上的对比
检测类型模型 ID您提交您得到价格接口结果返回方式
图片检测fvimg-2JPEG、PNG 或 WebP 图片完整报告,含检测发现、标记区域和报告编号每张图片 1.99美元POST /v1/files, POST /v1/analyses等待结果,或通过 Webhook 接收
文档检测fvdoc-3PDF、Word 或其他文档文件完整报告,含检测发现、被标记段落和报告编号每份文档 5.99美元POST /v1/files, POST /v1/analyses等待结果,或通过 Webhook 接收
文本检测fvdoc-3-text至少 100 个词的纯文本检测结果,含判定、分数和 AI 撰写的段落每 1,000 字符 0.14美元POST /v1/text/detections在同一次响应中返回
  • FVIMG V2

    图片

    fvimg-2POST /v1/files, POST /v1/analyses

    检测 AI 生成与局部编辑,并读取水印、内容凭证(Content Credentials)和 AI 标识。

    返回内容

    • 按证据类别给出的发现
    • 在支持时标出可疑区域和可能的生成器
    • 报告编号、指纹、时间戳和核验页
  • FVDOC V3

    文档

    fvdoc-3POST /v1/files, POST /v1/analyses

    检查 PDF 和 Word 文件中的改动、前后不一致、AI 撰写的文本、内嵌照片和文件历史。

    返回内容

    • 涵盖文本、照片和文件记录的发现
    • 被标记的段落及其页码
    • 报告编号、指纹、时间戳和核验页
  • FVDOC V3 Text

    文本

    fvdoc-3-textPOST /v1/text/detections

    将纯文本判定为 AI 撰写、混合或人类撰写,并标出其中由 AI 撰写的段落。

    返回内容

    • 判定结果:ai、mixed 或 human
    • 分数及文本中 AI 撰写部分的占比
    • 以字符偏移量表示的段落位置

您将获得什么

一份可以据以行动的报告,而不只是一个分数。

每次图片和文档检测都会返回完整报告:风险等级、支撑它的证据、建议的下一步,以及任何人都能核验的记录。

图片报告样例FV-7K2M-9Q4X-RT8N
综合评估
照片存在局部改动
风险等级
L4高度可疑
处置建议
依赖该图片前先人工复核

关键证据

  1. E1R1:被编辑区域,中等信号
  2. E2压缩历史:发现异常
  3. E3文件中无内容凭证
报告数据哈希值
sha256:3f9a7c1e…b8d4e21c
第三方时间戳
DigiCert · RFC 3161
fileverity.com/verify
文档报告样例FV-3H8D-K2QW-6NZC
检测结论
部分段落呈现 AI 撰写特征
被标记段落
  • P1第 3 页,第 3 段
  • P2第 3 页,第 4 段
处置建议
请复核被标记段落。向提交方了解文档的撰写过程,并索取原始电子文件。

文件信息

  1. E1文件记录了创建软件
  2. E2未发现 AI 生成内容标识或内容凭证
  3. E3未发现隐藏字符或形近字符
报告数据哈希值
sha256:a41d09e7…5c2f80b3
第三方时间戳
DigiCert · RFC 3161
fileverity.com/verify

文本检测则返回检测结果:判定、分数,以及看起来由 AI 撰写的段落。

价格

按每次检测付费。

从 19美元 起,充值任意金额,可用于任意组合的图片、文档和文本检测。一次付款,无需订阅,不会自动续费。

API 与控制台价格
检测类型价格
图片检测计费单位 每张图片1.99美元
文档检测计费单位 每份文档5.99美元
文本检测计费单位 每 1,000 字符0.14美元

每次请求中的文本按 1,000 字符向上取整计费。文本检测至少需要 100 个词。

免费额度

先试用,再充值。

您的第一个工作区包含 5 次免费图片或文档检测,以及 5,000 个免费文本字符。

开始时无需绑卡。每人一次免费额度,每个企业邮箱域名的次数有限,同事请通过邀请加入工作区。

计费方式

  1. 01 / 03

    充值

    用银行卡为工作区余额充值,从 19美元 起任意金额。这是一次性付款,不是订阅。

  2. 02 / 03

    运行检测

    每次检测完成后扣除标价费用。工作区内所有成员在控制台和 API 中使用同一笔资金。失败的检测不收费。

  3. 03 / 03

    查看发票

    每笔充值都会在控制台生成一张 Stripe 发票,企业客户可以在结账时填写税号。

价格以美元计。适用税费由 Stripe 在结账时计算。检测失败不收费。

支出控制

随时掌控您的支出。

花了多少一目了然。不会自动续费,也不会在后台扣款。

  • 余额不足提醒

    默认开启。余额用尽前,工作区所有者和管理员会收到邮件。

  • 自动充值

    可选。当余额低于您设定的水平时,从已保存的银行卡自动充值。

  • 按密钥设置支出上限

    为每个 API 密钥设置每月支出上限,避免单个集成用光整个余额。

安全与数据处理

文件分析后删除,文本不留存。

API 的数据处理方式与网站一致。

  • 上传的文件在分析后删除,也不会用于训练模型
  • 提交的文本不会被存储
  • 结果保留 7 天,期间可再次获取
  • 密钥在控制台中创建和撤销,请求日志会显示每个密钥的使用情况
  • Webhook 带有签名,遵循 Standard Webhooks 规范
  • 可按需提供数据处理协议(DPA)

为可追溯而设计

每份图片和文档结果事后都可以复核。

图片和文档结果附带的证据记录,与网站报告一致。

  • 报告编号

    把报告编号与您自己的案件或客户记录一并保存。

  • 指纹与时间戳

    每份报告都会记录 SHA-256 指纹和 RFC 3161 时间戳。

  • 公开核验页

    收到报告编号的人无需账号,即可在核验页确认报告。

  • OpenAPI 3.1

    API 以公开的 OpenAPI 文档描述,您可以据此生成客户端并校验响应。

面向开发者

先用测试密钥开发。

密钥是 Bearer 令牌,在控制台中创建。请保存在您的服务器上。

Authorization: Bearer fv_test_…
  • fv_test_…

    返回固定的示例结果,永不扣费。适合开发阶段和自动化测试。

  • fv_live_…

    执行检测,并从工作区余额中扣费。

  • 在 Authorization 请求头中以 Bearer 令牌发送密钥
  • Live 与 Test 密钥调用相同的接口
  • 随时可在控制台中撤销密钥

常见问题

使用前需要写代码吗?

不需要。在控制台中即可充值,并在浏览器里检测图片、文档和文本,登录账号与网站相同。API 则用于从您自己的系统发起检测。

可以免费试用吗?

可以。您的第一个工作区包含 5 次免费图片或文档检测,以及 5,000 个免费文本字符,无需绑卡。免费额度每人一次,每个企业邮箱域名的次数有限,因此请邀请同事加入您的工作区,而不是各自注册。测试密钥返回固定的示例结果且永不扣费,因此可以先完成集成。

结果有多准确?

结果是供人工复核的证据,而不是定论。每份报告都会说明证据有多强、哪些内容无法检查,以及下一步该怎么做。这些问题下方链接的准确性指南解释了如何解读结果,以及误报从何而来。

这与网站上的额度是同一笔余额吗?

不是。控制台和 API 使用的工作区余额,与您在网站上购买的额度相互独立。网站额度只适用于您在 fileverity.com 上运行的报告。

会提供发票吗?可以填写税号吗?

会。每笔充值都附有发票,企业客户可以在结账时填写税号。适用税费由 Stripe 根据您的账单地址计算。

如何避免余额用完?

余额不足提醒默认开启,并会发送邮件给工作区所有者和管理员。开启自动充值,即可从已保存的银行卡充值,还可以为每个 API 密钥设置每月支出上限。

检测失败或余额用完会怎样?

检测失败不收费。余额不足以支付一次检测时,请求会返回 insufficient_balance,且不会扣费,充值后即可继续。

工作区余额会过期吗?可以退款吗?

余额自您最近一次充值起 12 个月内有效,每次充值都会延长整笔余额的有效期。充值款项除法律要求或您的协议另有规定外,概不退款。

结果会在同一次请求中返回吗?

文本结果直接随响应返回。图片和文档检测分两步:先上传文件,再发起检测。发送 Prefer: wait 可在同一次请求中等到结果,也可以使用 Webhook,在结果就绪时收到通知。

文本检测支持什么内容?

支持英语、法语、德语、西班牙语和中文的纯文本,每次请求从 100 个词到 100,000 个字符。未指定语言时会自动识别。

文件和结果会保存多久?

上传的文件在分析后删除,提交的文本不存储,结果保留 7 天。

是否提供数据处理协议?

提供。数据处理协议可按需提供,企业版已包含。

什么时候需要企业版?

需要批量价格、私有化部署(本地或完全离线)或定制集成时。其他需求都可以自助完成。

企业版

批量价格、私有化部署、定制集成。

面向高用量和严格内部规范的团队,我们按您的用量报价,把 Fileverity 部署在您自己的服务器或完全离线环境,并按需开发集成。

几分钟内完成第一次检测。

打开控制台,用免费额度发送一次测试请求。准备好获取 Live 结果时再充值。