Aller au contenu
TurnitPass
DéveloppeursAPI v1
Obtenir une clé API
Parcourir la documentation

DéveloppeursRéférence API

API REST TurnitPass

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

REST API v1

Console de référence

Commencez par la route, le payload et la forme de la réponse.

La référence complète couvre tous les endpoints ci-dessous. La console montre d’abord le contrat dont les développeurs ont besoin : auth Bearer, entrée JSON, sortie mesurée et contrôles status.

request
POST
fetch('/api/v1/humanize', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tp_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text: 'Paste the draft here',
    language: 'en',
    mode: 'reduce-aigc'
  })
})
response
200 OK
{
  "output": "The revised text...",
  "words_used": 142,
  "words_remaining": 2858,
  "status": "succeeded"
}
mesuréjournaliséJSON
POST/api/v1/humanize
POST/api/v1/paraphrase
POST/api/v1/rewrite
POST/api/v1/detect
POST/api/v1/citation
AuthBearer API key
TransformPOST /humanize
RelecturePOST /detect
StatusGET /status
POST/api/v1/humanize
v1

Révise le texte soumis et réduit les signaux de rédaction IA. Modes : reduce-aigc, reduce-both, paraphrase, academic-polish.

POST/api/v1/paraphrase
v1

Réécrit et peaufine le texte en mode standard, fluidité, formel, académique, simple, créatif, extension ou raccourcissement.

POST/api/v1/rewrite
v1

Endpoint de polissage académique pour une structure, un ton et un enchaînement de phrases plus fluides.

POST/api/v1/detect
v1

Retourne le score, le niveau de risque, les métadonnées et les signaux de style pour le texte collé ou les documents extraits.

POST/api/v1/citation
v1

Formate un DOI, une URL ou une citation manuelle en APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA ou Bluebook. Les réponses incluent HTML, texte, BibTeX et RIS.

POST/api/v1/bibliography
v1

Trie et formate une liste de citations dans le style demandé, avec sortie HTML/texte ainsi que des exports BibTeX et RIS.

GET/api/v1/status
v1

Vérifie le nom de la clé, le solde de mots restant, les limites de requêtes et la dernière utilisation.

Paramètres et options

Authentification
Authorization: Bearer tp_your_api_key
Termes protégés
Le champ optionnel personal_terms préserve les noms propres, termes techniques et orthographes de marque.
Limites
Les endpoints de révision acceptent jusqu’à 1 000 mots. La vérification accepte jusqu’à 5 000 mots. Les citations disposent de limites d’usage propres.
Erreurs
Les réponses JSON incluent error, code et message.

Limites de débit et de requête

Entrée de transformation
humanize/rewrite: 500; paraphrase: 2,000Quality units = CJK characters + other characters / 3, rounded up. Same limits on every plan.
Entrée de détection
Jusqu’à 5 000 motsLes scans detector plus longs doivent être découpés avant envoi.
Clés API
Jusqu’à 5 clés activesLes clés peuvent être révoquées indépendamment depuis l’espace de travail.
Outils de citation
Limite de débit séparéeLes appels citation et bibliography ne consomment pas de crédits de mots.

Gestion des erreurs

Les réponses d’erreur utilisent du JSON avec les champs error, code et un message lisible lorsque c’est possible.

error response
JSON
{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}
Les identifiants Stripe et Google restent de la configuration. Les surfaces API, le flux d’auth et la persistance sont implémentés pour que les identifiants live s’ajoutent sans redessiner le produit.

Exemples

Exemple humanize
JSON
POST /api/v1/humanize
{
  "text": "Collez le texte à réviser",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["TurnitPass"]
}

200 OK
{
  "output": "Le texte humanisé...",
  "words_used": 142,
  "words_remaining": 2858
}
Exemple multi-endpoints
JSON
POST /api/v1/paraphrase
{
  "text": "Collez le brouillon que vous souhaitez réécrire",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Collez le texte à vérifier",
  "language": "en",
  "source_kind": "paste"
}

POST /api/v1/citation
{
  "input": "https://example.com/article",
  "style": "apa"
}

200 OK
{
  "text": "Citation formatée...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}

Étapes suivantes

Démarrage rapide

Préparez la première requête.

Authentification

Vérifiez la gestion des clés API.

Changelog

Consultez les changements récents de la plateforme.

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