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 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 zwischengespeichert. Eine Wiederholung derselben Kennung innerhalb dieses Zeitfensters spielt die gespeicherte Antwort ab, statt das Modell erneut auszuführen, und jede Anfrage, die die Engine nicht abschließen kann, gibt ihre Worte automatisch Ihrem Guthaben zurück.
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 bleiben bei der Überarbeitung wörtlich erhalten: 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 parallel zu starten.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. Niedrig-Score-Raten nach Detektor:
Vom Anbieter gemessene Kennzahlen, veröffentlicht mit dessen Korpus. Kein Humanizer kann ein Detektor-Ergebnis für ein bestimmtes Dokument versprechen. Richten Sie daher die Kommunikation Ihres Produkts auf die Messung aus, niemals auf eine Garantie.
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
Guthaben werden im Voraus bezahlt und nach Wortanzahl abgezogen. Die Abrechnung zählt, was Sie senden, nie das, was die Engine zurückgibt, und jeder Aufruf, der keine Umschreibung erzeugt, wird auf den Schlüssel zurückgebucht.
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.
API-Schlüssel erhalten
Schlüssel werden projektbezogen vergeben. Beschreiben Sie, woran Sie arbeiten, und wir antworten innerhalb von 24 Stunden.