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 Akademisch, Unternehmenskommunikation, Kreativ, Blog/SEO und Allgemein ab. Der Wert intensityScalar legt fest, wie stark sich die Überarbeitung von der Vorlage unterscheidet, und nimmt einen der Werte 0, 0.25, 0.5, 0.75, 1 oder 1.25 an, von Leicht über den Standard Ausgewogen bei 0.5 und Aggressiv bei 1 bis ULTRA bei 1.25.
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.
ULTRANEW!
ULTRA: Die höchste KI-Score-Reduktion über die API
Die neue sechste Intensitätsstufe arbeitet mit demselben Endpunkt. Setzen Sie intensityScalar auf 1.25 für ULTRA, die maximale Umschreibung des Humanizers, mit einer GPTZero-Score-Reduktionsrate von 89 %.
Reduzierung des KI-Scores vs. semantische Treue vs. Grammatik
- Reduzierung des KI-Scores (GPTZero, %)
- Semantische Treue (NLI-Unterstützung × 100)
- Grammatik (LanguageTool markiert pro 1.000 Wörter)
Ein Parameter
Setze intensityScalar in der Anfrage, die du bereits sendest, auf 1.25. Der Endpunkt, der Bearer-Schlüssel und die JSON-Antwort bleiben gleich.
Die maximale Umschreibung
ULTRA schreibt von jedem Absatz mehr um als jede andere Einstellung, mit der höchsten Reduzierung des KI-Scores, allerdings auf Kosten einer etwas geringeren Lesbarkeit und Grammatik. Überarbeiten Sie die Ausgabe vor der Einreichung.
Nur englischer Text
ULTRA funktioniert nur mit englischem Text. Die anderen fünf Einstellungen decken alle Sprachen ab, die die API unterstützt.
Abgerechnet pro Eingabewort
Eine ULTRA-Anfrage wird pro Eingabewort abgerechnet, genau wie jede andere Einstellung, und wenn die Engine eine Anfrage nicht abschließen kann, werden die Wörter automatisch Ihrem Guthaben 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, 1 oder 1.25. Wie weit die Überarbeitung sich von der Vorlage entfernt, von Leicht über Ausgewogen und Aggressiv bis ULTRA. ULTRA (1.25) funktioniert nur mit englischem Text. |
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.keptLinesÜberschriften, Listen, Tabellen, Gleichungen und Verweise, die exakt so zurückgegeben werden, wie sie geschrieben wurden. Wird nur angezeigt, wenn der Text solche Zeilen enthält.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.INSUFFICIENT_PROSEDer Text hat höchstens 50 Wörter in Fließtextabsätzen neben Überschriften, Listen, Tabellen, Gleichungen oder Verweisen, also gibt es zu wenig zu humanisieren. Es werden keine Kosten berechnet; fügen Sie weitere Absätze hinzu und versuchen Sie es erneut.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.