# Tổng quan

> 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.

Nguồn: https://fileverity.com/vi/docs

API của Fileverity cho phép phần mềm của bạn kiểm tra ảnh, tài liệu và văn bản thuần túy bằng các mô hình của Fileverity. Một khóa API và một số dư không gian làm việc trả trước dùng chung cho mọi mô hình. Kết quả ảnh và tài liệu chính là các báo cáo mà website tạo ra, mỗi báo cáo có mã báo cáo, dấu thời gian RFC 3161 và một trang xác minh công khai.

Mới bắt đầu? Hãy làm theo phần [Bắt đầu nhanh](https://fileverity.com/vi/docs/quickstart.md) để thực hiện lệnh gọi đầu tiên chỉ trong vài phút, hoặc [lấy khóa thử nghiệm](https://fileverity.com/console/keys?lang=vi) và gọi API ngay. Để xem tổng quan về sản phẩm, hãy đọc [trang API](https://fileverity.com/vi/api), [API phát hiện ảnh AI](https://fileverity.com/vi/api/phat-hien-anh-ai) và [API phát hiện gian lận tài liệu](https://fileverity.com/vi/api/phat-hien-gia-mao-tai-lieu).

## Mô hình

| Mô hình | Nội dung kiểm tra | Cách gọi |
| --- | --- | --- |
| `fvimg-2` (FVIMG V2) | Ảnh: nội dung do AI tạo ra, chỉnh sửa cục bộ, Content Credentials và metadata (siêu dữ liệu). Tổng quan: [API phát hiện ảnh AI](https://fileverity.com/vi/api/phat-hien-anh-ai) | Tải tệp lên bằng [`POST /files`](https://fileverity.com/vi/docs/files.md), sau đó gọi [`POST /analyses`](https://fileverity.com/vi/docs/analyses.md) |
| `fvdoc-3` (FVDOC V3) | Tài liệu: văn bản do AI viết, ảnh nhúng, lịch sử chỉnh sửa và chữ ký. Tổng quan: [API phát hiện gian lận tài liệu](https://fileverity.com/vi/api/phat-hien-gia-mao-tai-lieu) | Tải tệp lên bằng [`POST /files`](https://fileverity.com/vi/docs/files.md), sau đó gọi [`POST /analyses`](https://fileverity.com/vi/docs/analyses.md) |
| `fvdoc-3-text` (FVDOC V3 Text) | Văn bản thuần túy: do AI viết, do AI viết một phần hoặc do người viết, kèm đánh dấu các đoạn do AI viết | Một lệnh gọi đồng bộ tới [`POST /text/detections`](https://fileverity.com/vi/docs/text-detections.md) |

Giá, giới hạn và mã snapshot được liệt kê tại [Giá và thanh toán](https://fileverity.com/vi/docs/pricing.md).

## Quy ước

- **Base URL.** `https://api.fileverity.com/v1`. Chỉ hỗ trợ HTTPS.
- **Định dạng.** Yêu cầu ở dạng JSON, trừ yêu cầu tải tệp lên dùng multipart. Phản hồi là JSON, trừ báo cáo PDF. Dấu thời gian tính bằng giây Unix, trừ trong `result.report`, nơi thời gian được ghi theo ISO 8601 ở múi giờ UTC.
- **Xác thực.** Khóa API bearer trong header `Authorization`. Xem [Xác thực và khóa API](https://fileverity.com/vi/docs/authentication.md).
- **Mã định danh.** Mỗi đối tượng có một tiền tố: `file_` cho tệp, `an_` cho lượt phân tích, `tdet_` cho lượt phát hiện văn bản, `evt_` cho sự kiện webhook, `req_` cho yêu cầu. Mã báo cáo có dạng `FV-XXXX-XXXX-XXXX`.
- **Mã yêu cầu.** Mọi phản hồi đều có header `x-request-id`, và mọi lỗi đều lặp lại giá trị này trong `error.request_id`. Hãy cung cấp mã này khi bạn [liên hệ hỗ trợ](https://fileverity.com/vi/lien-he).
- **Lượt kiểm tra, lượt phân tích và báo cáo.** Lượt kiểm tra là đơn vị bạn chạy và trả phí: kiểm tra ảnh, kiểm tra tài liệu hoặc kiểm tra văn bản. Trong API, một lượt phân tích là một lượt kiểm tra ảnh hoặc tài liệu, còn một lượt phát hiện văn bản là một lượt kiểm tra văn bản. Lượt kiểm tra ảnh và tài liệu tạo ra một báo cáo đầy đủ; lượt kiểm tra văn bản tạo ra một kết quả.
- **Phiên bản.** Phiên bản nằm trong URL. Có thể thêm trường và endpoint mới vào v1, vì vậy hãy bỏ qua các trường bạn không nhận ra. Mã mô hình như `fvimg-2` trỏ đến một snapshot có ghi ngày (`fvimg-2-2026-10-30`). Kết quả cho biết snapshot đã tạo ra chúng, và bạn có thể cố định một yêu cầu theo một snapshot bằng cách truyền mã của snapshot đó vào `model`.
- **Ngôn ngữ.** Phát hiện văn bản chấp nhận en, fr, de, es, zh.

## Đặc tả OpenAPI

API được mô tả bằng một tài liệu OpenAPI 3.1 tại [https://api.fileverity.com/v1/openapi.json](https://api.fileverity.com/v1/openapi.json). [Tham chiếu API](https://fileverity.com/vi/docs/api-reference.md) được tạo từ tài liệu này nên hai bên luôn khớp nhau. Tài liệu có thể tải từ trình duyệt, vì vậy các công cụ như Swagger UI và Postman có thể nhập bằng URL, và `GET https://api.fileverity.com/v1` trả về các liên kết tới tài liệu này và tới đặc tả.

## Nội dung của tài liệu này

- [Bắt đầu nhanh](https://fileverity.com/vi/docs/quickstart.md): từ đăng ký đến kết quả đầu tiên.
- [Xác thực và khóa API](https://fileverity.com/vi/docs/authentication.md): khóa thật và khóa thử nghiệm, thu hồi khóa và hạn mức chi tiêu.
- [Phát hiện văn bản](https://fileverity.com/vi/docs/text-detections.md), [Tệp](https://fileverity.com/vi/docs/files.md) và [Lượt phân tích](https://fileverity.com/vi/docs/analyses.md): các cách chạy một lượt kiểm tra.
- [Webhook](https://fileverity.com/vi/docs/webhooks.md) và [Idempotency](https://fileverity.com/vi/docs/idempotency.md): cách hoạt động trong môi trường production.
- [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 từng loại kiểm tra và cho 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): tải lên, webhook, phân luồng theo mức độ rủi ro, xem xét thủ công và xác minh sau này.
- [Lỗi](https://fileverity.com/vi/docs/errors.md) và [Giới hạn tốc độ và header](https://fileverity.com/vi/docs/rate-limits.md).
- [Giá và thanh toán](https://fileverity.com/vi/docs/pricing.md) và [Lưu giữ dữ liệu và bảo mật](https://fileverity.com/vi/docs/security.md).
- [Nhật ký thay đổi](https://fileverity.com/vi/docs/changelog.md) và [Tham chiếu API](https://fileverity.com/vi/docs/api-reference.md).

## Cùng các lượt kiểm tra đó trong trình duyệt

Bạn không cần dùng API để chạy một lượt kiểm tra. Website cung cấp [Kiểm tra ảnh](https://fileverity.com/vi/phat-hien-anh-ai), [Xác minh tài liệu](https://fileverity.com/vi/phat-hien-tai-lieu-gia-mao) và [Xác minh hình ảnh](https://fileverity.com/vi/xac-minh-hinh-anh), còn [Console](https://fileverity.com/console?lang=vi) chạy cả ba loại kiểm tra và trừ vào số dư không gian làm việc của bạn.

## Hỗ trợ

Hãy gửi email tới [hello@fileverity.com](mailto:hello@fileverity.com) hoặc dùng [trang liên hệ](https://fileverity.com/vi/lien-he), kèm mã yêu cầu (`x-request-id`), thời gian theo UTC và endpoint. Lỗi tạm thời trả về `503 service_unavailable` kèm header `retry-after` và không bao giờ bị tính phí. Cần giới hạn cao hơn hoặc giá theo khối lượng? [Liên hệ bộ phận kinh doanh](https://fileverity.com/vi/lien-he).

## Đọc tài liệu này bằng AI agent

Mỗi trang đều có sẵn dưới dạng Markdown: thêm `.md` vào đường dẫn của trang, ví dụ `/vi/docs/quickstart.md`. Danh mục của tất cả các trang nằm tại [/vi/docs/llms.txt](https://fileverity.com/vi/docs/llms.txt).