Sfoglia la documentazione

Documentazione API di TurnitPass

Inizia con le chiavi API, chiama gli endpoint per umanizzazione, parafrasi, rilevamento, citazioni e bibliografia e integra TurnitPass nel tuo software di scrittura.

REST API v1

One request

Quick example

Invia il testo all’endpoint humanizer con una chiave API Bearer. La risposta restituisce l’output trasformato, le parole usate e il saldo rimanente del titolare della chiave.

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 espone anche gli endpoint paraphrase, rewrite, detector, citation, bibliography e status con lo stesso flusso di chiave API.

Route map

Explore the docs

Guida rapida

Crea una chiave API dall’area di lavoro, quindi chiama gli endpoint di scrittura, rilevamento e citazione usando la stessa chiave.

Autenticazione

Le richieste degli sviluppatori utilizzano chiavi API generate dall’area di lavoro TurnitPass.

Riferimento API

Riferimento per gli endpoint autenticati di umanizzazione, parafrasi, rilevamento, citazione, bibliografia e stato delle chiavi API.

Changelog

Modifiche recenti a umanizzatore IA, rilevatore IA, strumenti di scrittura, fatturazione e API.

Effettua la tua prima richiesta di umanizzazione

Crea una chiave e invia la prima richiesta.

API REST TurnitPass

Controlla endpoint, parametri, limiti e forme di risposta.

Passo successivo

Request lifecycle

Ogni chiamata API TurnitPass segue lo stesso percorso: autentica la chiave, valida il payload, esegue il flusso di scrittura o citazione, misura l’uso e restituisce una forma di risposta che il prodotto può archiviare.

Autenticare la chiave API

Invia una chiave generata dallo spazio di lavoro. Chiavi revocate, malformate o assenti falliscono prima dell’elaborazione del testo.

Validare testo, lingua e limiti

Le richieste di trasformazione applicano intervalli di parole, quelle detector limiti di scansione più lunghi e quelle citation convalidano stile e fonte.

Eseguire il flusso

Le route humanize, paraphrase, rewrite, detect, citation e bibliography riutilizzano lo stesso comportamento server degli strumenti pubblici.

Registrare l’uso e restituire il risultato

Le chiamate riuscite restituiscono l’output più metadati di uso: parole usate, saldo rimanente, stato o esportazioni di citazioni formattate.

Superficie API

Endpoint principali

Umanizza

POST/api/v1/humanize

Riduci i segnali di scrittura IA preservando il significato originale.

Parafrasa

POST/api/v1/paraphrase

Riscrivi e perfeziona il testo in diverse modalità.

Rileva

POST/api/v1/detect

Restituisce il punteggio stile rilevatore, il livello di rischio e i segnali di scrittura.

Citazioni

POST/api/v1/citation

Formatta metadati di fonti DOI, URL o inseriti manualmente.

Production checklist

Chiamate lato server

Non esporre mai le chiavi API nel clientChiama TurnitPass dal backend, worker, coda o server action protetta.

Retry

Riprova i fallimenti di rete, non quelli di validazioneTratta le risposte 4xx come problemi di utente o payload e riserva i retry agli errori 5xx o di rete transitori.

Budget di parole

Mostra il saldo prima dei flussi pesantiUsa l’endpoint status per decidere se mettere in coda, chiedere un upgrade o suddividere il documento.

Fatturazione

I secret Stripe sono la configurazione finaleCheckout, portal e webhook sono collegati; chiavi live e price ID restano da inserire al deploy.

Nelle integrazioni di prodotto, tieni una chiave TurnitPass per ambiente. Produzione, staging e sviluppo locale devono essere revocabili in modo indipendente.

Poi collegalo al tuo flusso di lavoro.Continua a leggere