Python 3
Python-Beispiel herunterladenpython check-media.py photo.jpg basicVerwendet die Python-Standardbibliothek.
Ihre erste Bild- oder Videoprüfung.
Erstellen Sie ein Unternehmens- oder Entwicklerkonto und öffnen Sie die Entwicklerkonsole. Dort können Sie sofort Sandbox- und Live-API-Schlüssel erstellen. Testen Sie zunächst mit kostenlosen Sandbox-Beispielen. Bevor Sie eigene Bilder oder Videos prüfen, hinterlegen Sie unter Abrechnung eine Zahlungskarte.
Vollständiges Beispiel ausführen.
Speichern Sie einen Live-Schlüssel in der Serverumgebung als DEEPFAKEPOLICY_API_KEY. Der Schlüssel bleibt auf Ihrem Server. Jedes Beispiel erstellt einen Auftrag, lädt die Datei hoch, wartet auf den Abschluss und gibt den Bericht aus.
Node.js 22+
JavaScript-Beispiel herunterladennode check-media.mjs clip.mp4Verwendet natives fetch. Keine zusätzlichen Pakete erforderlich.
curl
Shell-Beispiel herunterladenbash check-media.sh photo.jpg basicBenötigt curl, Bash und Python 3.
Arbeitsablauf anbinden
Cross-check direkt aus dem System Ihres Teams.
Importieren Sie einen n8n-Workflow, um einen Vorgang einzureichen, die Prüfung zu verfolgen und die Befunde mit Ihrer ursprünglichen Vorgangs-ID zurückzugeben.
Ergebnis erneut zustellen, ohne neue Prüfung
Die Aktion resume liest den gespeicherten Auftrag. Sie reicht die Dateien nicht erneut zur Analyse ein.
n8n-Workflow
Dateien übermitteln und Ergebnisse dem richtigen Vorgang zuordnen.
- Fotos und Dokumente eines neuen Vorgangs übermitteln.
- Die Auftrags-ID erhalten und den Fortschritt automatisch verfolgen.
- Das Ergebnis dem ursprünglichen Vorgang in Ihrem System zuordnen.
Bis zu 6 Dateien · 10 MiB pro Vorgang · begrenzte Wiederholungen
So richten Sie die Verbindung ein
- Importieren Sie die JSON-Datei in n8n. Der Workflow ist zunächst inaktiv.
- Hinterlegen Sie getrennte Zugangsdaten für den eingehenden Webhook und die Firmen-Live-API unter n8n Credentials.
- Wählen Sie die Vorlage in der Anfrage, richten Sie die Abrechnung ein und setzen Sie das Ausgabenlimit der Firma.
- Konfigurieren Sie den letzten Knoten für Ihr Vorgangssystem, testen Sie die Zuordnung und aktivieren Sie den Workflow.
Speichern Sie die Auftrags-ID beim Vorgang. Vergleichsergebnisse sind ab Einreichung sieben Tage verfügbar. Für n8n und das Zielsystem gelten eigene Aufbewahrungseinstellungen.
Sie richten das Zielsystem und dessen Zugangsdaten ein. Eine CRM-Verbindung wird nicht automatisch hergestellt. Abgeschlossene Live-Prüfungen sind kostenpflichtig; die Sandbox analysiert diese Dateien nicht.
Dateien und Nutzung.
| Datei | Grenze | Standardprüfung | Mit Quellenrecherche |
|---|---|---|---|
| JPG, PNG, WebP | 50 MiB | Basic 0,06 € · Full 0,12 € | Full + 0,75 € |
| GIF | 20 MB | Basic 0,06 € · Full 0,12 € | Full + 0,75 € |
| MP4, MOV, M4V | 200 MB, 60 Sekunden | 0,04 € pro angefangener Sekunde · Mindestpreis pro Video: 0,50 € | + 1,25 € |
30 s: 1,20 € · 60 s: 2,40 €. Die Dauer wird aus der Datei gelesen und mit der Analyseantwort abgeglichen. Nicht unterstützte oder widersprüchliche Metadaten führen zu einem Fehler ohne Berechnung.
Längere Videos werden in aufeinanderfolgenden Abschnitten von höchstens 30 Sekunden verarbeitet. Der Bericht zeigt, welche Abschnitte erfasst wurden und wo die Prüfung eingeschränkt war. Eine Prüfung jedes einzelnen Bildes ist nicht nachgewiesen. Die Videodatei wird nur einmal abgerechnet.
GIF-Dateien sind auf 20 MB begrenzt; nur das erste Bild wird als PNG geprüft. Die übrigen Animationsbilder werden nicht analysiert.
serviceTier: "basic": Detektoranalyse; eine zusätzliche visuelle Prüfung ist nicht enthalten. serviceTier: "full": Detektoranalyse und eine separate automatisierte visuelle Prüfung. Ohne serviceTier bleibt Full aus Kompatibilitätsgründen aktiv. Quellenrecherche erfordert Full.
Setzen Sie analysisMode: "deep" für zusätzliche Quellenrecherche. Abgeschlossene Nutzung wird der Firma nach Verarbeitung berechnet. Ein abgeschlossener Bericht mit unklarem Ergebnis ist ebenfalls kostenpflichtig. Dieser Arbeitsbereich wird in EUR abgerechnet. Preise zuzüglich anfallender Steuern.
Anfragen und Ergebnisse.
POST /v1/jobsmit Bearer-Schlüssel, Modalität, Dateiname und einemIdempotency-Key. Verwenden Sie diesen Schlüssel erneut, wenn Sie dieselbe Erstellungsanfrage wiederholen.PUTmit den Rohdaten der Datei anlinks.upload, mit dem Content-Type der Datei.GET /v1/jobs/{id}bis zum Statuscompletedoderfailed. Lesen Sieresult.evidenceReportnach erfolgreichem Abschluss.- Speichern Sie den Bericht. Optional danach:
DELETE /v1/jobs/{id}. Die Aufbewahrung beträgt standardmäßig 24 Stunden; setzen SieretentionHourszwischen 1 und 168. JSON, Text oder PDF exportieren und eigene Berichte gestalten.
Für Sandbox-Anfragen verwenden Sie sandboxFixture: "suspicious" und lassen den Upload aus. Sandbox-Schlüssel können keine Live-Aufträge lesen, hochladen oder löschen. Live v1 verarbeitet Bilder und Videos; andere aufgeführten Modalitäten stehen nur als Sandbox-Beispiele bereit.
Quellenrecherche liefert Befunde im selben versionierten Bericht. Sie belegt keine Herkunft und garantiert keine Echtheit.
Limits, Wiederholungen und Benachrichtigungen.
Standardlimits: 60 neue Live-Aufträge pro Minute und 20 gleichzeitig aktive Live-Aufträge pro Firma. Alle Firmenschlüssel teilen sich diese Limits. Für die Sandbox gelten 30 und 10. Individuelle Limits stehen in der Konsole. Das monatliche Ausgabenlimit zählt abgeschlossene und reservierte Nutzung im UTC-Monat; Fehler geben die Reservierung frei. Das Löschen eines Berichts setzt die Nutzung nicht zurück.
Warten Sie bei HTTP 429 entsprechend Retry-After. Wiederholen Sie eine Auftragserstellung nach einem Netzwerkfehler mit demselben Idempotenzschlüssel. Geht die Upload-Antwort verloren, rufen Sie vor einem erneuten Upload den Auftrag ab. Prüfen Sie nach einer Zeitüberschreitung den bestehenden Auftrag.
Für Abschlussmeldungen setzen Sie eine öffentliche HTTPS-Adresse als webhookUrl. Prüfen Sie HMAC-SHA256 über timestamp.rawBody mit dem Webhook-Geheimnis und dem Header DeepfakePolicy-Signature. Verwerfen Sie veraltete Zeitstempel, vergleichen Sie Signaturen in konstanter Zeit und verarbeiten Sie jede Ereignis-ID nur einmal. Antworten Sie nach dem Speichern mit 2xx. Wiederholungen folgen nach 30 Sekunden, 5 Minuten und 30 Minuten.
Schlüssel können erstellen/lesen/löschen, erstellen/lesen oder nur lesen. Eigentümer und Administratoren können Schlüssel erstellen und widerrufen. Erstellen und integrieren Sie beim Wechsel zunächst einen neuen Schlüssel und widerrufen Sie dann den alten. Der Widerruf beendet den API-Zugriff und ausstehende Webhook-Zustellungen. Bereits laufende Anfragen oder Zustellungen können noch abschließen.