Python 3
Download het Python-voorbeeldpython check-media.py photo.jpg basicGebruikt de standaardbibliotheek van Python.
Uw eerste foto- of videocontrole.
Maak een Business- of Developeraccount en open de developerconsole. Sandbox- en Live API-sleutels worden direct uitgegeven zolang de productie-API online is. Voeg bij Facturatie pas vóór uw eerste echte Live foto of video een betaalkaart toe.
Voer een volledig voorbeeld uit.
Bewaar een live-sleutel in de serveromgeving als DEEPFAKEPOLICY_API_KEY. Houd deze op uw server. Elk voorbeeld maakt een opdracht aan, uploadt het bestand, wacht op afronding en toont het rapport.
Node.js 22+
Download het JavaScript-voorbeeldnode check-media.mjs clip.mp4Gebruikt de ingebouwde fetch. Geen extra pakketten nodig.
curl
Download het shellvoorbeeldbash check-media.sh photo.jpg basicVereist curl, Bash en Python 3.
Koppel uw werkproces
Cross-check vanuit het systeem van uw team.
Importeer een n8n-workflow om een dossier in te dienen, de voortgang te volgen en de bevindingen met uw oorspronkelijke dossier-ID terug te ontvangen.
Lever het resultaat opnieuw, zonder nieuwe controle
De actie resume leest de opgeslagen opdracht. De bestanden worden niet opnieuw voor analyse ingediend.
n8n-workflow
Een dossier erin. Een gestructureerd resultaat terug.
- Stuur foto’s en documenten van een nieuw dossier.
- Ontvang het opdrachtnummer en volg de controle automatisch.
- Koppel het resultaat aan het oorspronkelijke dossier in uw systeem.
Maximaal 6 bestanden · 10 MiB per dossier · begrensde herhaalpogingen
Zo stelt u de koppeling in
- Importeer het JSON-bestand in n8n. De workflow is standaard uitgeschakeld.
- Stel aparte inloggegevens in voor de inkomende webhook en de zakelijke Live API via n8n Credentials.
- Kies het sjabloon in de aanvraag, stel de facturatie in en bepaal de zakelijke bestedingslimiet.
- Configureer de laatste node voor uw dossiersysteem, test de koppeling en activeer de workflow.
Bewaar het opdrachtnummer bij uw dossier. Vergelijkingsresultaten blijven zeven dagen na indiening beschikbaar. Uw n8n-installatie en het doelsysteem hebben hun eigen bewaartermijnen.
U configureert de bestemming en de bijbehorende inloggegevens. Er wordt niet automatisch een CRM gekoppeld. Afgeronde Live Cross-checks zijn betaald; de sandbox analyseert deze bestanden niet.
Bestanden en gebruik.
| Bestand | Limiet | Standaardcontrole | Met bronnenonderzoek |
|---|---|---|---|
| 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 seconden | € 0,04 per begonnen seconde · Minimum per video: € 0,50 | + € 1,25 |
30 s: € 1,20 · 60 s: € 2,40. De duur wordt uit het bestand gelezen en vergeleken met het analyseresultaat. Niet-ondersteunde of tegenstrijdige metagegevens leiden tot een verwerkingsfout zonder kosten.
Langere video’s worden verwerkt in opeenvolgende fragmenten van maximaal 30 seconden. Het rapport vermeldt welke tijdvakken zijn onderzocht en welke beperkingen daarbij gelden. Dit bevestigt niet dat elk afzonderlijk beeld is geanalyseerd. De oorspronkelijke video wordt één keer in rekening gebracht.
GIF-bestanden mogen maximaal 20 MB groot zijn; alleen het eerste frame wordt als PNG onderzocht. De overige animatieframes worden niet geanalyseerd.
serviceTier: "basic": Detectoranalyse; een aanvullende visuele beoordeling is niet inbegrepen. serviceTier: "full": Detectoranalyse en een afzonderlijke geautomatiseerde visuele beoordeling. Zonder serviceTier blijft Full actief voor compatibiliteit. Bronnenonderzoek vereist Full.
Gebruik analysisMode: "deep" om bronnenonderzoek toe te voegen. Afgerond gebruik wordt na verwerking aan het bedrijf gefactureerd. Een afgerond rapport met een onduidelijke uitkomst is ook een betaalde controle. Deze werkruimte wordt gefactureerd in EUR. Prijzen zijn exclusief toepasselijke belastingen.
Aanvragen en resultaten.
POST /v1/jobsmet een Bearer-sleutel, mediatype, bestandsnaam en eenIdempotency-Key. Gebruik dezelfde sleutel opnieuw als u dezelfde aanmaakaanvraag herhaalt.PUTde onbewerkte bestandsbytes naarlinks.upload, met het Content-Type van het bestand.GET /v1/jobs/{id}tot de status gelijk is aancompletedoffailed. Leesresult.evidenceReportna afronding.- Bewaar het rapport en gebruik eventueel daarna
DELETE /v1/jobs/{id}. De standaardbewaartermijn is 24 uur; stelretentionHoursin tussen 1 en 168. Exporteer JSON, tekst of PDF en maak rapporten in uw huisstijl.
Gebruik bij sandbox-aanvragen sandboxFixture: "suspicious" en sla de upload over. Sandbox-sleutels kunnen geen live-opdrachten lezen, uploaden of verwijderen. Live v1 verwerkt foto’s en video’s; andere vermelde mediatypen zijn alleen als vaste sandbox-voorbeelden beschikbaar.
Bronnenonderzoek levert bevindingen binnen hetzelfde rapportschema. Het stelt geen herkomst vast en garandeert geen echtheid.
Limieten, herhaalpogingen en meldingen.
Standaard gelden per bedrijf 60 nieuwe live-opdrachten per minuut en 20 gelijktijdige live-opdrachten. Alle bedrijfssleutels delen deze limieten. Voor de sandbox gelden 30 en 10. Aangepaste limieten staan in uw console. De maandelijkse bestedingslimiet telt afgerond en gereserveerd werk binnen de UTC-maand; mislukte verwerking geeft de reservering vrij. Rapporten verwijderen zet het gebruik niet terug.
Wacht bij HTTP 429 volgens Retry-After. Herhaal bij netwerkfouten tijdens het aanmaken met dezelfde idempotentiesleutel. Als een uploadantwoord verloren gaat, vraag dan eerst de opdracht op voordat u opnieuw uploadt. Controleer de bestaande opdracht na een time-out bij het opvragen van de status.
Stel voor afrondingsmeldingen een openbaar HTTPS-adres in als webhookUrl. Controleer HMAC-SHA256 over timestamp.rawBody met het webhookgeheim en DeepfakePolicy-Signature. Weiger verouderde tijdstempels, vergelijk handtekeningen in constante tijd en verwerk elke gebeurtenis-ID één keer. Geef 2xx terug nadat de gebeurtenis is opgeslagen. Herhaalpogingen volgen na 30 seconden, 5 minuten en 30 minuten.
Sleutels kunnen aanmaken/lezen/verwijderen, aanmaken/lezen of alleen lezen. Eigenaren en beheerders kunnen sleutels aanmaken en intrekken. Maak bij rotatie eerst een vervangende sleutel aan, neem die in gebruik en trek daarna de oude in. Intrekken stopt API-toegang en wachtende webhookleveringen voor die sleutel. Aanvragen en leveringen die al lopen, kunnen nog afronden.