Documentation du développeur

Disponibilité

La production API est ouverte. Un compte vérifié, une clé API, des crédits disponibles et une capacité de traitement sont requis. Les limites de capacité temporaires renvoient 503 avant le traitement ; réessayez plus tard avec le même identifiant de demande.

Contacter un accompagnement pour votre intégration. Aucun achat ou demande API n’est effectué à partir de cette documentation.

Authentification

Utilisez une clé Check AI dans le Autorisation en-tête de votre serveur. Ne le placez jamais dans un bundle de navigateur, un référentiel public ou un message d'assistance. URL de base : https://checkai-app.com.

Authorization: Bearer YOUR_CHECKAI_API_KEY

Une fois l'accès activé, les comptes vérifiés peuvent créer jusqu'à cinq clés actives dans le console développeur. Les clés sont affichées une fois, stockées sous forme de hachages et expirent après un an. Faites pivoter en créant un remplacement et en révoquant l'ancienne clé. Les clés de test ne peuvent pas accéder à la production. Les jetons de session de site Web ne sont pas des clés de développeur.

Points de terminaison

Envoyez du JSON avec un seul texte chaîne. La détection accepte 30 à 2 000 mots ; l’humanisation en accepte 10 à 2 000. Les deux sont limités à 20 000 caractères. Les mots sont comptés en divisant le texte coupé sur des espaces. Les paramètres de téléchargement, de streaming et de réécriture personnalisée ne sont pas pris en charge.

Demander des exemples

Ces exemples nécessitent un API activé et une vraie clé. Le bouton Copier copie uniquement le texte.

# Server-side request; requires a valid key and credits.
curl https://checkai-app.com/api/v1/humanize \
  -H "Authorization: Bearer YOUR_CHECKAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{"text":"Clear writing starts with one useful idea and a careful review."}'

Exemple de réponse d'humanisation

{
  "request_id": "example-request-id",
  "status": "succeeded",
  "usage": {
    "input_words": 12,
    "credits": 48
  },
  "result": {
    "text": "Good writing begins with a useful idea, followed by careful editing."
  }
}

Réponse illustrative. Retours de détection résultat.ai_percentage (0–100), résultat.faits saillants (passages de texte) et résultat.explication.

Crédits et tentatives

Les crédits sont réservés avant traitement, facturés en cas de succès confirmé et restitués après un rejet confirmé. Un délai d'attente ambigu conserve la réservation pour révision. Les achats créditent ce solde distinct uniquement après une notification Stripe vérifiée ; le retour de la caisse ne crédite pas un compte.

Chaque POST nécessite un Clé d'idempotence: 16 à 128 lettres, chiffres, traits de soulignement ou traits d'union. Utilisez un identifiant par requête logique. Une répétition identique renvoie son état enregistré sans un deuxième appel du fournisseur. Le réutiliser avec un texte différent ou un outil différent renvoie 409.

Une réponse 202 inclut un ID de demande. Vérifiez-le avec GET ; ne soumettez pas à nouveau sous une nouvelle clé. Contactez le support s'il reste en attente. Les résultats sont disponibles pendant sept jours ; après cela, une demande réussie renvoie 410 et n'est jamais automatiquement soumise à nouveau.

Les crédits inutilisés n’ont pas d’expiration prévue et ne peuvent pas être transférés entre comptes. Les taxes applicables sont indiquées à la caisse. Consultez nos conditions pour connaître les droits de rétractation, les remboursements et les recours en matière de service.

Erreurs et limites

Au maximum deux demandes de traitement non résolues et 30 nouvelles demandes de traitement par minute et par compte. Des limites supplémentaires en matière de compte, de clé et d'adresse IP s'appliquent. Les demandes du fournisseur expirent après 30 secondes ; accordez au moins 45 secondes à votre client.

202

En attente ou non confirmé : vérifiez l'ID de la demande

400 / 415

Texte, clé d'idempotence ou type de contenu JSON non valide

401 / 403

Clé invalide, compte non vérifié ou indisponible

402

Crédits API insuffisants

409

Conflit d'idempotence ou deux demandes non résolues

410

Le résultat enregistré a expiré ; pas de traitement répété

429

Limite de débit : attendez avant de réessayer

502

Rejet confirmé ; crédits retournés

503

API fermé, stockage indisponible ou capacité de traitement épuisée

Texte et confidentialité

Le traitement nécessite l'envoi du texte soumis aux serveurs de Check AI et à un processeur IA externe. Soumettez uniquement le contenu que vous êtes autorisé à traiter. N'incluez pas de secrets ou de données personnelles inutiles.

Pour les requêtes API, Check AI ne stocke pas le texte d'entrée soumis. Les résultats sont disponibles pendant sept jours et supprimés par un nettoyage quotidien. Les identifiants de demande, les empreintes digitales, les enregistrements d'utilisation et de facturation sont conservés à des fins de déduplication et de comptabilité. API les clés sont stockées sous forme de hachages. La suppression du compte supprime les clés et les résultats du développeur, sous réserve de conservation comptable et légale. Aucune promesse de rétention zéro ni aucun accord de niveau de service de disponibilité n'est proposé. Voir le informations actuelles sur la confidentialité du site Web pour le service Check AI existant.

La détection par l’IA ne peut pas établir la paternité avec certitude. La réécriture ne garantit pas l’exactitude factuelle, l’originalité ou une classification humaine par aucun détecteur.