Parcourir la documentation

Documentation API TurnitPass

Commencez avec les clés API, appelez les endpoints de révision, vérification, paraphrase, citation et bibliographie, puis intégrez TurnitPass dans votre application.

REST API v1

One request

Quick example

Envoyez du texte à l’endpoint humanizer avec une clé API Bearer. La réponse renvoie le texte transformé, les mots utilisés et le solde restant du titulaire de la clé.

curl

POST /api/v1/humanize

1curl -X POST https://turnitpass.com/api/v1/humanize \
2  -H "Authorization: Bearer tp_live_your_api_key" \
3  -H "Content-Type: application/json" \
4  -d '{"text":"Paste your draft here","language":"en","mode":"revise"}'

response

200 OK

1{
2  "output": "Your humanized text...",
3  "words_used": 6,
4  "words_remaining": 249994
5}

TurnitPass expose aussi les endpoints paraphrase, rewrite, detector, citation, bibliography et status avec le même flux de clé API.

Route map

Explore the docs

Démarrage rapide

Créez une clé API depuis l’espace de travail, puis appelez les endpoints d’écriture, de vérification et de citation avec la même clé.

Authentification

Les requêtes de développement utilisent des clés API générées depuis l’espace de travail TurnitPass.

Référence API

Référence pour les endpoints authentifiés de révision, paraphrase, vérification des signaux, citation, bibliographie et statut de clé.

Changelog

Modifications récentes apportées à l’humaniseur, au détecteur, aux outils d’écriture, à la facturation et aux interfaces API.

Faites votre première requête de révision

Créez une clé et envoyez la première requête.

API REST TurnitPass

Consultez endpoints, paramètres, limites et formes de réponse.

Étape suivante

Request lifecycle

Chaque appel API TurnitPass suit le même parcours : authentifier la clé, valider le payload, exécuter le flux d’écriture ou de citation, mesurer l’usage, puis renvoyer une forme de réponse que votre produit peut stocker.

Authentifier la clé API

Envoyez une clé générée depuis l’espace de travail. Les clés révoquées, malformées ou absentes échouent avant le traitement du texte.

Valider le texte, la langue et les limites

Les requêtes de transformation appliquent des plages de mots, les requêtes detector des limites de scan plus longues, et les requêtes citation valident le style et la source.

Exécuter le flux

Les routes humanize, paraphrase, rewrite, detect, citation et bibliography réutilisent le même comportement serveur que les outils publics.

Enregistrer l’usage et renvoyer le résultat

Les appels réussis renvoient le résultat plus des métadonnées d’usage : mots utilisés, solde restant, statut ou exports de citations formatés.

API

Endpoints principaux

Réviser

POST/api/v1/humanize

Atténue les signaux de rédaction IA tout en préservant le sens.

Paraphraser

POST/api/v1/paraphrase

Réécrit et peaufine le texte selon plusieurs modes.

Vérifier

POST/api/v1/detect

Retourne un score estimé, le niveau de risque et les signaux de style.

Citations

POST/api/v1/citation

Formate les métadonnées de sources DOI, URL ou manuelles.

Production checklist

Appels côté serveur

N’exposez jamais les clés API dans le clientAppelez TurnitPass depuis votre backend, worker, file d’attente ou server action protégée.

Comportement de retry

Relancez les pannes réseau, pas les échecs de validationTraitez les réponses 4xx comme des problèmes d’utilisateur ou de payload ; réservez les retries aux erreurs 5xx ou réseau transitoires.

Budget de mots

Affichez le solde avant les flux lourdsUtilisez l’endpoint status pour décider s’il faut mettre en file, proposer une montée de plan ou découper le document.

Facturation

Les secrets Stripe sont la configuration finaleCheckout, portal et webhook sont branchés ; les clés live et price ID restent à renseigner au déploiement.

Pour une intégration produit, gardez une clé TurnitPass par environnement. Production, staging et développement local doivent pouvoir être révoqués indépendamment.

Ensuite, intégrez-le à votre flux.Continuer la lecture