Python 3
Télécharger l’exemple Pythonpython check-media.py photo.jpg basicUtilise la bibliothèque standard de Python.
Votre première analyse photo ou vidéo.
Créez un compte Entreprise ou Développeur et ouvrez la console développeur. Les clés API Sandbox et Live sont délivrées immédiatement lorsque l’API de production est disponible. Ajoutez une carte dans Facturation uniquement avant d’envoyer votre première vraie photo ou vidéo Live.
Exécutez un exemple complet.
Enregistrez une clé de production dans l’environnement serveur sous le nom DEEPFAKEPOLICY_API_KEY. Conservez-la sur votre serveur. Chaque exemple crée une analyse, importe le fichier, attend la fin du traitement et affiche le rapport.
Node.js 22+
Télécharger l’exemple JavaScriptnode check-media.mjs clip.mp4Utilise la fonction fetch native. Aucun paquet supplémentaire requis.
curl
Télécharger l’exemple shellbash check-media.sh photo.jpg basicNécessite curl, Bash et Python 3.
Connectez votre processus
Cross-check depuis l’outil de votre équipe.
Importez un workflow n8n pour transmettre un dossier, suivre son traitement et récupérer les résultats avec votre identifiant de dossier d’origine.
Renvoyer le résultat sans nouvelle analyse
L’action resume consulte l’analyse enregistrée. Elle ne soumet pas les fichiers à une nouvelle analyse.
Workflow n8n
Un dossier envoyé. Un résultat structuré reçu.
- Transmettez les photos et documents d’un nouveau dossier.
- Recevez l’identifiant de l’analyse, puis suivez son avancement automatiquement.
- Rattachez les résultats au dossier d’origine dans votre outil.
Jusqu’à 6 fichiers · 10 Mio par dossier · tentatives limitées
Configurer la connexion
- Importez le fichier JSON dans n8n. Le workflow est désactivé par défaut.
- Configurez des identifiants distincts pour le webhook entrant et l’API Live de l’entreprise dans n8n Credentials.
- Choisissez le modèle dans la requête, configurez la facturation et fixez le plafond de dépenses de l’entreprise.
- Configurez le dernier nœud pour votre outil, testez la correspondance des dossiers et activez le workflow.
Conservez l’identifiant de l’analyse avec votre dossier. Les résultats restent disponibles sept jours après l’envoi. Votre instance n8n et l’outil destinataire ont leurs propres règles de conservation.
Vous configurez la destination et ses identifiants. Aucun CRM n’est connecté automatiquement. Les Cross-checks Live terminés sont facturables ; le sandbox n’analyse pas ces fichiers.
Formats, limites et tarifs.
| Fichier | Limite | Analyse standard | Avec recherche de sources |
|---|---|---|---|
| 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 secondes | 0,04 € par seconde entamée · Minimum par vidéo: 0,50 € | + 1,25 € |
30 s: 1,20 € · 60 s: 2,40 €. La durée est lue dans le fichier et comparée à la réponse d’analyse. Des métadonnées non prises en charge ou incohérentes font échouer l’analyse et ne sont pas facturées.
Les vidéos longues sont analysées par extraits successifs de 30 secondes maximum. Le rapport précise les passages examinés et les limites de l’analyse, sans garantir que chaque image a été vérifiée. La vidéo source n’est facturée qu’une fois.
Les fichiers GIF sont limités à 20 Mo ; seule la première image est analysée, au format PNG. Les autres images de l’animation ne sont pas examinées.
serviceTier: "basic": Analyse par détecteur ; l’examen visuel complémentaire n’est pas inclus. serviceTier: "full": Analyse par détecteur et examen visuel automatisé distinct. Sans serviceTier, Full reste sélectionné pour préserver la compatibilité. La recherche de sources nécessite Full.
Définissez analysisMode: "deep" pour inclure la recherche de sources. L’utilisation terminée est facturée à l’entreprise après traitement. Un rapport terminé mais non concluant est une analyse terminée et facturable. Cet espace est facturé en EUR. Les prix s’entendent hors taxes applicables.
Requêtes et résultats.
POST /v1/jobsavec une clé Bearer, le type de média, le nom du fichier et unIdempotency-Key. Réutilisez cette clé lors d’une nouvelle tentative de la même requête de création.PUTles octets bruts du fichier verslinks.upload, avec le Content-Type du fichier.GET /v1/jobs/{id}jusqu’à ce que le statut soitcompletedoufailed. Lisezresult.evidenceReportà la fin du traitement.- Enregistrez le rapport, puis utilisez éventuellement
DELETE /v1/jobs/{id}. La conservation est de 24 heures par défaut ; définissezretentionHoursentre 1 et 168. Exportez en JSON, texte ou PDF et créez des rapports à votre marque.
Pour les requêtes sandbox, incluez sandboxFixture: "suspicious" et omettez l’importation. Les clés sandbox ne permettent pas de lire, d’importer ou de supprimer des analyses de production. La v1 de production traite les photos et vidéos ; les autres types de médias mentionnés ne sont disponibles que sous forme d’exemples sandbox fixes.
La recherche de sources fournit ses constats dans le même rapport versionné. Elle n’établit pas la provenance et ne garantit pas l’authenticité.
Limites, nouvelles tentatives et notifications.
Par défaut, chaque entreprise peut créer 60 analyses de production par minute et en avoir 20 actives simultanément. Toutes ses clés partagent ces limites. Les limites sandbox sont de 30 et 10. La console affiche les éventuelles limites personnalisées. Le plafond mensuel compte les analyses terminées et réservées sur le mois UTC ; un échec libère la réservation. Supprimer un rapport ne remet pas la consommation à zéro.
En cas de réponse HTTP 429, respectez le délai de Retry-After. Si la création d’une analyse échoue à cause du réseau, réessayez avec la même clé d’idempotence. Si la réponse à l’importation est perdue, récupérez l’analyse avant de renvoyer le fichier. Après un délai d’attente dépassé lors de l’interrogation, vérifiez l’analyse existante.
Pour recevoir une notification de fin, définissez une adresse HTTPS publique dans webhookUrl. Vérifiez HMAC-SHA256 sur timestamp.rawBody avec le secret du webhook et DeepfakePolicy-Signature. Rejetez les horodatages périmés, comparez les signatures en temps constant et dédupliquez l’identifiant d’événement. Renvoyez 2xx après avoir enregistré l’événement. Les nouvelles tentatives ont lieu après 30 secondes, 5 minutes et 30 minutes.
Les clés autorisent la création/lecture/suppression, la création/lecture ou la lecture seule. Les propriétaires et administrateurs peuvent créer et révoquer les clés. Pour une rotation, créez une clé de remplacement, déployez-la, puis révoquez l’ancienne. La révocation bloque l’accès API et les webhooks encore en attente associés à cette clé. Les requêtes ou livraisons déjà en cours peuvent se terminer.