API du détecteur d’IA et documentation MCP

Accès

Authentification

Les requêtes REST et les clients MCP locaux utilisent les clés API des clients dans des en-têtes différents. Les connecteurs MCP hébergés détectent OAuth et ouvrent un parcours d’autorisation dans le navigateur.

Sécurité de l’usage

Relancer une requête sans payer deux fois

Les nouvelles intégrations doivent envoyer une valeur Idempotency-Key unique pour chaque requête REST logique et conserver cette valeur jusqu’à la réussite ou à l’abandon de la requête. Si la connexion est interrompue, relancez exactement le même point de terminaison avec le même texte, la même version ou le même modèle, ainsi que la même clé. Une répétition identique renvoie la réponse enregistrée sans solliciter de nouveau le fournisseur ni décompter les mots une seconde fois.

Tant que le premier appelant détient encore le bail du fournisseur, une tentative identique et simultanée renvoie HTTP 409 avec Retry-After. Une fois l’opération terminée, la réponse exacte peut être rejouée pendant 24 heures. Lorsque ce contenu privé expire, la même clé renvoie HTTP 410. Un marqueur permanent empêche toujours un second débit.

Point de terminaison REST

API du détecteur d’IA

Analysez le texte transmis pour repérer des motifs associés aux textes générés par IA. Les résultats sont des signaux probabilistes à examiner, pas une preuve de l’identité de l’auteur.

Corps de la requête

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"
  }'

Réponse

{
  "success": true,
  "data": {
    "details": {
      "chunks": [
        {
          "text": "A sentence from the input.",
          "startChar": 0,
          "endChar": 26,
          "type": "AI",
          "score": 0.87
        }
      ],
      "ai_percentage": 42.5
    },
    "version": "v3",
    "words_processed": 120
  }
}

Lire la présentation de l’API du détecteur d’IA

Point de terminaison REST

API d’humanisation de texte IA

Réécrivez le texte transmis avec le modèle d’humanisation choisi. Le résultat reste modifiable et doit être vérifié quant au sens, aux faits, aux noms, aux liens, au ton et à la terminologie requise.

Corps de la requête

curl --request POST \
  --url https://api.detecting-ai.com/api/humanize/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: humanizer-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to rewrite.",
    "model": "cognia"
  }'

Réponse

{
  "humanized_text": "The rewritten text is returned here.",
  "words_processed": 120,
  "model_used": "cognia"
}

Lire la présentation de l’API d’humanisation de texte IA

Point de terminaison REST

API de détection de plagiat

Recherchez les ressemblances phrase par phrase et renvoyez le contexte de la source lorsqu’une correspondance est trouvée. Une personne doit examiner chaque correspondance, car les citations, les références, les autorisations et les formulations courantes en modifient le sens.

Corps de la requête

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

Réponse

{
  "result": {
    "results": [
      {
        "sentence": "A sentence from the input.",
        "is_plagiarised": true,
        "web_sentence": "A similar source sentence.",
        "similarity": 91.0,
        "link": "https://example.com/source"
      }
    ],
    "plagiarism_score": 34.2
  },
  "words_processed": 120
}

Lire la présentation de l’API de détection de plagiat

Streamable HTTP

Serveur MCP distant

Un serveur distant expose exactement deux outils : detect_ai_text et humanize_text. La détection de plagiat est disponible via REST, pas via MCP.

Connecteurs hébergés

Ajoutez uniquement l’URL MCP dans un connecteur hébergé. Le client détecte OAuth, ouvre les écrans de connexion et de consentement dans le navigateur, puis conserve ses propres jetons. N’ajoutez aucune clé API ni autre identifiant à l’URL.

Codex

export DETECTING_AI_API_KEY="YOUR_API_KEY"

[mcp_servers.detecting_ai]
url = "https://api.detecting-ai.com/api/mcp"
bearer_token_env_var = "DETECTING_AI_API_KEY"
tool_timeout_sec = 300

Claude Code

claude mcp add --transport http --scope user \
  --header "Authorization: Bearer YOUR_API_KEY" \
  detecting-ai https://api.detecting-ai.com/api/mcp

Gestion des échecs

Erreurs

Vérifiez à la fois le statut HTTP et le corps de la réponse. Les corps d’erreur ne sont pas encore harmonisés dans un format universel.

Quotas et limites

Usage et limites

L’usage est décompté selon le nombre de mots d’entrée séparés par des espaces. Les quotas de détection, d’humanisation et de plagiat sont propres à chaque fonctionnalité, même lorsqu’une clé donne accès à plusieurs produits.

• Consultez les mots restants et les offres actives dans le tableau de bord de l’API.
• MCP utilise le même quota de détection ou d’humanisation que l’API REST correspondante.
• REST et MCP limitent par défaut le texte à 160 000 caractères. MCP applique aussi une limite de transport de 1 Mio pour le corps. Divisez les documents exceptionnellement longs en sections cohérentes.