POST /v1/humanize
Ein Request, eine klare Antwort: Text rein, humanisierte Fassung und AI-Werte zurück. Derselbe Humanizer wie im Browser – jetzt in deinem Code.
Die Sprache wird automatisch erkannt und beibehalten: Deutsch und über 40 weitere. Abgerechnet werden exakt die gemessenen Eingabewörter.
API-Schlüssel erstellenDokumentation ansehen
Kostenlos registrieren · Abrechnung nach Eingabewörtern · keine Mindestlaufzeit
curl https://api.studytexter.com/v1/humanize \
-H "Authorization: Bearer $STUDYTEXTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "Die Digitalisierung stellt Unternehmen vor …"}'{
"humanized_text": "Unternehmen stehen durch die Digitalisierung vor sehr …",
"ai_detection": {
"original": { "ai_percent": 81.58, "human_mixed_percent": 18.42 },
"humanized": { "ai_percent": 3.83, "human_mixed_percent": 96.17 }
}
}
AI-Werte bei jedem Aufruf – Detektoren u. a. bekannt aus:
Grundlagen
Die Humanizer API ist eine REST-Schnittstelle, über die Texte aus ChatGPT, Claude, Gemini oder DeepSeek programmatisch überarbeitet werden, damit sie natürlicher klingen – als AI Humanizer API im englischen Sprachgebrauch, als KI-Humanizer-API im deutschen. Text humanisieren per API heißt hier: Du schickst einen POST mit deinem Text an /v1/humanize und bekommst die humanisierte Fassung zurück, dazu AI-Detection-Werte für beide Versionen als Messwert. Dahinter läuft dieselbe Spracherkennung, dieselbe Wortmessung und dieselbe Verarbeitung wie im KI-Humanizer im Browser – es gibt keine abgespeckte Variante für Entwickler.
Integration
Kein SDK, kein Onboarding-Gespräch, keine Sprachangabe. Die REST-API kommt mit einem Schlüssel, einem Endpunkt und einem Pflichtfeld im Body aus.
Schlüssel erstellen
Registrieren, in der App auf die Schlüsselseite gehen, Schlüssel anlegen. Das vollständige Geheimnis wird genau einmal angezeigt.
Text schicken
POST auf /v1/humanize mit Authorization: Bearer und einem JSON-Body, der nur text enthält. Eine Sprachangabe schickst du nicht – sie wird erkannt.
Antwort verarbeiten
Zurück kommen humanized_text und die AI-Werte für Original und Ergebnis. Im Fehlerfall entscheidet error.retryable, ob ein zweiter Versuch erlaubt ist.
curl --request POST 'https://api.studytexter.com/v1/humanize' \
--header "Authorization: Bearer $STUDYTEXTER_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"text":"Die Digitalisierung stellt Unternehmen vor vielfältige Herausforderungen, weil bestehende Prozesse überprüft und neu zusammengesetzt werden müssen. Ein verantwortungsvoller Einsatz von KI verlangt weiterhin sorgfältige Quellenarbeit und eigene Urteilskraft."}'Der vollständige Beispieltext, die OpenAPI-Datei und die Markdown-Fassung für Agenten liegen in der Dokumentation.
Agenten
Ein Agent, der Text erzeugt, braucht den Humanizer als Werkzeug – nicht als Website. Drei Dinge entscheiden, wenn niemand mehr danebensitzt.
Als Tool registrieren
Ein Endpunkt, ein Pflichtfeld, keine Schalter. Die Tool-Definition passt in ein paar Zeilen und lässt sich in LangChain, im Anthropic-SDK, in n8n oder in einem eigenen Loop hinterlegen.
In mehrstufigen Abläufen
Der Agent erzeugt Text mit einem Modell, schickt ihn durch /v1/humanize und leitet das Ergebnis weiter. Die Sprache bleibt die des Entwurfs, ohne dass der Ablauf sie kennen muss.
Wiederholen ohne Doppelabrechnung
Jeder Fehler sagt über error.retryable, ob ein neuer Versuch sicher ist. Bricht die Verbindung ohne Antwort ab, dedupliziert ein Idempotency-Key: derselbe Schlüssel mit demselben Text liefert die gespeicherte Antwort statt einer zweiten Abrechnung.
{
"name": "humanize_text",
"description": "Überarbeitet einen KI-Entwurf, damit er natürlicher klingt. Die Sprache wird erkannt und beibehalten. Zahlen, Namen, Quellen und Fachbegriffe bleiben stehen.",
"input_schema": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Der zu überarbeitende Text. 100 bis 30.000 Zeichen, höchstens 3.000 Wörter."
}
},
"required": ["text"]
}
}Mehr braucht ein Agent nicht. Es gibt kein Sprach-, Ton- oder Stärkefeld, das er falsch setzen könnte – und damit auch keinen Freiheitsgrad, an dem ein Lauf still danebengeht. Die vollständige Beschreibung liegt zusätzlich als OpenAPI 3.1 und als llms.txt bereit; beides lässt sich einem Modell direkt vorlegen.
Anwendungsfälle
Überall dort, wo ein Modell den Entwurf schreibt und trotzdem ein Mensch als Absender darunter steht.
Schreibtools
Dein Editor erzeugt einen Entwurf per LLM und schickt ihn vor der Ausgabe durch die API. Deine Nutzer sehen das Ergebnis, nicht den Zwischenschritt.
Content-Pipelines
Redaktions- und Publishing-Strecken hängen den Aufruf hinter die Generierung. Der Durchsatz kommt aus 60 parallelen Aufträgen, nicht aus längeren Einzeltexten.
Agenten-Frameworks
LangChain, CrewAI, das Anthropic-SDK oder ein eigener Loop: Der Endpunkt ist ein Werkzeug unter anderen und braucht keine Sonderbehandlung.
SEO und Marketing
Blogtexte, Produktbeschreibungen, Newsletter. Was ein Modell entworfen hat, geht als Fließtext raus, ohne dass jemand ihn von Hand glattzieht.
Akademische Plattformen
Lernumgebungen und Schreibwerkzeuge, deren Nutzer mit Quellen arbeiten. Belege, Seitenzahlen und Fachbegriffe bleiben Wort für Wort stehen – genau der Punkt, an dem die meisten Humanizer scheitern.
White-Label und SaaS
Humanisieren als eigenes Feature in deinem Produkt, unter deinem Namen. Abgerechnet wird über dein StudyTexter-Konto; deine Nutzer sehen davon nichts.
Unterschiede
Nicht weil sie schneller ist als andere, sondern weil sie weniger Stellen hat, an denen etwas still kaputtgeht.
Sprache wird erkannt, nicht gesetzt
Du schickst kein language-Feld. Die dominante Sprache des Eingabetexts wird erkannt und in der Antwort beibehalten – über 40 Sprachen. Ein falsch gesetzter Parameter kann dir nichts kaputt machen.
AI-Werte für beide Fassungen
Die Antwort enthält Detektor-Wahrscheinlichkeiten für den Originaltext und für das Ergebnis. Du kannst in deinem Produkt anzeigen oder protokollieren, was sich verändert hat – ohne zweites Werkzeug.
Quellen bleiben Wort für Wort
Zitate, Seitenzahlen, Autorennamen und Jahreszahlen werden nicht umformuliert. Das ist der Grund, warum die API in akademischen Produkten überhaupt einsetzbar ist.
Abrechnung nach Eingabewörtern
Gezählt wird der Text, den du schickst – mit ICU-Segmentierung auf einer NFC-normalisierten Kopie. Die Länge der Antwort ändert den Preis nicht.
Dieselbe Engine wie im Browser
573,7 Mio. humanisierte Wörter und über 63.573 Nutzer laufen durch dieselbe Verarbeitung. Was die API liefert, kannst du in der Oberfläche gegenprüfen.
Modell-Updates inklusive
Verbesserungen an der Verarbeitung erreichen die API zur selben Zeit wie die Oberfläche. An deiner Integration änderst du dafür nichts.
Preise
Die API hat keine eigenen Tarife. Sie zieht von demselben Guthaben ab wie das Werkzeug im Browser – Abo oder Einmalkauf, beides gilt für beide Wege.
GPTZero stuft unsere Texte menschlicher ein als echte studentische Texte (Ø 84 % vs. 80 %).
Über 573,7 Mio. Wörter humanisiertStudent
14,99€pro Monat
5,00€ / 10.000 WörterDie Garantie gilt für den KI-Scanner GPTZero: Wird dein humanisierter Text dort als KI erkannt, erstatten wir die verbrauchten Wörter zurück. Eine kurze Nachricht an den Support genügt.
Abo startenOder einmalig kaufen
Starter
9,99€einmalig
12,49€ / 10.000 WörterStandard
34,99€einmalig
8,75€ / 10.000 WörterPower
69,99€einmalig
7,78€ / 10.000 WörterÜber die öffentliche API laufen ausschließlich bezahlte Wörter: das Abo-Kontingent und gekaufte Pakete. Das kostenlose Monatskontingent gilt nur für die Weboberfläche.
Enterprise ab 150.000 Wörter/Monat
Individuelle Preise für Agenturen, Ghostwriter und Tool-Integrationen. Beantworte kurz vier Punkte – wir melden uns innerhalb von 24 Stunden.
Sichere Zahlung über Stripe · jederzeit kündbar, keine Mindestlaufzeit
Antwort
Ein Feld mit dem Ergebnis, ein Objekt mit den Messwerten. Mehr Struktur braucht es nicht.
{
"humanized_text": "…",
"ai_detection": {
"original": {
"human_mixed_percent": 18.42,
"human_percent": 8.29,
"mixed_percent": 10.13,
"ai_percent": 81.58
},
"humanized": {
"human_mixed_percent": 96.17,
"human_percent": 83.04,
"mixed_percent": 13.13,
"ai_percent": 3.83
}
}
}humanized_text
Die überarbeitete Fassung in der Sprache des Eingabetexts. Aufbau und Länge bleiben nah am Original.
ai_detection.original
Die Wahrscheinlichkeiten für den Text, den du geschickt hast: ai_percent, human_percent, mixed_percent und human_mixed_percent.
ai_detection.humanized
Dieselben vier Werte für das Ergebnis. Der Vergleich beider Objekte ist der Vorher-/Nachher-Check aus der Weboberfläche.
X-Request-ID
Header, den du mitloggst. Damit ordnet der Support einen einzelnen Durchgang zu, ohne dass du deinen Text erneut schickst.
AI-Werte sind Klassenwahrscheinlichkeiten, keine Anteile von Sätzen – und kein Beweis. Detektoren ordnen auch menschliche Texte falsch ein. Einzelne Werte können null sein, wenn keine Messung vorliegt; darauf sollte deine Integration vorbereitet sein.
Was bleibt
Verändert werden Satzbau, Übergänge und Wortwahl. Der Inhalt, für den dein Produkt geradesteht, bleibt stehen.
Bedeutung
Aussagen bleiben Aussagen. Es wird nichts ergänzt, was im Eingabetext nicht stand.
Nummern und Kennungen
Aktenzeichen, DOIs, ISBNs, Artikelnummern: Zeichenfolgen werden übernommen, nicht neu gesetzt.
Namen und Eigennamen
Personen, Institutionen, Produkte und Orte behalten ihre Schreibweise.
Zahlen, Daten und Einheiten
Messwerte bleiben ungerundet, nicht umgerechnet und an ihrer Stelle.
Fachbegriffe und Abkürzungen
Terminologie wird nicht gegen ein Alltagswort getauscht, nur weil das geläufiger klingt.
Register und Anrede
Sie oder du, nüchtern oder erzählend: Das Sprachniveau des Eingabetexts bleibt erhalten.
Abrechnung
Die API hat keine eigenen Tarife. Sie zieht von demselben Guthaben ab, mit dem auch das Tool im Browser arbeitet.
Abgerechnet werden Eingabewörter
Gezählt wird exakt der Text, den du schickst. Wie lang die Antwort ausfällt, spielt für den Preis keine Rolle.
Über die API laufen bezahlte Wörter
Das kostenlose Monatskontingent gilt für die Weboberfläche. Die öffentliche API greift ausschließlich auf bezahltes Guthaben zu.
Abgelehnt heißt nicht abgerechnet
Anfragen, die an einem Limit scheitern, werden nicht eingereiht und nicht belastet. Bei wiederholbaren Fehlern wird die Reservierung wieder freigegeben.
Kein zweiter Vertrag
Guthaben und Abo laufen über dein bestehendes Konto und sind dort kündbar. Für die API kommt nichts obendrauf.
curl 'https://api.studytexter.com/v1/balance' \
--header "Authorization: Bearer $STUDYTEXTER_API_KEY"
{
"balance": {
"subscription": null,
"subscription_words_remaining": 0,
"purchased_words_remaining": 12000,
"total_api_words_available": 12000
}
}Sicherheit
Vier Punkte, die vor der Integration geklärt sein sollten.
Der Schlüssel bleibt serverseitig
stx_live_… gehört in einen Secret-Manager – nicht in Browser-Bundles, mobile Apps, URLs, Prompts oder Logs. Redigiere den Authorization-Header, bevor du Anfragen protokollierst.
Einmal sichtbar, jederzeit widerrufbar
Das vollständige Geheimnis wird bei der Erstellung genau einmal angezeigt. Anlegen, auflisten und widerrufen läuft ausschließlich über die angemeldete Schlüsselseite.
Ein Schlüssel, viele Aufträge
Derselbe Schlüssel authentifiziert beliebig viele Aufträge, nacheinander oder parallel. Der Idempotency-Key ist etwas anderes: eine Auftragskennung, kein Geheimnis.
Kein Training mit deinen Texten
Deine Texte werden für den Auftrag verarbeitet. Zum Training von KI-Modellen nutzen wir sie nicht.
Fragen
Eine REST-Schnittstelle, über die du KI-Texte programmatisch überarbeiten lässt, damit sie natürlicher klingen. Ein POST auf /v1/humanize mit deinem Text, zurück kommen die humanisierte Fassung und AI-Detection-Werte für beide Versionen. Dahinter läuft dieselbe Verarbeitung wie im KI-Humanizer im Browser.
Inhaltlich ja. Hinter der KI-Humanizer-API stehen dieselbe Spracherkennung, dieselbe Wortmessung und dieselbe Verarbeitung wie hinter dem KI-Humanizer in der Weboberfläche. Unterschiedlich sind nur der Zugang – Bearer-Token statt Login – und das Guthaben: Über die öffentliche API laufen ausschließlich bezahlte Wörter.
Als Werkzeug. Du hinterlegst eine Tool-Definition mit einem einzigen Pflichtfeld – dem Text – und der Agent ruft sie auf, wenn eine Ausgabe überarbeitet werden soll. Das funktioniert in LangChain, CrewAI, im Anthropic-SDK oder in einem eigenen Loop gleichermaßen. Für Modelle liegen die Beschreibungen zusätzlich als OpenAPI 3.1, als Markdown und als llms.txt bereit.
Kostenlos registrieren oder anmelden, in der App die Schlüsselseite öffnen und einen Schlüssel anlegen. Das vollständige Geheimnis siehst du genau einmal – kopiere es sofort in deinen Secret-Manager. Widerrufen kannst du es dort jederzeit.
Über einen Bearer-Token im Authorization-Header: Authorization: Bearer stx_live_… Derselbe Schlüssel gilt für /v1/humanize und /v1/balance und kann viele Aufträge nacheinander oder parallel authentifizieren. Er gehört ausschließlich in serverseitigen Code.
Mit Text aus allen gängigen Modellen – ChatGPT, Claude, Gemini, DeepSeek, Llama, Mistral und anderen. Die API bekommt Text, keinen Modellnamen: Was zählt, sind die Muster im Entwurf, nicht seine Herkunft.
Das versprechen wir nicht. Die API liefert eine natürlichere Formulierung und dazu die gemessenen AI-Werte für Original und Ergebnis. Diese Werte sind Klassenwahrscheinlichkeiten eines Detektors – kein Beweis und keine Garantie. Detektoren ändern ihre Modelle, kommen je nach Anbieter zu unterschiedlichen Einschätzungen und ordnen auch rein menschliche Texte falsch ein. Was du bekommst, ist ein nachvollziehbarer Vorher-/Nachher-Vergleich, den du in deinem Produkt anzeigen oder protokollieren kannst.
Nein, und du kannst es auch nicht. Die dominante Sprache des Eingabetexts wird erkannt und in der Antwort beibehalten – Deutsch und über 40 weitere. Ein language-Feld nimmt die API nicht an.
Ja. Abgerechnet werden exakt die gemessenen Eingabewörter, unabhängig davon, wie lang die Antwort wird. Über die öffentliche API laufen ausschließlich bezahlte Wörter; das kostenlose Monatskontingent gilt für die Weboberfläche. Den aktuellen Stand fragst du mit GET /v1/balance ab.
Ja, pro Nutzer: 60 neue Aufträge je 60 Sekunden, 60 gleichzeitig in Verarbeitung und 30 Guthaben-Abfragen pro Minute. Anfragen darüber werden mit 429 abgelehnt, nicht eingereiht und nicht abgerechnet. Wo vorhanden, nennt Retry-After die Wartezeit.
Bei einem Fehler mit error.retryable=true wurde die Reservierung freigegeben – ein neuer Versuch ist sicher. Bricht die Verbindung ganz ohne Antwort ab, kennst du das Ergebnis nicht: Für diesen Fall gibt es den optionalen Idempotency-Key. Mit demselben Schlüssel und demselben Text bekommst du die gespeicherte Antwort zurück statt einer zweiten Abrechnung.
Die Nutzung läuft über dein StudyTexter-Konto und wird darüber abgerechnet, auch wenn deine eigenen Nutzer den Aufruf auslösen. Was dabei vertraglich gilt, steht in unseren AGB; bei größeren Volumen oder Fragen zum Einsatz sprich uns vorher an.
Schlüssel erstellen und den ersten Request schicken
POST /v1/humanize · Abrechnung nach Eingabewörtern · keine Mindestlaufzeit