Chuyển đến nội dung chính

API phát hiện gian lận tài liệu

API phát hiện gian lận tài liệu cho tệp PDF và Word.

Kiểm tra tệp PDF và Word để phát hiện chỉnh sửa, giả mạo và văn bản do AI viết qua hai lệnh gọi API. Báo cáo có thể xác minh, 5,99 USD mỗi tài liệu.

Dùng thử miễn phíĐọc tài liệu

Lượt dùng thử miễn phí: 5 lượt kiểm tra ảnh hoặc tài liệu và 5.000 ký tự văn bản. Không cần thẻ, không có gói đăng ký.

Tóm tắt nhanhfvdoc-3
Endpoint
POST /v1/files, POST /v1/analyses
Mô hình
fvdoc-3 · FVDOC V3
Tệp được chấp nhận
PDF, DOCX, DOC, RTF, ODT, PPTX, TXT
Dung lượng tối đa
Tối đa 50 MB và 100 trang
Kết quả
Nhận ngay trong cùng yêu cầu, hoặc qua webhook
Giá
5,99 USD mỗi lượt kiểm tra tài liệu

Cập nhật lần cuối

Những gì được kiểm tra

Những gì lượt kiểm tra tài liệu phân tích.

Mỗi dấu hiệu là một phần của cùng báo cáo bạn nhận được trong Console. Cột trường phản hồi cho biết nơi đọc dấu hiệu đó.

Các dấu hiệu được lượt kiểm tra tài liệu phân tích và các trường phản hồi chứa chúng
Dấu hiệuNội dung được kiểm traTrường phản hồi
Lịch sử chỉnh sửa và cấu trúc tệpCác bản sửa đổi đã lưu, các trang bị thay đổi hoặc thêm vào, và cách tệp được tạo nên.structure
Chữ ký và thông tin ghi trong tệpChữ ký số, thông tin về thời điểm tạo và sửa đổi, và phần mềm được ghi trong tệp.provenance
Ảnh nhúngCác ảnh bên trong tài liệu, mỗi ảnh được kiểm tra xem có do AI tạo ra hoặc bị chỉnh sửa cục bộ hay không.images
Văn bản do AI viếtKết luận cho phần văn bản của tài liệu, với các đoạn do AI viết được đánh dấu theo trang. Chỉ đánh giá văn bản bằng tiếng Anh, tiếng Pháp, tiếng Đức, tiếng Tây Ban Nha hoặc tiếng Trung.text
Phát hiện và bước tiếp theoCác phát hiện đằng sau mức độ rủi ro, mức độ mạnh của từng phát hiện và hành động khuyến nghị.findings, level, action

Yêu cầu và phản hồi

Hai lệnh gọi, một báo cáo.

Tải tệp lên, sau đó tạo lượt kiểm tra với mô hình fvdoc-3. Gửi Prefer: wait để giữ yêu cầu cho đến khi báo cáo sẵn sàng. Tài liệu có thể phải xếp hàng chờ, nên một lượt kiểm tra có thể trả về mã 202 với trạng thái processing. Hãy lấy kết quả sau hoặc nhận webhook.

