AI Humanizer API
Umanizza il testo AI nel tuo prodotto con una sola chiamata REST. L'API humanizer AI espone al tuo backend il motore che alimenta TextPulse: entra JSON, esce prosa riscritta, in più di 60 lingue.
Effettuare la prima richiesta
Autenticati con un'intestazione Authorization: Bearer e invia il tuo testo. La versione riscritta viene restituita come outputText insieme ai dati di misurazione di quella chiamata.
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" }}Cosa gestisce per te l'API humanizer AI
Routing della lingua, controllo del registro, misurazione e sicurezza dei retry fanno parte dell'endpoint, così la tua integrazione resta una sola funzione.
Un solo percorso copre più di 60 lingue
L'inglese usa il motore humanizer ottimizzato. Passa un valore di lingua e la richiesta viene instradata invece al percorso multilingue, così una pagina prodotto non in inglese raggiunge lo stesso endpoint senza una seconda integrazione.
Registro e intensità sono parametri
Cinque modalità di scrittura coprono i registri Academic, Corporate, Creative, Blog/SEO e General. Il valore intensityScalar stabilisce quanto la riscrittura differisce dalla fonte e assume uno tra 0, 0.25, 0.5, 0.75 o 1, da Mild fino al valore predefinito Balanced a 0.5, fino ad Aggressive.
Una sola POST per documento
Non esiste una coda di job da interrogare né un webhook da registrare. La chiamata humanize mantiene la connessione finché il modello restituisce la risposta e risponde con il testo riscritto, così una singola richiesta completa il lavoro.
I retry non vengono addebitati due volte
Invia un requestId e il risultato viene memorizzato nella cache per circa dieci minuti. Una ripetizione dello stesso identificatore in quella finestra riproduce la risposta memorizzata invece di eseguire di nuovo il modello, e qualsiasi richiesta che il motore non riesce a completare restituisce automaticamente le sue parole al tuo saldo.
Riferimento endpoint
Authorization: Bearer. Le chiavi iniziano con tp_live_ e sono emesse per progetto./api/v1/humanize/api/v1/balanceUna singola chiamata humanize accetta fino a 1,000 parole entro un limite di 10,000 caratteri, e ogni chiave può emettere 60 richieste al minuto. I documenti più lunghi vengono inviati come sequenza di chiamate.
Parametri della richiesta
È richiesto solo text. Tutto il resto ha un valore predefinito sensato, quindi l'integrazione minima è un solo campo.
| Parametro | Type | Presenza | Note |
|---|---|---|---|
text | string | Obbligatorio | Il testo da humanizzare. Fino a 1,000 parole entro un limite di 10,000 caratteri per richiesta. |
writingMode | string | Predefinito: Academic | Uno tra Academic, Corporate, Creative, Blog/SEO o General. Imposta il registro che la riscrittura mantiene. |
intensityScalar | number | Predefinito: 0.5 | Uno tra 0, 0.25, 0.5, 0.75 o 1. Quanto la riscrittura si allontana dal testo di origine, da Mild attraverso Balanced fino ad Aggressive. |
language | string | Facoltativo | Instrada il testo non inglese verso il percorso multilingue. Omettilo, oppure invia inglese, per il motore inglese ottimizzato. |
englishVariant | string | Facoltativo | Americano o britannico. Mantiene ortografia e lessico su una sola sponda dell'Atlantico. |
freezeTerms | string[] | Facoltativo | Fino a 10 termini o frasi mantenuti integralmente nella riscrittura: nomi di costruzione, strumenti, nomi dei prodotti. |
removeEmDashes | boolean | Facoltativo | Riscrive le costruzioni con em dash in punteggiatura convenzionale. |
requestId | string | Consigliato | Il tuo token di idempotenza. Ripeterlo entro circa dieci minuti riproduce la risposta memorizzata invece di addebitare di nuovo. |
Campi della risposta
outputTextIl testo humanizzato.metrics.inputWords / outputWordsParole ricevute e parole restituite. Le riscritture spesso risultano leggermente più lunghe del testo di origine.metrics.wordsChargedIl costo della chiamata. È sempre uguale al conteggio in input, mai al conteggio in output.metrics.balanceRemainingCrediti di parole rimasti sulla chiave dopo questa chiamata, così puoi misurare senza una seconda richiesta.metrics.modelLatencyMs / routeTempo del motore per la riscrittura e il percorso che l'ha servita.Errori e retry
Ogni errore restituisce JSON con un error.code stabile e un messaggio leggibile. La regola su cui vale la pena progettare: ti viene addebitata solo una riscrittura che è stata consegnata, e riprovare con lo stesso requestId è sempre sicuro.
UNAUTHORIZEDChiave API mancante o non riconosciuta. Controlla l'intestazione Authorization: Bearer.INSUFFICIENT_BALANCECrediti di parole insufficienti sulla chiave. La risposta include il saldo disponibile.REQUEST_IN_PROGRESSUna richiesta con questo requestId è ancora in fase di elaborazione. Attendi invece di farla correre in parallelo.TOO_LONG / VALIDATION_FAILEDL'input supera il limite di 1,000 parole oppure un parametro è malformato. La risposta elenca i problemi esatti.ENGINE_ERRORIl motore è fallito o è andato in timeout. Le parole sono già state riaccreditate sul tuo saldo, riprova con lo stesso requestId.Il motore dietro l'endpoint
Ogni chiamata esegue il motore TextPulse pubblicato, misurato su un corpus accademico di 2.000 documenti e rieseguito man mano che i modelli di rilevamento si aggiornano. Tassi di basso punteggio per rilevatore:
Dati misurati dal fornitore, pubblicati con il loro corpus. Nessun humanizer può promettere l'esito di un rilevatore su un documento specifico, quindi costruisci la messaggistica del tuo prodotto sulla misurazione, mai su una garanzia.
Su cosa i team costruiscono con l'API humanizer
Piattaforme EdTech e di scrittura
Aggiungete un'azione di humanize accanto alle vostre funzioni esistenti di grammatica o parafrasi. La modalità Academic mantiene intatte le citazioni, così gli strumenti rivolti agli studenti non devono rimuovere i riferimenti prima di inviare il testo.
Strumenti per documenti e correzione di bozze
Fate passare interi documenti in blocchi da 1.000 parole e ricomponeteli. Freeze terms mantiene stabili nomi e terminologia tra i blocchi, e i retry idempotenti rendono sicuri i pipeline batch da rieseguire.
Prodotti di contenuto e SEO
La modalità Blog/SEO riscrive le bozze in prosa pubblicabile mentre freeze terms blocca le parole chiave target, così il testo conserva l'intento di ricerca e perde il ritmo meccanico.
Partner white-label
L'endpoint funziona in modo invisibile all'interno del vostro prodotto: la vostra interfaccia, la vostra fatturazione, il nostro motore. Gli accordi di partnership sono quotati in base al volume mensile tramite il modulo di accesso.
Prezzi dell'API humanizer AI
I crediti vengono prepagati e scalati a partire dalle parole. La fatturazione conta ciò che invii, mai ciò che il motore restituisce, e qualsiasi chiamata che non produce una riscrittura viene riaccreditata alla chiave.
I crediti sono validi per 12 mesi dall'acquisto e coprono ogni lingua, modalità di scrittura e variante dell'inglese supportata dall'endpoint. Per volumi continuativi o per un accordo white-label all'interno del vostro prodotto, richiedete l'accesso e vi forniremo un preventivo in base al vostro volume mensile.
Ottenete la vostra chiave API
Le chiavi vengono assegnate per progetto. Descrivete ciò che state costruendo e vi risponderemo entro 24 ore.