AI Humanizer API
Humanisieren Sie AI-Text in Ihrem Produkt mit einem einzigen REST-Aufruf. Die AI humanizer API stellt die Engine bereit, die TextPulse antreibt, für Ihr Backend: JSON geht hinein, umgeschriebene Prosa kommt zurück, in mehr als 60 Sprachen.
Den ersten Request senden
Authentifizieren Sie sich mit einem Authorization: Bearer-Header und senden Sie Ihren Text per POST. Die umgeschriebene Version wird als outputText zusammen mit den Messwerten für diesen Aufruf zurückgegeben.
curl https://textpulse.ai/api/v1/humanize \ -H "Authorization: Bearer tp_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Our analysis indicates the intervention produced gains...", "writingMode": "Academic", "intensityScalar": 0.5 }'{ "outputText": "Our analysis points to measurable gains from the...", "metrics": { "inputWords": 128, "outputWords": 134, "wordsCharged": 128, "balanceRemaining": 99872, "modelLatencyMs": 4310, "route": "v1/humanize" }}Was ist eine AI-Humanizer-API?
Eine AI-Humanizer-API ist ein REST-Endpunkt, der maschinell erzeugten Text innerhalb eines anderen Produkts in natürliche, menschlich klingende Prosa umschreibt. Statt Text in eine Web-App einzufügen, sendet Ihr Backend ihn als JSON und erhält die umgeschriebene Version in der Antwort zurück, sodass Humanisierung zu einer Funktion Ihrer eigenen Software wird: eine Schaltfläche in einem Editor, ein Schritt in einer Dokumenten-Pipeline, ein Batch-Job über eine Inhaltsbibliothek.
Die TextPulse Humanizer API stellt dieselbe Engine bereit, die auch das TextPulse Dashboard betreibt. Sie arbeitet gleichzeitig mit mehr als 20 sprachlichen Signalen, variiert Satzlänge und Satzstruktur und ersetzt den Wortschatz, den Sprachmodelle übermäßig auswählen, während In-Text-Zitate, Literaturangaben, Statistiken und feststehende Terminologie unverändert durchgereicht werden. In einem akademischen Korpus mit 2.000 Dokumenten bestand der humanisierte Output Turnitin AI in 92.33% der Fälle, Originality.ai in 89.12% und GPTZero in 87.91%. Dieses akademische Verhalten unterscheidet sie von generischen Paraphrase-Endpunkten: Der Text, den Ihre Nutzer zurückerhalten, ist veröffentlichungsfähig, nicht nur anders.
Was die AI humanizer API für Sie übernimmt
Sprachrouting, Registersteuerung, Abrechnung und Wiederholsicherheit sind Teil des Endpunkts, sodass Ihre Integration eine einzelne Funktion bleibt.
Ein Pfad für 60+ Sprachen
Englisch läuft auf der fein abgestimmten Humanizer-Engine. Übergeben Sie einen Sprachwert, und die Anfrage wird stattdessen auf den mehrsprachigen Pfad geleitet, sodass eine nicht englische Produktseite denselben Endpunkt ohne zweite Integration erreicht.
Register und Stärke sind Parameter
Fünf Schreibmodi decken die Register Academic, Corporate, Creative, Blog/SEO und General ab. Der Wert intensityScalar legt fest, wie stark die Überarbeitung vom Ausgangstext abweicht, und nimmt 0, 0.25, 0.5, 0.75 oder 1 an, von Mild über den standardmäßigen Balanced-Wert bei 0.5 bis Aggressive.
Ein POST pro Dokument
Es gibt keine Job-Warteschlange zum Abfragen und keinen Webhook zum Registrieren. Der humanize-Aufruf hält die Verbindung, bis das Modell zurückgibt, und antwortet mit dem umgeschriebenen Text, sodass ein einzelner Request die Arbeit abschließt.
Wiederholungen werden nicht doppelt berechnet
Senden Sie eine requestId, und das Ergebnis wird für etwa zehn Minuten daran zwischengespeichert. Eine Wiederholung derselben Kennung innerhalb dieses Fensters gibt die gespeicherte Antwort wieder, statt das Modell erneut auszuführen, und jeder Request, den die Engine nicht abschließen kann, wird Ihrem Guthaben automatisch wieder gutgeschrieben.
Endpunktreferenz
Authorization: Bearer-Header. Schlüssel beginnen mit tp_live_ und werden projektweise ausgegeben./api/v1/humanize/api/v1/balanceEin einzelner humanize-Aufruf akzeptiert bis zu 1,000 Wörter innerhalb einer Grenze von 10,000 Zeichen, und jeder Schlüssel kann 60 Requests pro Minute ausgeben. Längere Dokumente werden als Folge von Aufrufen gesendet.
Anfrageparameter
Nur text ist erforderlich. Alles andere hat einen sinnvollen Standardwert, daher besteht die minimale Integration aus nur einem Feld.
| Parameter | Type | Vorkommen | Hinweise |
|---|---|---|---|
text | string | Erforderlich | Der zu humanisierende Text. Bis zu 1,000 Wörter innerhalb einer Grenze von 10,000 Zeichen pro Anfrage. |
writingMode | string | Standard: Academic | Einer von Academic, Corporate, Creative, Blog/SEO oder General. Legt das Register fest, das die Umschreibung beibehält. |
intensityScalar | number | Standard: 0.5 | Einer von 0, 0.25, 0.5, 0.75 oder 1. Wie weit sich die Umschreibung von der Vorlage entfernt, von Mild über Balanced bis Aggressive. |
language | string | Optional | Leitet nichtenglischen Text auf den mehrsprachigen Pfad um. Lassen Sie es weg oder senden Sie Englisch für die fein abgestimmte englische Engine. |
englishVariant | string | Optional | Amerikanisch oder Britisch. Hält Rechtschreibung und Wortschatz auf einer Seite des Atlantiks. |
freezeTerms | string[] | Optional | Bis zu 10 Begriffe oder Phrasen, die unverändert durch die Umschreibung gehen: Konstruktionsnamen, Instrumente, Produktnamen. |
removeEmDashes | boolean | Optional | Schreibt Konstruktionen mit Gedankenstrich in konventionelle Zeichensetzung um. |
requestId | string | Empfohlen | Ihr Idempotenz-Token. Wenn es innerhalb von ungefähr zehn Minuten erneut verwendet wird, wird die gespeicherte Antwort erneut ausgegeben, statt erneut zu berechnen. |
Antwortfelder
outputTextDer humanisierte Text.metrics.inputWords / outputWordsEmpfangene und zurückgegebene Wörter. Umschreibungen fallen oft etwas länger aus als die Vorlage.metrics.wordsChargedDie Kosten des Aufrufs. Entspricht immer der Eingabemenge, niemals der Ausgabemenge.metrics.balanceRemainingVerbleibende Wortguthaben auf dem Schlüssel nach diesem Aufruf, damit Sie ohne zweite Anfrage messen können.metrics.modelLatencyMs / routeEngine-Zeit für die Umschreibung und der Pfad, der sie bereitgestellt hat.Fehler und Wiederholungen
Jeder Fehler gibt JSON mit einem stabilen error.code und einer menschenlesbaren Meldung zurück. Die Regel, an der Sie sich bei der Gestaltung orientieren sollten: Es wird nur für eine tatsächlich gelieferte Umschreibung berechnet, und eine Wiederholung mit derselben requestId ist immer sicher.
UNAUTHORIZEDFehlender oder nicht erkannter API-Schlüssel. Prüfen Sie den Authorization: Bearer-Header.INSUFFICIENT_BALANCENicht genügend Wortguthaben auf dem Schlüssel. Die Antwort enthält den verfügbaren Kontostand.REQUEST_IN_PROGRESSEine Anfrage mit dieser requestId wird noch verarbeitet. Warten Sie darauf, statt sie zu überholen.TOO_LONG / VALIDATION_FAILEDDie Eingabe überschreitet die Grenze von 1,000 Wörtern oder ein Parameter ist fehlerhaft. Die Antwort listet die genauen Probleme auf.ENGINE_ERRORDie Engine ist fehlgeschlagen oder hat die Zeit überschritten. Die Wörter wurden bereits Ihrem Guthaben wieder gutgeschrieben, wiederholen Sie mit derselben requestId.Die Engine hinter dem Endpunkt
Jeder Aufruf verwendet die veröffentlichte TextPulse-Engine, gemessen an einem akademischen Korpus mit 2.000 Dokumenten und bei Aktualisierungen der Erkennungsmodelle erneut ausgeführt. Trefferquoten nach Detektor:
Vom Anbieter gemessene Werte, veröffentlicht zusammen mit dem jeweiligen Korpus. Kein Humanizer kann ein Detektor-Ergebnis für ein bestimmtes Dokument versprechen, daher sollte die Produktkommunikation auf der Messung und nicht auf einer Garantie beruhen.
Worauf Teams auf der Humanizer-API aufbauen
EdTech- und Schreibplattformen
Fügen Sie neben Ihren bestehenden Grammatik- oder Paraphrasierungsfunktionen eine Humanize-Aktion hinzu. Der Academic-Modus erhält Zitate unverändert, sodass studentische Tools Verweise vor dem Senden des Textes nicht entfernen müssen.
Dokumenten- und Korrekturlesetools
Leiten Sie ganze Dokumente in 1.000-Wort-Abschnitten durch und setzen Sie sie anschließend wieder zusammen. Freeze terms halten Namen und Terminologie über die Abschnitte hinweg stabil, und idempotente Wiederholungen machen Batch-Pipelines sicher erneut ausführbar.
Content- und SEO-Produkte
Der Blog/SEO-Modus überarbeitet Entwürfe zu veröffentlichungsfähiger Prosa, während freeze terms die Ziel-Keywords sperren, sodass der Text seine Suchintention beibehält und den maschinellen Rhythmus verliert.
White-Label-Partner
Der Endpunkt läuft unsichtbar in Ihrem Produkt: Ihre Oberfläche, Ihre Abrechnung, unsere Engine. Partnervereinbarungen werden anhand des monatlichen Volumens über das Zugangsformular kalkuliert.
Preise der AI humanizer API
Credits werden im Voraus bezahlt und nach Wörtern abgezogen. Die Abrechnung zählt, was Sie senden, nicht was die Engine zurückgibt, und jeder Aufruf, der keine Überarbeitung erzeugt, wird dem Schlüssel wieder gutgeschrieben.
Credits sind 12 Monate ab Kauf gültig und decken jede vom Endpunkt unterstützte Sprache, jeden Schreibmodus und jede englische Variante ab. Für dauerhaftes Volumen oder eine White-Label-Vereinbarung in Ihrem eigenen Produkt, Zugang anfragen und wir unterbreiten Ihnen ein Angebot auf Grundlage Ihrer monatlichen Menge.
Fragen zur AI-Humanizer-API
API-Schlüssel erhalten
Schlüssel werden projektbezogen vergeben. Beschreiben Sie, woran Sie arbeiten, und wir antworten innerhalb von 24 Stunden.