# Ü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.

Quelle: https://fileverity.com/de/docs

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](https://fileverity.com/de/docs/quickstart.md), um in wenigen Minuten Ihren ersten Aufruf zu senden, oder [fordern Sie einen Testschlüssel an](https://fileverity.com/console/keys?lang=de) und rufen Sie die API sofort auf. Eine Produktübersicht finden Sie auf der [API-Seite](https://fileverity.com/de/api), unter [KI-generierte Bilder per API erkennen](https://fileverity.com/de/api/ki-bilder-erkennen) und unter [Dokumentenfälschung per API erkennen](https://fileverity.com/de/api/dokumentenfaelschung-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](https://fileverity.com/de/api/ki-bilder-erkennen) | Hochladen mit [`POST /files`](https://fileverity.com/de/docs/files.md), danach [`POST /analyses`](https://fileverity.com/de/docs/analyses.md) |
| `fvdoc-3` (FVDOC V3) | Dokumente: von KI verfasster Text, eingebettete Fotos, Änderungsverlauf und Signaturen. Übersicht: [Dokumentenfälschung per API erkennen](https://fileverity.com/de/api/dokumentenfaelschung-erkennen) | Hochladen mit [`POST /files`](https://fileverity.com/de/docs/files.md), danach [`POST /analyses`](https://fileverity.com/de/docs/analyses.md) |
| `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`](https://fileverity.com/de/docs/text-detections.md) |

Preise, Limits und Snapshot-IDs finden Sie unter [Preise und Abrechnung](https://fileverity.com/de/docs/pricing.md).

## 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](https://fileverity.com/de/docs/authentication.md).
- **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](https://fileverity.com/de/kontakt).
- **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](https://api.fileverity.com/v1/openapi.json) beschrieben. Die [API-Referenz](https://fileverity.com/de/docs/api-reference.md) 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](https://fileverity.com/de/docs/quickstart.md): von der Registrierung bis zum ersten Ergebnis.
- [Authentifizierung und Schlüssel](https://fileverity.com/de/docs/authentication.md): Live- und Testschlüssel, Widerruf und Ausgabenlimits.
- [Textprüfungen](https://fileverity.com/de/docs/text-detections.md), [Dateien](https://fileverity.com/de/docs/files.md) und [Analysen](https://fileverity.com/de/docs/analyses.md): die Wege, eine Prüfung auszuführen.
- [Webhooks](https://fileverity.com/de/docs/webhooks.md) und [Idempotenz](https://fileverity.com/de/docs/idempotency.md): Verhalten im Produktivbetrieb.
- [Beispielcode](https://fileverity.com/de/docs/sample-code.md): vollständige Node.js- und Python-Programme für jede Prüfung und für Webhooks.
- [Dokumentprüfungen in einem Eingangs-Workflow](https://fileverity.com/de/docs/intake-workflow.md): Upload, Webhook, Weiterleitung nach Risikostufe, Prüfung durch Menschen und spätere Verifizierung.
- [Fehler](https://fileverity.com/de/docs/errors.md) und [Rate-Limits und Header](https://fileverity.com/de/docs/rate-limits.md).
- [Preise und Abrechnung](https://fileverity.com/de/docs/pricing.md) und [Datenaufbewahrung und Sicherheit](https://fileverity.com/de/docs/security.md).
- [Änderungsprotokoll](https://fileverity.com/de/docs/changelog.md) und die [API-Referenz](https://fileverity.com/de/docs/api-reference.md).

## Dieselben Prüfungen im Browser

Für eine Prüfung brauchen Sie die API nicht. Die Website bietet [KI-generierte Bilder erkennen](https://fileverity.com/de/ki-bilder-erkennen), [Dokumentenprüfung](https://fileverity.com/de/ki-dokumente-erkennen) und [Bildforensik](https://fileverity.com/de/manipulierte-bilder-erkennen), und die [Konsole](https://fileverity.com/console?lang=de) führt alle drei Prüfungen aus und rechnet sie über Ihr Workspace-Guthaben ab.

## Support

Schreiben Sie an [hello@fileverity.com](mailto:hello@fileverity.com) oder nutzen Sie die [Kontaktseite](https://fileverity.com/de/kontakt) 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](https://fileverity.com/de/kontakt).

## 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](https://fileverity.com/de/docs/llms.txt).

