Textprüfungen

POST /text/detections führt eine Textprüfung aus. Der Endpunkt stuft reinen Text mit fvdoc-3-text ein und liefert die von KI verfassten Passagen. Der Aufruf ist synchron: Das Ergebnis steht in der Antwort.

Die Beispiele lesen den Text aus einer Datei. Speichern Sie daher zuerst eine beliebige Passage mit mindestens 100 Wörtern als essay.txt. Der Schnellstart enthält einen Befehl, der einen Beispieltext schreibt.

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()

Anfragetext#

Unbekannte Felder werden mit invalid_parameter abgelehnt. Bei der Prüfung auf die Mindestlänge von 100 Wörtern zählen zwei chinesische Schriftzeichen etwa als ein Wort.

Antwort#

{  "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  }}

Die Textprüfung liefert eine statistische Schätzung, keinen Nachweis der Urheberschaft. Die Segmentgrenzen sind ungefähr. Nutzen Sie sie als einen Anhaltspunkt für eine Prüfung durch Menschen und stützen Sie Entscheidungen, die eine Person betreffen, nicht allein darauf.

Segment-Offsets#

start und end sind Offsets im gesendeten Text, gezählt in Unicode-Codepoints, nicht in Bytes und nicht in UTF-16-Einheiten. Die Segmentgrenzen sind ungefähr und können angrenzende Sätze einschließen. JavaScript-Strings werden nach UTF-16 indiziert; zerlegen Sie den Text daher zuerst in Codepoints:

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"]])

Python-Strings werden bereits nach Codepoints indiziert.

Abrechnung#

• Text wird pro 1.000 Zeichen mit 0,14 USD abgerechnet, gezählt in Unicode-Codepoints. Jede Anfrage wird auf ganze Einheiten aufgerundet, mindestens auf eine Einheit.
• Die kostenlosen Zeichen für Textprüfungen aus Ihrem kostenlosen Start werden zuerst verbraucht und in usage.free_characters ausgewiesen. usage.billed_units ist die Anzahl der danach berechneten Einheiten; die Kosten betragen also billed_units mal 0,14 USD. Beispiel: 1.412 Zeichen ohne verbleibende kostenlose Zeichen ergeben 2 Einheiten, 0,28 USD.
• Anfragen, die vor der Auswertung abgelehnt werden, werden nicht berechnet: ungültige Parameter, zu kurzer oder zu langer Text, nicht unterstützte Sprachen und Ähnliches. Eine Prüfung, die im Dienst fehlschlägt (service_unavailable), wird freigegeben und nicht berechnet.
• Bei unzureichendem Guthaben wird insufficient_balance (402) zurückgegeben.

Was gespeichert wird#

Der Text wird ausgewertet und verworfen. Er wird nie gespeichert und lässt sich daher später nicht abrufen.

Fileverity speichert das Ergebnis ohne den Text (Einstufung, Scores, Passagen-Offsets und Nutzung) 7 Tage lang, damit die Konsole es anzeigen und die Nutzung abgerechnet und nachvollzogen werden kann. Eine wiederholte Anfrage mit demselben Idempotency-Key erhält 24 Stunden lang das gespeicherte Ergebnis. Textprüfungen sind synchron: Sie erscheinen nicht in GET /analyses und senden keine Webhook-Ereignisse. Testschlüssel zeichnen nichts auf. Siehe Datenaufbewahrung und Sicherheit.

Fehler#

Senden Sie einen Idempotency-Key, damit ein erneuter Versuch nach einem Timeout nicht doppelt berechnet wird. Siehe Idempotenz.