Fileverity-API-Dokumentation
Übersicht
Die Fileverity-API prüft Bilder, Dokumente und reinen Text auf KI-Erzeugung, Manipulation und von KI verfasste Passagen. Basis-URL, Modelle, Konventionen und der Einstieg.
Mit der Fileverity-API lässt Ihre Software Bilder, Dokumente und reinen Text von Fileverity-Modellen prüfen. Ein API-Schlüssel und ein vorausbezahltes Workspace-Guthaben decken jedes Modell ab. Bild- und Dokumentergebnisse sind dieselben Berichte, die auch die Website erstellt, jeweils mit einer Berichts-ID, einem Zeitstempel nach RFC 3161 und einer öffentlichen Verifizierungsseite.
Neu hier? Folgen Sie dem Schnellstart, um in wenigen Minuten Ihren ersten Aufruf zu senden, oder fordern Sie einen Testschlüssel an und rufen Sie die API sofort auf. Eine Produktübersicht finden Sie auf der API-Seite, unter KI-generierte Bilder per API erkennen und unter Dokumentenfälschung per API erkennen.
Modelle
| Modell | Was geprüft wird | Aufruf |
|---|---|---|
fvimg-2 (FVIMG V2) | Bilder: KI-Erzeugung, lokale Bearbeitungen, Content Credentials und Metadaten. Übersicht: KI-generierte Bilder per API erkennen | Hochladen mit POST /files, danach POST /analyses |
fvdoc-3 (FVDOC V3) | Dokumente: von KI verfasster Text, eingebettete Fotos, Änderungsverlauf und Signaturen. Übersicht: Dokumentenfälschung per API erkennen | Hochladen mit POST /files, danach POST /analyses |
fvdoc-3-text (FVDOC V3 Text) | Reiner Text: von KI verfasst, teilweise von KI verfasst oder von Menschen verfasst, mit markierten KI-Passagen | Ein synchroner Aufruf von POST /text/detections |
Preise, Limits und Snapshot-IDs finden Sie unter Preise und Abrechnung.
Konventionen
- Basis-URL.
https://api.fileverity.com/v1. Nur HTTPS. - Format. Anfragen sind JSON, außer Datei-Uploads, die als Multipart gesendet werden. Antworten sind JSON, außer beim PDF-Bericht. Zeitstempel werden in Unix-Sekunden angegeben, außer innerhalb von
result.report; dort stehen Zeiten im Format ISO 8601 in UTC. - Authentifizierung. Ein Bearer-API-Schlüssel im Header
Authorization. Siehe Authentifizierung und Schlüssel. - IDs. Objekte tragen ein Präfix:
file_Dateien,an_Analysen,tdet_Textprüfungen,evt_Webhook-Ereignisse,req_Anfragen. Berichts-IDs sehen so aus:FV-XXXX-XXXX-XXXX. - Anfrage-IDs. Jede Antwort enthält einen Header
x-request-id, und jeder Fehler wiederholt die ID alserror.request_id. Nennen Sie die ID, wenn Sie den Support kontaktieren. - Prüfungen, Analysen und Berichte. Eine Prüfung ist das, was Sie ausführen und bezahlen: eine Bildprüfung, eine Dokumentprüfung oder eine Textprüfung. In der API ist eine Analyse eine einzelne Bild- oder Dokumentprüfung, und eine Text Detection ist eine einzelne Textprüfung. Bild- und Dokumentprüfungen erzeugen einen vollständigen Bericht, eine Textprüfung liefert ein Ergebnis.
- Versionierung. Die Version steht in der URL. Neue Felder und Endpunkte können zu v1 hinzukommen, ignorieren Sie daher Felder, die Sie nicht kennen. Eine Modell-ID wie
fvimg-2verweist auf einen datierten Snapshot (fvimg-2-2026-10-30). Ergebnisse nennen den Snapshot, der sie erzeugt hat, und Sie können eine Anfrage auf einen Snapshot festlegen, indem Sie dessen ID alsmodelübergeben. - Sprachen. Die Textprüfung akzeptiert en, fr, de, es, zh.
OpenAPI-Spezifikation
Die API wird durch ein OpenAPI-3.1-Dokument unter https://api.fileverity.com/v1/openapi.json beschrieben. Die API-Referenz wird aus diesem Dokument erzeugt, beide stimmen daher immer überein. Das Dokument lässt sich aus einem Browser laden, sodass Tools wie Swagger UI und Postman es per URL importieren können, und GET https://api.fileverity.com/v1 liefert Links zu dieser Dokumentation und zur Spezifikation.
Inhalt dieser Dokumentation
- Schnellstart: von der Registrierung bis zum ersten Ergebnis.
- Authentifizierung und Schlüssel: Live- und Testschlüssel, Widerruf und Ausgabenlimits.
- Textprüfungen, Dateien und Analysen: die Wege, eine Prüfung auszuführen.
- Webhooks und Idempotenz: Verhalten im Produktivbetrieb.
- Beispielcode: vollständige Node.js- und Python-Programme für jede Prüfung und für Webhooks.
- Dokumentprüfungen in einem Eingangs-Workflow: Upload, Webhook, Weiterleitung nach Risikostufe, Prüfung durch Menschen und spätere Verifizierung.
- Fehler und Rate-Limits und Header.
- Preise und Abrechnung und Datenaufbewahrung und Sicherheit.
- Änderungsprotokoll und die API-Referenz.
Dieselben Prüfungen im Browser
Für eine Prüfung brauchen Sie die API nicht. Die Website bietet KI-generierte Bilder erkennen, Dokumentenprüfung und Bildforensik, und die Konsole führt alle drei Prüfungen aus und rechnet sie über Ihr Workspace-Guthaben ab.
Support
Schreiben Sie an hello@fileverity.com oder nutzen Sie die Kontaktseite und nennen Sie die Anfrage-ID (x-request-id), die Uhrzeit in UTC und den Endpunkt. Vorübergehende Fehler liefern 503 service_unavailable mit einem Header retry-after und werden nie berechnet. Sie brauchen höhere Limits oder Mengenpreise? Vertrieb kontaktieren.
Diese Dokumentation mit einem Agenten lesen
Jede Seite gibt es auch als Markdown: Hängen Sie .md an ihren Pfad an, zum Beispiel /de/docs/quickstart.md. Das Verzeichnis aller Seiten finden Sie unter /de/docs/llms.txt.