Docs menuAPI-Referenz

API ReferenceTyped request and response

API-Referenz

TurnitPass REST API

Referenz für authentifizierte Endpunkte zum Überarbeiten, Paraphrasieren, Prüfen, Zitieren, Erstellen von Bibliografien und für den API-Schlüsselstatus.

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

Überarbeitet übermittelten Text und reduziert KI-Schreibsignale. Modi: reduce-aigc, reduce-both, paraphrase, academic-polish.

POST/api/v1/paraphrase

Umschreiben und Verfeinern von Texten mit Modi wie Standard, Fluency, Formal, Academic, Simple, Creative, Expand oder Shorten.

POST/api/v1/rewrite

Akademischer Polishing-Endpunkt für sauberere Struktur, Tonalität und Satzfluss.

POST/api/v1/detect

Gibt Score, Risikostufe, Metadaten und Schreibsignale für kopierten Text oder extrahierte Dokumente zurück.

POST/api/v1/citation

Formatiert DOI, URL oder manuelle Zitate in APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA oder Bluebook. Antworten enthalten HTML, Text, BibTeX und RIS.

POST/api/v1/bibliography

Sortiert und formatiert eine Liste von Zitaten im gewünschten Stil mit HTML/Text-Ausgabe sowie BibTeX- und RIS-Exporten.

GET/api/v1/status

Prüft Schlüsselname, verbleibendes Wortguthaben und Anfrage-Limits.

Parameters and options

Authentifizierung

Authorization: Bearer tp_your_api_key

Geschützte Begriffe

Das optionale Feld personal_terms bewahrt Eigennamen, Fachbegriffe und Markenschreibweisen.

Limits

Überarbeitungs-Endpunkte akzeptieren bis zu 1.000 Wörter, die Erkennung bis zu 5.000 Wörter. Zitat-Endpunkte sind ratenbegrenzt, verbrauchen aber kein Wortguthaben.

Fehler

JSON-Antworten enthalten error, code und 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": "Fügen Sie den Text ein, den Sie überarbeiten möchten",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["TurnitPass"]
}

200 OK
{
  "output": "Der humanisierte Text...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "Fügen Sie den Entwurf ein, den Sie umschreiben möchten",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Fügen Sie den Text ein, den Sie prüfen möchten",
  "language": "en",
  "source_kind": "paste"
}

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

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

Next steps

Schnellstart

Set up the first request.

Authentifizierung

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

Authentifizierung

Authorization: Bearer tp_your_api_key

Geschützte Begriffe

Das optionale Feld personal_terms bewahrt Eigennamen, Fachbegriffe und Markenschreibweisen.

Limits

Überarbeitungs-Endpunkte akzeptieren bis zu 1.000 Wörter, die Erkennung bis zu 5.000 Wörter. Zitat-Endpunkte sind ratenbegrenzt, verbrauchen aber kein Wortguthaben.

Fehler

JSON-Antworten enthalten error, code und 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": "Fügen Sie den Text ein, den Sie überarbeiten möchten",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["TurnitPass"]
}

200 OK
{
  "output": "Der humanisierte Text...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "Fügen Sie den Entwurf ein, den Sie umschreiben möchten",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Fügen Sie den Text ein, den Sie prüfen möchten",
  "language": "en",
  "source_kind": "paste"
}

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

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