API phát hiện ảnh AI
API phát hiện ảnh AI kèm phân tích dấu vết chỉnh sửa.
Kiểm tra ảnh để phát hiện nội dung do AI tạo ra và chỉnh sửa cục bộ qua hai lệnh gọi API. Báo cáo có thể xác minh, 1,99 USD mỗi ảnh.
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ý.
- Endpoint
- POST /v1/files, POST /v1/analyses
- Mô hình
- fvimg-2 · FVIMG V2
- Tệp được chấp nhận
- JPEG, PNG, WEBP
- Dung lượng tối đa
- Tối đa 10 MB và 40 megapixel
- Kết quả
- Nhận ngay trong cùng yêu cầu, hoặc qua webhook
- Giá
- 1,99 USD mỗi lượt kiểm tra ảnh
Cập nhật lần cuối
Những gì được kiểm tra
Những câu hỏi mà lượt kiểm tra ảnh trả lời.
Toàn bộ ảnh có do AI tạo ra không? Một phần của ảnh có bị chỉnh sửa không? Thông tin ghi trong chính tệp cho biết điều gì? Một báo cáo trả lời cả ba câu hỏi, và cột trường phản hồi cho biết nơi đọc từng câu trả lời.
| Câu hỏi | Nội dung được kiểm tra | Trường phản hồi |
|---|---|---|
| Nội dung do AI tạo ra | Ảnh có vẻ do AI tạo ra hay không, kèm mức khả năng ước tính và, khi được hỗ trợ, công cụ tạo ảnh có khả năng đã dùng. | questions.ai, generator |
| Chỉnh sửa cục bộ | Một phần của ảnh có bị thay đổi hay không, kèm các vùng được đánh dấu theo điểm ảnh. | questions.edit, regions |
| Content Credentials, watermark và nhãn AI | Thông tin ghi trong chính tệp nói gì về nguồn gốc của nó, và những điều đó có đáng tin hay không. | questions.source, provenance |
| Metadata của tệp | Máy ảnh, phần mềm và thời điểm chụp được ghi trong tệp. | provenance |
| Kết luận và mức độ tin cậy | Mức độ rủi ro, hành động khuyến nghị và mức độ mà tệp này cho phép lượt kiểm tra xác lập được. | summary, confidence |
Yêu cầu và phản hồi
Hai lệnh gọi, một báo cáo.
Tải ảnh lên, sau đó tạo lượt kiểm tra với mô hình fvimg-2. Gửi Prefer: wait để giữ yêu cầu cho đến khi báo cáo sẵn sàng. Nếu hết thời gian chờ trước đó, lượt kiểm tra sẽ trả về mã 202 với trạng thái processing. Hãy lấy kết quả sau hoặc nhận webhook.
FILE_ID=$(curl -s https://api.fileverity.com/v1/files \ -H "Authorization: Bearer $FILEVERITY_API_KEY" \ -F file=@claim-photo.jpg | 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\": \"fvimg-2\", \"file\": \"$FILE_ID\", \"metadata\": {\"order_id\": \"A-10492\"}}"import { readFile } from "node:fs/promises"; const headers = { Authorization: "Bearer " + process.env.FILEVERITY_API_KEY }; const form = new FormData();form.append("file", new Blob([await readFile("claim-photo.jpg")], { type: "image/jpeg" }), "claim-photo.jpg");const file = await (await fetch("https://api.fileverity.com/v1/files", { method: "POST", headers, body: form })).json(); const response = await fetch("https://api.fileverity.com/v1/analyses", { method: "POST", headers: { ...headers, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID(), Prefer: "wait=60" }, body: JSON.stringify({ model: "fvimg-2", file: file.id, metadata: { order_id: "A-10492" } }),});const analysis = await response.json();console.log(analysis.status, analysis.summary, analysis.report_url);import osimport uuidimport requests headers = {"Authorization": "Bearer " + os.environ["FILEVERITY_API_KEY"]} file = requests.post("https://api.fileverity.com/v1/files", headers=headers, files={"file": open("claim-photo.jpg", "rb")}).json() response = requests.post( "https://api.fileverity.com/v1/analyses", headers={**headers, "Idempotency-Key": str(uuid.uuid4()), "Prefer": "wait=60"}, json={"model": "fvimg-2", "file": file["id"], "metadata": {"order_id": "A-10492"}},)analysis = response.json()print(analysis["status"], analysis["summary"], analysis["report_url"]){ "id": "an_8Hk2pQ4vN9sL1xR7cW3mY6zB", "object": "analysis", "created": 1793700120, "model": "fvimg-2-2026-10-30", "livemode": true, "status": "succeeded", "file": { "name": "claim-photo.jpg", "bytes": 2481920, "format": "jpeg" }, "report_id": "FV-7K2M-9QXD-4T8R", "report_url": "https://fileverity.com/verify/FV-7K2M-9QXD-4T8R", "summary": { "level": "L2", "assessment": "authentic_untouched", "action": "accept", "ai": "very_low", "edit": "none" }, "result": { "report": { "schema": "fileverity.report/1", "id": "FV-7K2M-9QXD-4T8R" }, "stamped_at": 1793700130 }, "error": null, "progress": null, "usage": { "amount": 199, "currency": "usd", "funding": "balance" }, "metadata": { "order_id": "A-10492" }, "completed_at": 1793700131, "expires_at": 1794304931}Phù hợp ở đâu
Đặt vào đúng khâu mà bức ảnh trở thành bằng chứng.
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.
Ảnh trong hồ sơ bồi thường bảo hiểm
- Bạn gửi
- Ảnh thiệt hại, phương tiện và tài sản nộp kèm hồ sơ bồi thường.
- Bạn nhận lại
- Các phát hiện về nội dung do AI tạo ra và chỉnh sửa cục bộ, vùng được đánh dấu và mã báo cáo.
- Sau đó đội ngũ của bạn
- Yêu cầu tệp gốc hoặc một ảnh khác khi báo cáo đánh dấu bức ảnh.
Trả hàng và yêu cầu hoàn tiền
- Bạn gửi
- Ảnh sản phẩm mà khách hàng tải lên để yêu cầu hoàn tiền.
- Bạn nhận lại
- Kết luận và hành động khuyến nghị trong phản hồi, với các vùng bị chỉnh sửa được đánh dấu.
- Sau đó đội ngũ của bạn
- Tạm hoãn khoản hoàn tiền để xem xét khi ảnh bị đánh dấu và xử lý các yêu cầu còn lại như bình thường.
Sàn thương mại điện tử và tin đăng
- Bạn gửi
- Ảnh tin đăng và ảnh đại diện ngay tại thời điểm tải lên.
- Bạn nhận lại
- Mức độ rủi ro và hành động khuyến nghị từ một lượt kiểm tra duy nhất.
- Sau đó đội ngũ của bạn
- Gắn nhãn, hạn chế hoặc xem xét các tệp tải lên bị đánh dấu theo chính sách của bạn.
Tranh chấp và điều tra
- Bạn gửi
- Ảnh được nộp làm bằng chứng trong một vụ tranh chấp hoặc điều tra.
- Bạn nhận lại
- Báo cáo kèm giá trị băm và dấu thời gian RFC 3161 có thể xác minh sau này.
- Sau đó đội ngũ của bạn
- Lưu mã báo cáo cùng hồ sơ vụ việc và chia sẻ trang xác minh khi cầ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.
- Chỉ kiểm tra ảnh tĩnh. Không phân tích video hoặc âm thanh, không nhận dạng người và không đối chiếu khuôn mặt.
- Việc không có phát hiện nào không chứng minh ảnh là thật. Chụp lại, chụp màn hình và mã hóa lại làm mất bằng chứng.
- Ảnh chụp màn hình, nén mạnh và ảnh nhỏ làm hạn chế những gì có thể xác lập. Báo cáo nêu rõ tệp đó cho phép xác lập đến đâu.
- Việc thiếu Content Credentials hoặc watermark không chứng minh điều gì theo cả hai hướng, vì metadata thường bị xóa khi ảnh được chia sẻ.
- Kết quả phát hiện thay đổi tùy công cụ tạo ảnh và từng bức ảnh. Hãy đọc báo cáo như bằng chứng để xem xét, không phải kết luận cuối cùng.
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.
| Loại kiểm tra | Tính phí theo | Giá |
|---|---|---|
| Kiểm tra ảnhTính phí theo ảnh | ảnh | 1,99 USD |
| Kiểm tra tài liệuTính phí theo tài liệu | tài liệu | 5,99 USD |
| Kiểm tra văn bảnTính phí theo 1.000 ký tự | 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 ảnh do AI tạo ra bằng API?
Tải ảnh 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 fvimg-2. Phản hồi gồm phát hiện về nội dung do AI tạo ra, các vùng bị chỉnh sửa (nếu có), trạng thái của Content Credentials và mã báo cáo mà ai cũng có thể xác minh.
API có tìm ra những phần bị chỉnh sửa của ảnh không?
Có. Lượt kiểm tra cho biết một phần của ảnh có bị thay đổi hay không và đánh dấu các vùng theo điểm ảnh, để người xét duyệt xem đúng phần đã bị đánh dấu. Chỉnh sửa cục bộ và ảnh do AI tạo ra toàn bộ được báo cáo riêng.
API có cho biết công cụ nào đã tạo ra ảnh không?
Khi được hỗ trợ, báo cáo nêu tên công cụ tạo ảnh có khả năng đã dùng và cách xác định. Nhiều ảnh không cho biết được công cụ tạo, và việc không có tên không có nghĩa ảnh là thật.
API có đọc Content Credentials và watermark không?
Có. API đọc Content Credentials, watermark và nhãn AI được ghi trong tệp và báo cáo trạng thái của chúng. Việc thiếu các thông tin này không phải là bằng chứng của tính xác thực, vì metadata thường bị xóa khi ảnh được chia sẻ.
Ảnh chụp màn hình và ảnh đã nén có dùng được không?
Bạn có thể gửi chúng, nhưng ảnh chụp màn hình, nén mạnh và đổi kích thước làm mất bằng chứng. Báo cáo nêu rõ tệp cho phép lượt kiểm tra xác lập được đến đâu, vì vậy hãy thận trọng với các kết quả có mức độ tin cậy thấp.
Một lượt kiểm tra ảnh có giá bao nhiêu?
1,99 USD mỗi lượt kiểm tra ảnh, đượ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 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à khóa thử nghiệm không bao giờ bị tính phí. Lượt kiểm tra thất bại không bị tính phí.
Chấp nhận những định dạng và dung lượng ảnh nào?
Định dạng được chấp nhận: JPEG, PNG, WEBP. Giới hạn là 10 MB và 40 megapixel cho mỗi ảnh. 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).
API có kiểm tra video, âm thanh hoặc khuôn mặt không?
Không. API chỉ kiểm tra ảnh tĩnh, không đối chiếu khuôn mặt hay nhận dạng người. Với tài liệu, hãy dùng API phát hiện gian lận tài liệu.
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.
Ảnh
Cách nhận biết ảnh AI: 6 bước kiểm tra ảnh có do AI tạo ra không
Ảnh có do AI tạo ra không? Kiểm tra nguồn, Content Credentials, watermark, dấu hiệu hình ảnh rồi dùng công cụ phát hiện. Gồm tranh AI, ví dụ và mẫu hồ sơ.
21 phút đọc ·
Ảnh
Ảnh chụp màn hình và ảnh bị nén: còn phát hiện được ảnh AI không?
Ảnh chụp màn hình, ảnh chuyển khoản giả hay ảnh bị nén: phát hiện ảnh AI được đến đâu? Nên gửi tệp nào, đọc kết quả ra sao, khi nào cần bằng chứng khác.
19 phút đọc ·
Bồi thường và hoàn tiền
Trục lợi bảo hiểm bằng ảnh AI: quy trình thẩm định ảnh bồi thường
Cách thẩm định ảnh bồi thường để phát hiện trục lợi bảo hiểm bằng ảnh AI: khung pháp lý Việt Nam, ví dụ thực hành, chỉ số đo lường và hồ sơ xem xét.
22 phút đọc ·
Đánh giá công cụ phát hiện
Cách chọn API phát hiện AI: mười điểm cần kiểm tra trước khi tích hợp
Danh sách kiểm tra khi chọn API phát hiện AI: giới hạn đầu vào, đồng bộ hay bất đồng bộ, webhook, bằng chứng, lưu giữ dữ liệu, giá và chế độ thử nghiệm.
18 phút đọc ·
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.