Zum Inhalt springen
TurnitPass
EntwicklerAPI v1API-Schlüssel erstellen
Dokumentation durchsuchen

EntwicklerEntwickler-Dokumentation

TurnitPass API-Dokumentation

Beginnen Sie mit API-Schlüsseln und rufen Sie anschließend die Endpunkte für Humanizer, Paraphrase, AI Detector, Citation Generator und Bibliography auf, um TurnitPass in Ihr eigenes Schreibprodukt zu integrieren.

REST API v1

One request

Quick example

Senden Sie Text mit einem Bearer-API-Schlüssel an den Humanizer. Die Antwort enthält das Ergebnis, verbrauchte Wörter und das Restguthaben des Schlüsselinhabers.

curl
POST /api/v1/humanize
curl -X POST https://turnitpass.com/api/v1/humanize \
  -H "Authorization: Bearer tp_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text":"Paste your draft here","language":"en","mode":"revise"}'
response
200 OK
{
  "output": "Your humanized text...",
  "words_used": 6,
  "words_remaining": 249994
}
Dieselbe Schlüsselkette gilt für Paraphrase, Rewrite, Detector, Citation, Bibliography und Status.

Route map

Explore the docs

01

Schnellstart

Erstellen Sie einen API-Schlüssel im Arbeitsbereich und rufen Sie anschließend die Humanizer-, Prüf- und Zitat-Endpunkte mit diesem Schlüssel auf.

02

Authentifizierung

Entwickler-Anfragen erfordern API-Schlüssel, die über den TurnitPass-Arbeitsbereich generiert werden.

03

API-Referenz

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

04

Changelog

Aktuelle Änderungen an Textüberarbeitung, Prüfung, Schreibwerkzeugen, Abrechnung und API.

Nächster Schritt

Request lifecycle

Jeder TurnitPass-API-Aufruf folgt demselben Weg: Schlüssel authentifizieren, Payload prüfen, Schreib- oder Zitationsworkflow ausführen, Nutzung messen und eine speicherbare Antwort zurückgeben.

1

API-Schlüssel authentifizieren

Einen Arbeitsbereichsschlüssel senden. Widerrufene, fehlerhafte oder fehlende Schlüssel scheitern vor der Textverarbeitung.

2

Text, Sprache und Limits prüfen

Transform-Anfragen prüfen Wortspannen, Detector längere Scan-Limits, Citation Stil und Quelle.

3

Workflow ausführen

Humanize, Paraphrase, Rewrite, Detect, Citation und Bibliography nutzen dasselbe serverseitige Verhalten wie die öffentlichen Tools.

4

Nutzung speichern und Ergebnis liefern

Erfolgreiche Aufrufe liefern Ergebnis plus Metadaten: Wörter, Restguthaben, Status oder formatierte Zitations-Exporte.

API-Struktur

Kern-Endpunkte

Überarbeiten

POST/api/v1/humanize

Überarbeitet KI-gestützten Text und reduziert KI-Schreibsignale bei erhaltener Bedeutung.

Paraphrasieren

POST/api/v1/paraphrase

Schreibt Text in verschiedenen Ton- und Längenmodi um.

Prüfen

POST/api/v1/detect

Liefert geschätzte KI-Schreibsignale und Überarbeitungshinweise.

Zitate

POST/api/v1/citation

Formatiert eine DOI, URL oder manuell eingegebene Quelle als Zitat.

Production checklist

Serverseitige Aufrufe
Schlüssel nicht im Client-BundleTurnitPass vom Backend, Worker, Queue oder geschützter Serveraktion aufrufen.
Wiederholungen
Nur Netzwerkfehler wiederholen4xx als Eingabeproblem behandeln; nur transiente 5xx/Netzwerkfehler wiederholen.
Wortbudget
Restguthaben vor großen Läufen zeigenMit Status entscheiden, ob gequeued, upgegradet oder das Dokument geteilt wird.
Abrechnung
Stripe-Geheimnisse sind EndkonfigurationCheckout, Portal und Webhooks sind verdrahtet; Live-Schlüssel und Preis-IDs kommen beim Deployment.
Pro Umgebung einen eigenen Schlüssel verwenden. Produktion, Staging und Lokal müssen unabhängig widerrufbar sein.
Als Nächstes in Ihren Workflow einbinden.Weiterlesen