# Tài liệu API Fileverity

> Tài liệu dành cho nhà phát triển của API Fileverity: kiểm tra hình ảnh, tài liệu và văn bản thuần túy để phát hiện nội dung do AI tạo ra, nội dung bị chỉnh sửa và các đoạn do AI viết. Mỗi trang cũng có bản Markdown tại cùng đường dẫn, chỉ cần thêm .md vào cuối.

## Tóm tắt nhanh

- Base URL: `https://api.fileverity.com/v1` (chỉ HTTPS, JSON).
- Xác thực: khóa API bearer trong header `Authorization`. Khóa thật bắt đầu bằng `fv_live_`; khóa thử nghiệm 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í.
- Kiểm tra ảnh: mô hình `fvimg-2` (FVIMG V2), 1,99 USD mỗi ảnh. Tải lên bằng `POST /files`, rồi gọi `POST /analyses`.
- Kiểm tra tài liệu: mô hình `fvdoc-3` (FVDOC V3), 5,99 USD mỗi tài liệu. Tải lên bằng `POST /files`, rồi gọi `POST /analyses`.
- Kiểm tra văn bản: mô hình `fvdoc-3-text` (FVDOC V3 Text), 0,14 USD mỗi 1.000 ký tự, tối thiểu 100 từ. Một lệnh gọi đồng bộ tới `POST /text/detections`.

API hoạt động theo hình thức trả trước, không có gói đăng ký: nạp tiền vào số dư không gian làm việc của bạn từ 19 USD. Không gian làm việc đầu tiên của bạn bắt đầu với 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í. Lượt kiểm tra thất bại không bị tính phí. Số dư có hiệu lực trong 12 tháng kể từ lần nạp tiền gần nhất của bạn, và các lần nạp tiền không được hoàn lại, trừ khi pháp luật yêu cầu hoặc thỏa thuận của bạn có quy định. Tệp tải lên bị xóa khi lượt phân tích bắt đầu, và chậm nhất sau 24 giờ. Văn bản bạn gửi không được lưu. Kết quả được giữ trong 7 ngày.

## Bắt đầu

- [Tổng quan](https://fileverity.com/vi/docs.md): API của Fileverity kiểm tra ảnh, tài liệu và văn bản thuần túy để phát hiện nội dung do AI tạo ra, dấu vết can thiệp và các đoạn do AI viết. Base URL, mô hình, quy ước và nơi bắt đầu.
- [Bắt đầu nhanh](https://fileverity.com/vi/docs/quickstart.md): Tạo không gian làm việc, tạo khóa API và chạy các lượt kiểm tra văn bản và ảnh đầu tiên bằng cURL, JavaScript fetch hoặc Python requests.
- [Xác thực và khóa API](https://fileverity.com/vi/docs/authentication.md): Xác thực bằng khóa API bearer. Khóa thật và khóa thử nghiệm, kết quả trả về ở chế độ thử nghiệm, thu hồi khóa và đặt hạn mức chi tiêu hằng tháng cho từng khóa.

## Hướng dẫn

- [Phát hiện văn bản](https://fileverity.com/vi/docs/text-detections.md): Phân loại văn bản thuần túy là do AI viết, do AI viết một phần hoặc do người viết bằng POST /text/detections. Các trường yêu cầu và phản hồi, offset của các đoạn, giới hạn và cách tính phí.
- [Tệp](https://fileverity.com/vi/docs/files.md): Tải ảnh và tài liệu lên Fileverity: multipart cho tệp đến 4 MB, tải lên bằng URL ký trước cho tệp đến 50 MB. Đối tượng tệp, giới hạn và thời gian lưu giữ.
- [Phân tích](https://fileverity.com/vi/docs/analyses.md): Tạo lượt phân tích ảnh và tài liệu, chờ kết quả bằng Prefer: wait hoặc truy vấn định kỳ, hủy, tải báo cáo PDF và đọc đối tượng báo cáo cùng trang xác minh.
- [Webhook](https://fileverity.com/vi/docs/webhooks.md): Nhận các sự kiện analysis.completed, analysis.failed và balance.low. Xác minh chữ ký Standard Webhooks bằng JavaScript và Python, cơ chế thử lại, tự động tắt endpoint và sự kiện thử.
- [Idempotency](https://fileverity.com/vi/docs/idempotency.md): Gửi Idempotency-Key trong các yêu cầu POST để một yêu cầu được thử lại không bao giờ chạy hoặc tính phí một lượt kiểm tra hai lần. Cách hoạt động, phản hồi được phát lại và xung đột.
- [Mã mẫu](https://fileverity.com/vi/docs/sample-code.md): Các chương trình Node.js và Python hoàn chỉnh cho Fileverity API: kiểm tra ảnh, kiểm tra tệp PDF lớn, phát hiện văn bản do AI viết và xác minh chữ ký webhook.
- [Kiểm tra tài liệu trong quy trình tiếp nhận hồ sơ](https://fileverity.com/vi/docs/intake-workflow.md): Thêm bước kiểm tra tài liệu vào luồng tiếp nhận: tải lên, nhận webhook, phân luồng theo mức độ rủi ro, đưa vào hàng đợi để người xem xét, lưu mã báo cáo và xác minh sau này.
- [Lỗi](https://fileverity.com/vi/docs/errors.md): Định dạng lỗi của Fileverity API, các mã trạng thái HTTP và bảng đầy đủ các mã lỗi, kèm hướng dẫn nên thử lại những lỗi nào.
- [Giới hạn tốc độ và header](https://fileverity.com/vi/docs/rate-limits.md): Giới hạn tốc độ yêu cầu theo từng khóa API, các header phản hồi về giới hạn tốc độ, retry-after trên 429 và 503 cùng các header khác mà Fileverity API đặt.
- [Giá và thanh toán](https://fileverity.com/vi/docs/pricing.md): Các mô hình, giá và giới hạn của Fileverity API, số dư trả trước, thời hạn hiệu lực và hoàn tiền, lượt dùng thử miễn phí, hạn mức chi tiêu, tự động nạp tiền và cảnh báo số dư thấp.
- [Lưu giữ dữ liệu và bảo mật](https://fileverity.com/vi/docs/security.md): Fileverity API lưu những gì và trong bao lâu: tệp tải lên, kết quả, văn bản, nhật ký yêu cầu và các lần gửi webhook, cùng cách bảo vệ khóa và endpoint.

## Tham chiếu

- [Tham chiếu API](https://fileverity.com/vi/docs/api-reference.md): Mọi endpoint của Fileverity API với tham số, schema yêu cầu và phản hồi, mã lỗi và ví dụ, được tạo từ đặc tả OpenAPI 3.1.
- [Nhật ký thay đổi](https://fileverity.com/vi/docs/changelog.md): Các thay đổi của Fileverity API. Phiên bản 1 ra mắt vào tháng 11 năm 2026.

## Dành cho máy đọc

- [Đặc tả OpenAPI 3.1](https://api.fileverity.com/v1/openapi.json): nguồn của tài liệu tham chiếu API.
- [Toàn bộ trang tài liệu trong một tệp](https://fileverity.com/vi/docs/llms-full.txt): mọi trang ở trên, nối lại dưới dạng Markdown.