Zum Inhalt springen

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.

Als Markdown ansehenAktualisiert am 2026-11-04

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

ModellWas geprüft wirdAufruf
fvimg-2 (FVIMG V2)Bilder: KI-Erzeugung, lokale Bearbeitungen, Content Credentials und Metadaten. Übersicht: KI-generierte Bilder per API erkennenHochladen 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 erkennenHochladen 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-PassagenEin 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 als error.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-2 verweist 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 als model ü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

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.