API REST / Détection d’IA

API du détecteur d’IA pour des signaux faciles à examiner

Envoyez un texte à un seul point de terminaison HTTPS et intégrez l’analyse des textes générés par IA à votre produit. Detector v3 renvoie des données structurées que votre équipe peut examiner, conserver et expliquer dans leur contexte.

Créer une clé API Lire la documentation

Utilisez la clé depuis un environnement serveur privé.

Requête cURL

curl --request POST \
  --url https://api.detecting-ai.com/api/detect/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: detector-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to analyze.",
    "version": "v3"
  }'

Requêtes POST vers /api/detect/

Authentification par X-API-Key

En-tête Idempotency-Key défini par le client pour reprendre une requête

Detector v3 pour les nouvelles intégrations

Requête et réponse en JSON

Conçue pour de vrais processus de vérification

Un contrat API simple qui laisse place au discernement

L’intégration reste simple : votre serveur envoie le texte, le détecteur l’analyse et votre interface choisit comment présenter le résultat. Cette séparation facilite les tests et laisse la décision finale à une personne.

Un point de terminaison bien défini

Ajoutez une chaîne de texte et une version du détecteur à une requête JSON. L’intégration de base ne nécessite aucun SDK à maintenir.

Une sortie structurée

Lisez les détails du détecteur, sa version et le nombre de mots traités dans la réponse, sans extraire des données d’une page web.

L’examen humain reste visible

Utilisez le signal pour hiérarchiser les passages et les dossiers. Ne transformez pas le score d’un modèle en accusation ou en rejet automatique.

Contrat de la requête

Deux champs suffisent pour commencer

Envoyez le texte UTF-8 au format JSON et choisissez délibérément la version du détecteur. Les nouvelles intégrations doivent utiliser v3.

Champ	Type	Obligatoire	Fonction
text	string	Oui	Le texte que le détecteur doit analyser.
version	string	Oui	La version du détecteur. Utilisez v3 pour une nouvelle intégration.

Conservez la réponse complète pendant le développement

Commencez par journaliser la réponse JSON complète dans un environnement de test sécurisé. Une fois le contrat bien compris, mappez uniquement les champs utilisés par votre produit et conservez le nombre de mots traités pour le suivi de l’usage.

Exemple de réponse

{
  "success": true,
  "data": {
    "details": {
      "result": "Detector analysis is returned here"
    },
    "version": "v3",
    "words_processed": 8
  }
}

Parcours d’intégration

De la clé API à un résultat exploitable

Construisez d’abord la requête sur votre serveur. Ajoutez l’interface du produit une fois le scénario nominal et les cas d’échec clairement définis.

1
Préparer, enregistrer et activer la clé
Préparez une clé dans le tableau de bord, copiez sa valeur à usage unique dans un gestionnaire de secrets côté serveur, confirmez son enregistrement, puis activez-la. Sa valeur complète ne sera plus affichée après l’activation.
2
Envoyer un exemple représentatif
Envoyez un texte réaliste en POST avec la version v3 et enregistrez une valeur Idempotency-Key unique avant l’envoi. Réutilisez-la uniquement pour relancer exactement la même requête.
3
Présenter les éléments avec prudence
Transformez la réponse structurée en un état de vérification clair, en laissant à une personne la possibilité d’examiner le texte et son contexte.

Cas adaptés

Utile partout où les textes passent déjà par une file de vérification

L’API donne les meilleurs résultats comme l’un des éléments d’un processus de décision existant. Elle doit aider à choisir où regarder, sans prendre la décision à la place des personnes.

La détection ne prouve pas l’identité de l’auteur

Les modèles peuvent se tromper, surtout sur un texte court, fortement remanié, traduit ou très conventionnel. Ne confiez pas les décisions importantes à un processus entièrement automatique.

Réception éditoriale

Ajoutez un signal sur l’origine possible aux brouillons reçus et confiez les cas inhabituels à un éditeur pour une lecture approfondie.

Plateformes éducatives

Affichez un signal à examiner à côté du contexte du devoir, de l’historique des révisions, des citations et des règles de l’établissement.

Modération interne

Vérifiez le texte transmis dans un processus privé sans envoyer votre clé API au navigateur.

Triage par lots

Traitez les documents en attente sur le serveur et faites ressortir les dossiers qui méritent un second examen manuel.

FAQ de l’API

Des réponses pratiques avant la mise en production

Commencez par une requête côté serveur, consignez la structure de la réponse, puis ajoutez le résultat à votre processus de vérification existant.

Quel point de terminaison utilise l’API du détecteur d’IA ?+

Envoyez une requête POST à https://api.detecting-ai.com/api/detect/. Le corps de la requête est en JSON, l’authentification utilise X-API-Key et les nouvelles intégrations doivent conserver une Idempotency-Key stable pour chaque opération logique.

Quelle version du détecteur faut-il utiliser pour une nouvelle intégration ?+

Utilisez v3 pour les nouvelles intégrations. La version figure dans le corps JSON de la requête afin que le comportement soit explicite et facile à tester.

Puis-je appeler directement l’API depuis du JavaScript dans le navigateur ?+

N’exposez pas une clé API privée dans le code du navigateur. Envoyez les requêtes depuis votre serveur, une fonction edge ou un autre environnement de confiance, puis ne renvoyez que le résultat nécessaire à votre interface.

Un score IA prouve-t-il qui a écrit le texte ?+

Non. La détection d’IA fournit un signal probabiliste. Utilisez-le pour concentrer la vérification sur certains passages, puis examinez les brouillons, les sources, l’historique de rédaction et le contexte.

Où consulter l’usage de l’API et le nombre de mots restants ?+

Le tableau de bord de l’API affiche le quota associé à votre abonnement. Chaque requête de détection réussie indique le nombre de mots d’entrée traités.

Construire la première requête

Effectuez une requête de test avant de concevoir le processus

Utilisez Detector v3, gardez la clé sur votre serveur et examinez la réponse JSON complète avec un texte proche de vos données réelles.

Ouvrir la documentation de l’API Comparer les tarifs