Vai al contenuto
TurnitPass
SviluppatoriAPI v1
Ottieni una chiave API
Sfoglia la documentazione

SviluppatoriRiferimento API

API REST TurnitPass

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

REST API v1

Console di riferimento

Parti da route, payload e forma della risposta.

Il riferimento completo copre tutti gli endpoint sotto. La console mostra prima il contratto che serve agli sviluppatori: auth Bearer, input JSON, output misurato e controlli 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"
}
misuratoregistratoJSON
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
RevisionePOST /detect
StatusGET /status
POST/api/v1/humanize
v1

Rende più naturale il testo inviato e riduce i segnali IA. Modalità: reduce-aigc, reduce-both, paraphrase, academic-polish.

POST/api/v1/paraphrase
v1

Riscrivi e perfeziona il testo con modalità standard, fluidità, formale, accademico, semplice, creativo, espandi o accorcia.

POST/api/v1/rewrite
v1

Endpoint di pulizia accademica per una migliore struttura, tono e flusso delle frasi.

POST/api/v1/detect
v1

Restituisce punteggio stimato, livello di rischio, metadati e segnali di scrittura per testo incollato o documenti estratti.

POST/api/v1/citation
v1

Formatta DOI, URL o citazione manuale in APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA o Bluebook. Le risposte includono HTML, testo semplice, BibTeX e RIS.

POST/api/v1/bibliography
v1

Ordina e formatta un elenco di citazioni nello stile richiesto, con output HTML/testo ed esportazioni BibTeX e RIS.

GET/api/v1/status
v1

Controlla il nome della chiave, il saldo parole rimanente, i limiti di richiesta e l’ultimo utilizzo.

Parametri e opzioni

Autenticazione
Authorization: Bearer tp_your_api_key
Termini protetti
Il campo opzionale personal_terms preserva nomi propri, termini tecnici e marchi durante la revisione.
Limits
Gli endpoint di trasformazione accettano fino a 1.000 parole in ingresso. Il rilevamento accetta fino a 5.000 parole. Gli endpoint di citazione sono limitati ma non consumano crediti di parole.
Errors
Le risposte JSON includono i campi error, code e message.

Rate limit e limiti di richiesta

Input di trasformazione
humanize/rewrite: 500; paraphrase: 2,000Quality units = CJK characters + other characters / 3, rounded up. Same limits on every plan.
Input di detection
Fino a 5.000 paroleLe scansioni detector più lunghe vanno spezzate prima dell’invio.
Chiavi API
Fino a 5 chiavi attiveLe chiavi si possono revocare in modo indipendente dallo spazio di lavoro.
Strumenti di citazione
Rate limit separatoLe chiamate citation e bibliography non consumano crediti di parole.

Gestione errori

Le risposte di errore usano JSON con i campi error, code e un message leggibile quando possibile.

error response
JSON
{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}
Le credenziali Stripe e Google restano configurazione. Superfici API, flusso di auth e persistenza sono già implementati così le credenziali live si aggiungono senza ridisegnare il prodotto.

Esempi

Esempio humanize
JSON
POST /api/v1/humanize
{
  "text": "Incolla qui la bozza da rivedere",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["TurnitPass"]
}

200 OK
{
  "output": "Il testo umanizzato...",
  "words_used": 142,
  "words_remaining": 2858
}
Esempio multi-endpoint
JSON
POST /api/v1/paraphrase
{
  "text": "Incolla la bozza che desideri riscrivere",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Incolla il testo da controllare",
  "language": "en",
  "source_kind": "paste"
}

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

200 OK
{
  "text": "Citazione formattata...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}

Passi successivi

Guida rapida

Prepara la prima richiesta.

Autenticazione

Controlla la gestione delle chiavi API.

Changelog

Vedi le modifiche recenti della piattaforma.

Poi collegalo al tuo flusso di lavoro.Continua a leggere