Yêu cầuPOST /v1/files, POST /v1/analyses
FILE_ID=$(curl -s https://api.fileverity.com/v1/files \  -H "Authorization: Bearer $FILEVERITY_API_KEY" \  -F file=@contract.pdf | jq -r .id) curl https://api.fileverity.com/v1/analyses \  -H "Authorization: Bearer $FILEVERITY_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Prefer: wait=60" \  -d "{\"model\": \"fvdoc-3\", \"file\": \"$FILE_ID\"}"
Phản hồi200 OK
{  "id": "an_Zc4vB7nP1sK8tL3wR6yQm2Xa",  "object": "analysis",  "created": 1793700300,  "model": "fvdoc-3-2026-11-03",  "livemode": true,  "status": "succeeded",  "file": {    "name": "contract.pdf",    "bytes": 18874368,    "format": "pdf"  },  "report_id": "FV-3PXH-6WQ2-8NDC",  "report_url": "https://fileverity.com/verify/FV-3PXH-6WQ2-8NDC",  "summary": {    "kind": "docpro",    "level": "L3",    "action": "review",    "reason": null,    "findings": [],    "pages": 12,    "images": 3,    "text": "human"  },  "result": {    "report": {      "schema": "fileverity.docpro/1",      "id": "FV-3PXH-6WQ2-8NDC"    },    "stamped_at": 1793700340  },  "error": null,  "progress": null,  "usage": {    "amount": 599,    "currency": "usd",    "funding": "balance"  },  "metadata": null,  "completed_at": 1793700341,  "expires_at": 1794305141}
Yêu cầu đầu tiên tải tệp lên và yêu cầu thứ hai tạo lượt kiểm tra. Phản hồi cho thấy một lượt kiểm tra đã hoàn tất.

Phù hợp ở đâu

Đặt vào đúng khâu mà tệp trở thành quyết định.

API trả về mức độ rủi ro và hành động khuyến nghị. Quyết định cuối cùng vẫn thuộc về người xét duyệt của bạn.

Giới hạn

Những điều API không làm.

Kết quả sạch giúp thu hẹp phạm vi xem xét, chứ không thay thế việc xem xét.

  • API không đọc giấy tờ tùy thân, không đối chiếu khuôn mặt và không chạy kiểm tra liveness (xác nhận người thật). Hãy dùng song song với nhà cung cấp dịch vụ xác minh danh tính.
  • Việc không có phát hiện nào không chứng minh tài liệu là thật hay nội dung của nó là đúng.
  • API kiểm tra tệp, không kiểm tra sự thật. API không thể xác nhận một số tiền, người thụ hưởng hoặc đơn vị phát hành là đúng, vì vậy hãy tiếp tục xác minh những điều đó tại nguồn.
  • Một số nội dung không thể được kiểm tra, chẳng hạn trang quét không có văn bản hoặc các đoạn quá ngắn. Báo cáo nêu rõ những gì chưa được kiểm tra.
  • Ảnh chụp và ảnh chụp màn hình của tài liệu là ảnh, không phải tài liệu. Hãy kiểm tra chúng bằng API ảnh.

Bằng chứng

Bằng chứng bạn có thể lưu giữ.

Mỗi lượt kiểm tra để lại một bản ghi mà bạn có thể lưu, chia sẻ và kiểm tra lại sau này, chứ không chỉ là một kết luận.

  • Mã báo cáo

    Mã báo cáo có dạng FV-XXXX-XXXX-XXXX. Hãy lưu cùng hồ sơ vụ việc hoặc hồ sơ khách hàng của bạn.

  • Giá trị băm và dấu thời gian

    Giá trị băm SHA-256 của tệp và của báo cáo, cùng dấu thời gian RFC 3161, được ghi lại với mọi báo cáo.

  • Trang xác minh công khai

    Bất kỳ ai nhận được mã báo cáo từ bạn đều có thể xác nhận trên trang xác minh mà không cần tài khoản.

  • Tệp bị xóa, kết quả được giữ

    Tệp tải lên bị xóa sau khi kiểm tra và không bao giờ được dùng để huấn luyện mô hình. Kết quả vẫn có thể lấy qua API trong 7 ngày.

Tích hợp

Tích hợp vào quy trình làm việc của bạn.

Kiểm tra ảnh và tài liệu hoạt động theo cùng một cách, nên một lần tích hợp là đủ cho cả hai.

  • Chờ kết quả bằng Prefer: wait, hoặc nhận webhook có chữ ký khi lượt kiểm tra hoàn tất. Hãy xử lý cả phản hồi đã hoàn tất lẫn phản hồi đang xử lý.
  • Gửi Idempotency-Key trong mọi yêu cầu POST để việc thử lại không bao giờ chạy lượt kiểm tra hai lần.
  • Hãy bắt đầu phát triển với khóa fv_test_. Khóa này trả về kết quả mẫu cố định và không bao giờ bị tính phí.
  • Lượt kiểm tra thất bại không bị tính phí. Khi dịch vụ bận, hệ thống trả về mã 503 kèm header retry-after, và bạn thử lại với cùng Idempotency-Key.
  • Webhook được ký và tuân theo đặc tả Standard Webhooks.
  • Tệp tối đa 4 MB được gửi trong một yêu cầu multipart. Tệp lớn hơn dùng URL tải lên được ký sẵn (pre-signed), tối đa bằng giới hạn của mô hình.
  • Số yêu cầu được giới hạn ở mức 120 mỗi phút cho mỗi khóa.

Bảng giá

Trả tiền theo từng lượt kiểm tra.

Một số dư trả trước của không gian làm việc dùng chung cho kiểm tra ảnh, tài liệu và văn bản. Nạp từ 19 USD. Không có gói đăng ký và không có gì tự động gia hạn.

Giá API và Console
Loại kiểm traGiá
Kiểm tra ảnhTính phí theo ảnh1,99 USD
Kiểm tra tài liệuTính phí theo tài liệu5,99 USD
Kiểm tra văn bảnTính phí theo 1.000 ký tự0,14 USD

Văn bản được làm tròn lên bội số 1.000 ký tự tiếp theo cho mỗi yêu cầu. Kiểm tra văn bản cần tối thiểu 100 từ.

Lượt dùng thử miễn phí

Dùng thử trước khi nạp tiền.

Không gian làm việc đầu tiên của bạn có sẵn 5 lượt kiểm tra ảnh hoặc tài liệu miễn phí và 5.000 ký tự văn bản miễn phí.

Không cần thẻ để bắt đầu. Mỗi người có một lượt dùng thử miễn phí, và số lượt dùng thử cho mỗi tên miền email công ty có giới hạn. Đồng nghiệp nên tham gia qua lời mời.

Câu hỏi thường gặp

Làm thế nào để phát hiện PDF giả mạo bằng API?

Tải PDF lên bằng POST /v1/files, sau đó tạo lượt kiểm tra bằng POST /v1/analyses với mô hình fvdoc-3. Phản hồi gồm các phát hiện từ lịch sử chỉnh sửa, chữ ký, ảnh nhúng và văn bản của tệp, một mức độ rủi ro và hành động khuyến nghị, cùng mã báo cáo mà ai cũng có thể xác minh.

API có phát hiện được tài liệu do AI tạo ra không?

API phát hiện văn bản do AI viết: lượt kiểm tra đánh dấu các đoạn do AI viết theo trang và cho biết khi nào văn bản không thể được đánh giá, ví dụ trên các trang quét không có văn bản. Văn bản được đánh giá bằng tiếng Anh, tiếng Pháp, tiếng Đức, tiếng Tây Ban Nha hoặc tiếng Trung; tính năng này không áp dụng cho tiếng Việt và các ngôn ngữ khác. API cũng kiểm tra ảnh nhúng xem có do AI tạo ra hay không. Hãy xem kết quả là bằng chứng để xem xét, không phải bằng chứng tuyệt đối.

API có xác minh giấy tờ tùy thân hoặc hộ chiếu không?

Không. API không đọc giấy tờ tùy thân, không đối chiếu khuôn mặt và không chạy kiểm tra liveness. API kiểm tra tệp tài liệu, không phải người xuất trình, vì vậy hãy dùng song song với nhà cung cấp dịch vụ xác minh danh tính.

Một lượt kiểm tra tài liệu có giá bao nhiêu?

5,99 USD mỗi lượt kiểm tra tài liệu, được trừ từ số dư không gian làm việc trả trước mà bạn nạp từ 19 USD. Không có gói đăng ký. Lượt kiểm tra thất bại không bị tính phí, và khóa thử nghiệm không bao giờ bị tính phí.

Tôi có thể dùng thử miễn phí không, và có chế độ thử nghiệm không?

Không gian làm việc đầu tiên của bạn có sẵn 5 lượt kiểm tra ảnh hoặc tài liệu miễn phí và 5.000 ký tự văn bản miễn phí, không cần thẻ. Mỗi người chỉ được dùng thử miễn phí một lần, và mỗi tên miền email công ty có số lần dùng thử giới hạn. Các khóa bắt đầu bằng fv_test_ trả về kết quả mẫu cố định và không bao giờ bị tính phí.

Chấp nhận những định dạng và dung lượng tệp nào?

Định dạng được chấp nhận: PDF, DOCX, DOC, RTF, ODT, PPTX, TXT. Giới hạn là 50 MB và 100 trang cho mỗi tệp. Tệp tối đa 4 MB được gửi trong một yêu cầu multipart; tệp lớn hơn dùng URL tải lên được ký sẵn (pre-signed). Ảnh JPEG, PNG hoặc WebP chụp tài liệu sẽ được xử lý như một lượt kiểm tra ảnh.

Tệp và kết quả được lưu trong bao lâu?

Tệp tải lên bị xóa sau khi kiểm tra. Kết quả được giữ trong 7 ngày để bạn có thể lấy lại, và trang xác minh công khai xác nhận mã báo cáo, giá trị băm của tệp và dấu thời gian.

Hướng dẫn

Hướng dẫn thực tế cho các nhóm xét duyệt.

Mỗi bước kiểm tra cho phép kết luận điều gì, giới hạn ở đâu và nên yêu cầu bằng chứng nào tiếp theo.

Tất cả hướng dẫn

Thực hiện lượt kiểm tra đầu tiên chỉ trong vài phút.

Mở Console, dùng lượt dùng thử miễn phí và gửi một yêu cầu thử nghiệm. Chỉ nạp tiền khi bạn sẵn sàng chạy kiểm tra thật.