Documentation de l’API Fileverity
Vue d’ensemble
L’API Fileverity vérifie des images, des documents et du texte brut pour y repérer la génération par IA, les falsifications et les passages rédigés par IA. URL de base, modèles, conventions et par où commencer.
L’API Fileverity permet à vos logiciels de vérifier des images, des documents et du texte brut avec les modèles Fileverity. Une seule clé d’API et un seul solde d’espace de travail prépayé couvrent tous les modèles. Les résultats d’images et de documents sont les mêmes rapports que ceux du site, chacun avec un ID de rapport, un horodatage RFC 3161 et une page de vérification publique.
Vous découvrez l’API ? Suivez le Démarrage rapide pour effectuer votre premier appel en quelques minutes, ou obtenez une clé de test et appelez l’API tout de suite. Pour une présentation du produit, consultez la page API, l’API de détection d’images IA et l’API de détection de fraude documentaire.
Modèles
| Modèle | Vérifications | Mode d’appel |
|---|---|---|
fvimg-2 (FVIMG V2) | Images : génération par IA, retouches locales, Content Credentials et métadonnées. Présentation : API de détection d’images IA | Téléversez avec POST /files, puis POST /analyses |
fvdoc-3 (FVDOC V3) | Documents : texte rédigé par IA, photos intégrées, historique des modifications et signatures. Présentation : API de détection de fraude documentaire | Téléversez avec POST /files, puis POST /analyses |
fvdoc-3-text (FVDOC V3 Text) | Texte brut : rédigé par IA, en partie rédigé par IA ou rédigé par une personne, avec les passages rédigés par IA signalés | Un seul appel synchrone à POST /text/detections |
Les tarifs, les limites et les ID d’instantané figurent sur Tarifs et facturation.
Conventions
- URL de base.
https://api.fileverity.com/v1. HTTPS uniquement. - Format. Les requêtes sont en JSON, sauf les téléversements de fichiers, qui sont en multipart. Les réponses sont en JSON, sauf le rapport PDF. Les horodatages sont exprimés en secondes Unix, sauf dans
result.report, où les heures sont au format ISO 8601 en UTC. - Authentification. Une clé d’API Bearer dans l’en-tête
Authorization. Voir Authentification et clés. - ID. Chaque objet porte un préfixe :
file_pour les fichiers,an_pour les analyses,tdet_pour les détections de texte,evt_pour les événements webhook,req_pour les requêtes. Les ID de rapport ont la formeFV-XXXX-XXXX-XXXX. - ID de requête. Chaque réponse comporte un en-tête
x-request-id, et chaque erreur le reprend danserror.request_id. Indiquez-le lorsque vous contactez l’assistance. - Vérifications, analyses et rapports. Une vérification est ce que vous lancez et payez : une vérification d’image, de document ou de texte. Dans l’API, une analyse correspond à une vérification d’image ou de document, et une détection de texte à une vérification de texte. Les vérifications d’images et de documents produisent un rapport complet ; une vérification de texte produit un résultat.
- Versions. La version figure dans l’URL. De nouveaux champs et points d’accès peuvent être ajoutés à la v1 : ignorez donc les champs que vous ne reconnaissez pas. Un ID de modèle tel que
fvimg-2pointe vers un instantané daté (fvimg-2-2026-10-30). Les résultats indiquent l’instantané qui les a produits, et vous pouvez figer une requête sur un instantané en transmettant son ID dansmodel. - Langues. La détection de texte accepte en, fr, de, es, zh.
Spécification OpenAPI
L’API est décrite par un document OpenAPI 3.1 disponible à l’adresse https://api.fileverity.com/v1/openapi.json. La référence de l’API est générée à partir de ce document : les deux concordent donc toujours. Le document peut être chargé depuis un navigateur ; des outils comme Swagger UI et Postman peuvent donc l’importer à partir de son URL, et GET https://api.fileverity.com/v1 renvoie des liens vers cette documentation et vers la spécification.
Contenu de cette documentation
- Démarrage rapide : de l’inscription au premier résultat.
- Authentification et clés : clés Live et clés de test, révocation et limites de dépense.
- Détections de texte, Fichiers et Analyses : les différentes façons de lancer une vérification.
- Webhooks et Idempotence : comportement en production.
- Exemples de code : programmes Node.js et Python complets pour chaque vérification et pour les webhooks.
- Vérifications de documents dans un processus de réception : téléversement, webhook, aiguillage selon le niveau de risque, examen humain et vérification ultérieure.
- Erreurs et Limites de débit et en-têtes.
- Tarifs et facturation et Conservation des données et sécurité.
- Journal des modifications et la référence de l’API.
Les mêmes vérifications dans le navigateur
Vous n’avez pas besoin de l’API pour lancer une vérification. Le site propose Vérifier une image, Vérification documentaire et Vérification d’images, et la Console lance les trois vérifications sur le solde de votre espace de travail.
Assistance
Écrivez à hello@fileverity.com ou utilisez la page de contact, en indiquant l’ID de requête (x-request-id), l’heure en UTC et le point d’accès. Les défaillances temporaires renvoient 503 service_unavailable avec un en-tête retry-after et ne sont jamais facturées. Besoin de limites plus élevées ou de tarifs sur volume ? Contactez l’équipe commerciale.
Lire cette documentation avec un agent IA
Chaque page est aussi disponible en Markdown : ajoutez .md à son chemin, par exemple /fr/docs/quickstart.md. L’index de toutes les pages se trouve à l’adresse /fr/docs/llms.txt.