# Giá và thanh toán

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

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

API hoạt động theo hình thức trả trước. Bạn nạp tiền vào số dư của không gian làm việc và mỗi lượt kiểm tra sẽ trừ vào số dư đó. Không có gói đăng ký, và một số dư dùng được cho mọi mô hình.

## Mô hình và giá

| Mô hình | Kiểu | Giá | Đầu vào | Snapshot |
| --- | --- | --- | --- | --- |
| `fvimg-2` (FVIMG V2) | ảnh | 1,99 USD cho mỗi lượt kiểm tra ảnh | jpeg, png, webp; tối đa 10 MB và 40 megapixel | `fvimg-2-2026-10-30` |
| `fvdoc-3` (FVDOC V3) | tài liệu | 5,99 USD cho mỗi lượt kiểm tra tài liệu | pdf, docx, doc, rtf, odt, pptx, txt; tối đa 50 MB và 100 trang | `fvdoc-3-2026-11-03` |
| `fvdoc-3-text` (FVDOC V3 Text) | văn bản | 0,14 USD cho mỗi 1.000 ký tự | en, fr, de, es, zh; tối thiểu 100 từ, tối đa 100.000 ký tự | `fvdoc-3-text-2026-11-03` |

Giá được tính bằng đô la Mỹ và cũng được `GET /models` trả về, tính bằng cent, trong `pricing.unit_amount`. Mã mô hình trỏ tới snapshot hiện tại của mô hình. Hãy truyền mã snapshot vào `model` để cố định yêu cầu theo một snapshot cụ thể. Xem [Phát hiện văn bản](https://fileverity.com/vi/docs/text-detections.md) để biết cách đếm văn bản.

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

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í. Mỗi người chỉ có một lượt dùng thử miễn phí, và số lượt cho mỗi tên miền email công ty có giới hạn. Địa chỉ email dùng một lần không nhận được lượt này. Đồng nghiệp nên tham gia qua lời mời. Lượt dùng thử miễn phí được dùng trước số dư của bạn. Một lượt kiểm tra ảnh hoặc tài liệu miễn phí ghi nhận `usage.funding: trial` và `usage.amount: 0`. Các ký tự văn bản vượt quá phần miễn phí được tính phí bình thường.

## Số dư trả trước

- Nạp tiền trong Console, tại mục **Số dư**. Số tiền nạp tối thiểu là 19 USD. Biên nhận cũng nằm ở cùng mục này.
- Khi một lượt phân tích được tạo, giá của lượt đó được tạm giữ từ số dư. Khoản này được trừ hẳn khi lượt phân tích thành công.
- Các lượt phân tích thất bại, các lượt phân tích bị hủy và các yêu cầu bị dịch vụ từ chối trước khi được đánh giá đều không bị tính phí. Khoản tạm giữ được hoàn lại vào số dư.
- Khi số dư không đủ cho một yêu cầu, API trả về `insufficient_balance` (HTTP 402).

> **Lưu ý.** Khóa thử nghiệm không bao giờ trừ vào số dư hoặc lượt dùng thử miễn phí.

## Hạn mức chi tiêu

Mỗi khóa API có thể có hạn mức chi tiêu hằng tháng, tính bằng số nguyên đô la Mỹ, được đặt lại vào ngày 1 hằng tháng (UTC). Chỉ chủ sở hữu và quản trị viên của không gian làm việc mới đặt hoặc thay đổi được hạn mức này. Yêu cầu khiến khóa vượt hạn mức sẽ trả về `spend_limit_reached` và không bị tính phí. Xem [Xác thực và khóa API](https://fileverity.com/vi/docs/authentication.md#spend-limits).

## Cảnh báo số dư thấp và tự động nạp tiền

- **Cảnh báo số dư thấp.** Đặt một ngưỡng trong Console. Khi số dư xuống dưới ngưỡng này, chủ sở hữu và quản trị viên nhận được email và một [webhook](https://fileverity.com/vi/docs/webhooks.md) `balance.low` được gửi đi.
- **Tự động nạp tiền.** Lưu một thẻ trong Console, rồi chọn ngưỡng và số tiền. Khi số dư xuống dưới ngưỡng, thẻ sẽ bị trừ tiền và số tiền đó được cộng vào số dư. Nếu một lần trừ tiền thất bại hoặc cần ngân hàng của bạn xác nhận, tự động nạp tiền sẽ tự tắt và chủ sở hữu cùng quản trị viên được gửi email.

## Hiệu lực của số dư và hoàn tiền

- **Hiệu lực.** 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 không gian làm việc, dù đó là nạp tiền thủ công hay tự động nạp tiền. Mỗi lần nạp tiền kéo dài hiệu lực của toàn bộ số dư, không chỉ phần tiền vừa nạp. Số dư nào vẫn chưa dùng sau 12 tháng kể từ lần nạp tiền gần nhất sẽ hết hạn.
- **Nhắc nhở.** Khoảng 30 ngày trước ngày hết hạn, chủ sở hữu và quản trị viên phụ trách thanh toán nhận một email nêu số tiền và ngày hết hạn, đồng thời cho biết bất kỳ lần nạp tiền nào cũng kéo dài hiệu lực của số dư. Email chỉ được gửi một lần cho mỗi lần nạp tiền gần nhất, và chỉ khi số dư lớn hơn 0.
- **Lượt dùng thử miễn phí.** Lượt dùng thử miễn phí không có giá trị quy đổi thành tiền mặt, không thể chuyển nhượng hoặc đổi, và không hết hạn theo quy tắc này.
- **Hoàn tiền.** Các lần nạp tiền không được hoàn lại, trừ khi pháp luật có yêu cầu khác hoặc có thỏa thuận bằng văn bản quy định. Lượt kiểm tra thất bại không bị tính phí và khoản tạm giữ được hoàn lại tự động. Nếu Fileverity ngừng cung cấp các lượt kiểm tra trả phí qua Console và API, Fileverity sẽ hoàn lại mọi số dư chưa dùng.
- **Quyền sở hữu.** Số dư thuộc về không gian làm việc của nó và không thể chuyển sang không gian làm việc khác hoặc đổi lấy lượt dùng trên website. Các lượt mua trên website là một sản phẩm riêng, có điều khoản riêng.

Giá được tính bằng đô la Mỹ, cộng thuế áp dụng (nếu có). Xem [Điều khoản sử dụng](https://fileverity.com/vi/dieu-khoan-su-dung) để biết toàn bộ điều khoản.

## Xem các khoản đã bị tính phí

Mỗi lượt phân tích báo cáo `usage.amount` tính bằng cent. Phát hiện văn bản báo cáo `usage.billed_units` và `usage.free_characters`. Console hiển thị chi tiêu, biểu đồ sử dụng và chức năng xuất CSV.