Phát hiện văn bản

POST /text/detections chạy một lượt kiểm tra văn bản. Endpoint này phân loại văn bản thuần túy bằng fvdoc-3-text và trả về các đoạn do AI viết. Đây là lệnh gọi đồng bộ: kết quả nằm ngay trong phản hồi.

Các ví dụ đọc văn bản từ một tệp, vì vậy trước tiên hãy lưu một đoạn văn bất kỳ có từ 100 từ trở lên thành essay.txt. Phần Bắt đầu nhanh có một lệnh ghi ra văn bản mẫu.

curl https://api.fileverity.com/v1/text/detections \  -H "Authorization: Bearer $FILEVERITY_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 6b9d1c1e-3b0f-4c0a-9a53-2d1c9d6b7e11" \  -d "$(jq -Rs '{text: ., language: "en"}' essay.txt)"

import { readFile } from "node:fs/promises";import { randomUUID } from "node:crypto"; const response = await fetch("https://api.fileverity.com/v1/text/detections", {  method: "POST",  headers: {    Authorization: "Bearer " + process.env.FILEVERITY_API_KEY,    "Content-Type": "application/json",    "Idempotency-Key": randomUUID(),  },  body: JSON.stringify({ text: await readFile("essay.txt", "utf8"), language: "en" }),});const detection = await response.json();

import osimport uuidimport requests response = requests.post(    "https://api.fileverity.com/v1/text/detections",    headers={        "Authorization": "Bearer " + os.environ["FILEVERITY_API_KEY"],        "Idempotency-Key": str(uuid.uuid4()),    },    json={"text": open("essay.txt", encoding="utf-8").read(), "language": "en"},)detection = response.json()

Nội dung yêu cầu#

Các trường không xác định bị từ chối với invalid_parameter. Khi kiểm tra mức tối thiểu 100 từ, khoảng hai ký tự tiếng Trung được tính là một từ.

Phản hồi#

{  "id": "tdet_8Hk2pQ4vN9sL1xR7cW3mY6zB",  "object": "text.detection",  "created": 1793664000,  "model": "fvdoc-3-text-2026-11-03",  "livemode": true,  "language": "en",  "verdict": "mixed",  "score": 0.97,  "ai_fraction": 0.41,  "segments": [    {      "start": 212,      "end": 433,      "score": 0.97    },    {      "start": 579,      "end": 790,      "score": 0.93    }  ],  "usage": {    "characters": 1412,    "free_characters": 0,    "billed_units": 2  }}

Phát hiện văn bản trả về một ước tính thống kê, không phải bằng chứng xác định ai là người viết. Ranh giới các đoạn chỉ mang tính tương đối. Hãy dùng kết quả như một đầu vào cho việc xem xét của con người, và đừng chỉ dựa vào kết quả này để ra quyết định ảnh hưởng đến một người.

Offset của các đoạn#

start và end là offset (vị trí) trong văn bản bạn đã gửi, được đếm theo code point Unicode, không phải byte và không phải đơn vị UTF-16. Ranh giới các đoạn chỉ mang tính tương đối và có thể bao gồm cả các câu liền kề. Chuỗi trong JavaScript được đánh chỉ mục theo UTF-16, vì vậy hãy tách thành các code point trước:

const points = Array.from(text);for (const { start, end } of detection.segments) {  console.log(points.slice(start, end).join(""));}

for segment in detection["segments"]:    print(text[segment["start"]:segment["end"]])

Chuỗi trong Python vốn đã được đánh chỉ mục theo code point.

Tính phí#

• Văn bản được tính phí theo mỗi 1.000 ký tự với giá 0,14 USD, đếm theo code point Unicode. Mỗi yêu cầu được làm tròn lên thành số đơn vị nguyên, tối thiểu một đơn vị.
• Các ký tự văn bản miễn phí trong lượt dùng thử của bạn được dùng trước và được báo cáo trong usage.free_characters. usage.billed_units là số đơn vị bị tính phí sau đó, vì vậy chi phí bằng billed_units nhân 0,14 USD. Ví dụ: 1.412 ký tự khi không còn ký tự miễn phí được tính 2 đơn vị, tức 0,28 USD.
• Các yêu cầu bị từ chối trước khi đánh giá không bị tính phí: tham số không hợp lệ, văn bản quá ngắn hoặc quá dài, ngôn ngữ không được hỗ trợ và các trường hợp tương tự. Lượt kiểm tra thất bại bên trong dịch vụ (service_unavailable) được hoàn lại và không bị tính phí.
• Số dư không đủ sẽ trả về insufficient_balance (402).

Dữ liệu được lưu#

Văn bản được đánh giá rồi xóa ngay. Văn bản không bao giờ được lưu, nên không thể lấy lại sau này.

Fileverity giữ kết quả không kèm văn bản (kết luận, điểm số, offset của các đoạn và mức sử dụng) trong 7 ngày, để Console có thể hiển thị kết quả đó và mức sử dụng có thể được tính phí và đối soát. Yêu cầu được gửi lại với cùng Idempotency-Key sẽ nhận kết quả đã lưu trong 24 giờ. Lượt phát hiện văn bản là đồng bộ: chúng không xuất hiện trong GET /analyses và không gửi sự kiện webhook. Khóa thử nghiệm không ghi lại gì. Xem Lưu giữ dữ liệu và bảo mật.

Lỗi#

Hãy gửi Idempotency-Key để việc thử lại sau khi hết thời gian chờ không bị tính phí hai lần. Xem Idempotency.