Docs menuRéférence API

API ReferenceTyped request and response

Ré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é.

Reference console

Start with the route, payload, and response shape.

The full reference covers every endpoint below. The console shows the contract developers need first: Bearer auth, JSON input, metered output, and status checks.

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

meteredloggedJSON

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

ReviewPOST /detect

StatusGET /status

POST/api/v1/humanize

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

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

POST/api/v1/rewrite

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

POST/api/v1/detect

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

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

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

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

Parameters and 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.

Rate limits and request limits

Transform input

Up to 1,000 wordsApplies to humanize, paraphrase, and rewrite endpoints.

Detection input

Up to 5,000 wordsLonger detector scans should be chunked before submission.

API keys

Up to 5 active keysKeys can be revoked independently from the workspace.

Citation tools

Rate-limited separatelyCitation and bibliography calls do not spend word credits.

Error handling

Error responses use JSON with error,code, and human-readable message fields where possible.

error response

JSON

{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}

The Stripe and Google credentials are configuration points. The API surfaces, auth flow, and persistence are implemented so live credentials can be added without redesigning the product.

Examples

Humanize example

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
}

Multi-endpoint example

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

Next steps

Démarrage rapide

Set up the first request.

Authentification

Review API key handling.

Changelog

See recent platform changes.

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

Parameters and 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.

Rate limits and request limits

Transform input

Up to 1,000 wordsApplies to humanize, paraphrase, and rewrite endpoints.

Detection input

Up to 5,000 wordsLonger detector scans should be chunked before submission.

API keys

Up to 5 active keysKeys can be revoked independently from the workspace.

Citation tools

Rate-limited separatelyCitation and bibliography calls do not spend word credits.

Error handling

Error responses use JSON with error,code, and human-readable message fields where possible.

error response

JSON

{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}

The Stripe and Google credentials are configuration points. The API surfaces, auth flow, and persistence are implemented so live credentials can be added without redesigning the product.

Examples

Humanize example

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
}

Multi-endpoint example

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