POST /v1/humanize
Una richiesta, una risposta chiara: inserisci il testo, ricevi la versione umanizzata e i valori AI. Lo stesso Humanizer del browser, ora nel tuo codice.
La lingua viene rilevata e mantenuta automaticamente: italiano e oltre 40 altre. Vengono addebitate esattamente le parole di input misurate.
Crea chiave APIVisualizza la documentazione
Registrazione gratuita · Fatturazione in base alle parole di input · Nessuna durata minima del contratto
curl https://api.studytexter.com/v1/humanize \
-H "Authorization: Bearer $STUDYTEXTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "La digitalizzazione pone le aziende di fronte a..."}'{
"humanized_text": "A causa della digitalizzazione, le aziende si trovano di fronte a...",
"ai_detection": {
"original": { "ai_percent": 81.58, "human_mixed_percent": 18.42 },
"humanized": { "ai_percent": 3.83, "human_mixed_percent": 96.17 }
}
}
Valori AI a ogni chiamata – Rilevatori noti, tra gli altri, da:
Nozioni di base
La Humanizer API è un'interfaccia REST tramite la quale i testi di ChatGPT, Claude, Gemini o DeepSeek vengono rielaborati programmaticamente per renderli più naturali – nota come AI Humanizer API in inglese o KI-Humanizer-API in tedesco. Umanizzare un testo tramite API qui significa: invii una richiesta POST con il tuo testo a /v1/humanize e ricevi in cambio la versione umanizzata, oltre ai valori di AI detection per entrambe le versioni come dato misurato. Dietro a tutto questo ci sono lo stesso riconoscimento della lingua, la stessa misurazione delle parole e la stessa elaborazione dell'Humanizer IA nel browser – non esiste una versione ridotta per gli sviluppatori.
Integrazione
Nessun SDK, nessuna chiamata di onboarding, nessuna indicazione della lingua. La REST-API richiede solo una chiave, un endpoint e un campo obbligatorio nel body.
Crea chiave
Registrati, vai alla pagina delle chiavi nell'app, crea una chiave. Il segreto completo viene mostrato una sola volta.
Invia testo
POST a /v1/humanize con Authorization: Bearer e un body JSON che contiene solo text. Non invii alcuna indicazione della lingua: viene rilevata.
Elabora risposta
Vengono restituiti humanized_text e i valori AI per l'originale e il risultato. In caso di errore, error.retryable determina se è consentito un secondo tentativo.
curl --request POST 'https://api.studytexter.com/v1/humanize' \
--header "Authorization: Bearer $STUDYTEXTER_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"text":"La digitalizzazione pone le aziende di fronte a molteplici sfide, poiché i processi esistenti devono essere riesaminati e riorganizzati. Un uso responsabile dell'IA richiede inoltre un'attenta ricerca delle fonti e una capacità di giudizio autonoma."}'Il testo di esempio completo, il file OpenAPI e la versione Markdown per gli agenti sono disponibili nella documentazione.
Agenti
Un agente che genera testo ha bisogno dell'Humanizer come strumento, non come sito web. Tre cose sono decisive quando nessuno supervisiona il processo.
Registrare come tool
Un endpoint, un campo obbligatorio, nessuno switch. La definizione del tool sta in poche righe e può essere memorizzata in LangChain, nell'SDK di Anthropic, in n8n o in un loop personalizzato.
In flussi di lavoro a più fasi
L'agente genera il testo con un modello, lo invia a /v1/humanize e inoltra il risultato. La lingua rimane quella della bozza, senza che il processo debba conoscerla.
Ripetizione senza doppia fatturazione
Ogni errore indica tramite error.retryable se un nuovo tentativo è sicuro. Se la connessione si interrompe senza risposta, una Idempotency-Key deduplica: la stessa chiave con lo stesso testo restituisce la risposta salvata invece di una seconda fatturazione.
{
"name": "humanize_text",
"description": "Rielabora una bozza IA per renderla più naturale. La lingua viene rilevata e mantenuta. Numeri, nomi, fonti e termini tecnici non vengono modificati.",
"input_schema": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Il testo da rielaborare. Da 100 a 30.000 caratteri, massimo 3.000 parole."
}
},
"required": ["text"]
}
}Un agente non ha bisogno di altro. Non ci sono campi per lingua, tono o intensità che potrebbe impostare in modo errato, e quindi nessun grado di libertà che potrebbe causare un fallimento silenzioso dell'esecuzione. La descrizione completa è disponibile anche come OpenAPI 3.1 e come llms.txt; entrambi possono essere forniti direttamente a un modello.
Casi d'uso
Ovunque un modello scriva la bozza e, ciononostante, un essere umano figuri come mittente.
Strumenti di scrittura
Il tuo editor genera una bozza tramite LLM e la invia all'API prima di restituirla. I tuoi utenti vedono il risultato, non il passaggio intermedio.
Pipeline di contenuti
I flussi di lavoro editoriali e di publishing inseriscono la chiamata dopo la generazione. Il throughput deriva da 60 processi paralleli, non da singoli testi più lunghi.
Framework per agenti
LangChain, CrewAI, l'SDK di Anthropic o un loop personalizzato: l'endpoint è uno strumento tra gli altri e non richiede un trattamento speciale.
SEO e marketing
Testi per blog, descrizioni di prodotti, newsletter. Ciò che un modello ha abbozzato viene pubblicato come testo continuo, senza che nessuno debba rifinirlo a mano.
Piattaforme accademiche
Ambienti di apprendimento e strumenti di scrittura i cui utenti lavorano con le fonti. Citazioni, numeri di pagina e termini tecnici rimangono invariati parola per parola: esattamente il punto in cui la maggior parte degli humanizer fallisce.
White-label e SaaS
Umanizzazione come feature propria nel tuo prodotto, con il tuo nome. La fatturazione avviene tramite il tuo account StudyTexter; i tuoi utenti non vedranno nulla di tutto ciò.
Differenze
Non perché sia più veloce di altre, ma perché ha meno punti in cui qualcosa può rompersi silenziosamente.
La lingua viene rilevata, non impostata
Non invii un campo `language`. La lingua dominante del testo di input viene rilevata e mantenuta nella risposta: oltre 40 lingue. Un parametro impostato in modo errato non può causare problemi.
Valori AI per entrambe le versioni
La risposta contiene le probabilità del rilevatore per il testo originale e per il risultato. Puoi visualizzare o registrare nel tuo prodotto cosa è cambiato, senza bisogno di un secondo strumento.
Le fonti restano parola per parola
Citazioni, numeri di pagina, nomi degli autori e anni non vengono riformulati. Questo è il motivo per cui l'API è utilizzabile nei prodotti accademici.
Fatturazione in base alle parole di input
Viene conteggiato il testo che invii, con segmentazione ICU su una copia normalizzata NFC. La lunghezza della risposta non modifica il prezzo.
Lo stesso engine del browser
573,7 milioni di parole umanizzate e oltre 63.573 utenti passano attraverso la stessa elaborazione. Ciò che l'API fornisce, puoi verificarlo nell'interfaccia.
Aggiornamenti del modello inclusi
I miglioramenti all'elaborazione raggiungono l'API contemporaneamente all'interfaccia. Non devi modificare nulla nella tua integrazione per questo.
Prezzi
L'API non ha tariffe proprie. Utilizza lo stesso credito dello strumento nel browser: abbonamento o acquisto una tantum, entrambi validi per entrambe le modalità.
GPTZero classifica i nostri testi come più umani rispetto a veri testi di studenti (Ø 84% vs. 80%).
Oltre 573,7 milioni di parole umanizzateStudente
14,99€al mese
5,00€ / 10.000 paroleLa garanzia è valida per lo scanner IA GPTZero: se il tuo testo umanizzato viene rilevato come IA, ti rimborsiamo le parole utilizzate. Basta un breve messaggio al supporto.
Inizia l'abbonamentoOppure acquista una tantum
Starter
9,99€una tantum
12,49€ / 10.000 paroleStandard
34,99€una tantum
8,75€ / 10.000 parolePower
69,99€una tantum
7,78€ / 10.000 paroleTramite l'API pubblica vengono utilizzate esclusivamente parole a pagamento: la quota dell'abbonamento e i pacchetti acquistati. La quota mensile gratuita è valida solo per l'interfaccia web.
Enterprise da 150.000 parole/mese
Prezzi personalizzati per agenzie, ghostwriter e integrazioni di tool. Rispondi brevemente a quattro punti – ti contatteremo entro 24 ore.
Pagamento sicuro tramite Stripe · disdicibile in qualsiasi momento, nessuna durata minima del contratto
Risposta
Un campo con il risultato, un oggetto con i valori misurati. Non serve una struttura più complessa.
{
"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
La versione rielaborata nella lingua del testo di input. Struttura e lunghezza rimangono simili all'originale.
ai_detection.original
Le probabilità per il testo che hai inviato: ai_percent, human_percent, mixed_percent e human_mixed_percent.
ai_detection.humanized
Gli stessi quattro valori per il risultato. Il confronto tra i due oggetti è il check prima/dopo dell'interfaccia web.
X-Request-ID
Header da registrare nei log. In questo modo, il supporto può associare una singola esecuzione senza che tu debba inviare di nuovo il testo.
I valori AI sono probabilità di classe, non percentuali di frasi, e non costituiscono una prova. I rilevatori classificano erroneamente anche testi scritti da esseri umani. I singoli valori possono essere null se non è disponibile alcuna misurazione; la tua integrazione dovrebbe essere preparata a questa evenienza.
Cosa rimane
Vengono modificati la sintassi, le transizioni e la scelta delle parole. Il contenuto, di cui il tuo prodotto è responsabile, rimane invariato.
Significato
Le affermazioni rimangono affermazioni. Non viene aggiunto nulla che non fosse presente nel testo di input.
Numeri e identificatori
Numeri di pratica, DOI, ISBN, codici articolo: le stringhe di caratteri vengono mantenute, non reimpostate.
Nomi e nomi propri
Persone, istituzioni, prodotti e luoghi mantengono la loro grafia.
Numeri, dati e unità
I valori misurati non vengono arrotondati, né convertiti e rimangono al loro posto.
Termini tecnici e abbreviazioni
La terminologia non viene sostituita con una parola di uso comune solo perché suona più familiare.
Registro e allocutivi
Formale o informale, sobrio o narrativo: il livello linguistico del testo di input viene mantenuto.
Fatturazione
L'API non ha tariffe proprie. Utilizza lo stesso credito con cui funziona anche lo strumento nel browser.
Vengono addebitate le parole di input
Viene conteggiato esattamente il testo che invii. La lunghezza della risposta non influisce sul prezzo.
Tramite l'API vengono utilizzate le parole a pagamento
La quota mensile gratuita è valida per l'interfaccia web. L'API pubblica accede esclusivamente al credito a pagamento.
Respinto non significa addebitato
Le richieste che falliscono a causa di un limite non vengono messe in coda e non vengono addebitate. In caso di errori ripetibili, la prenotazione viene rilasciata.
Nessun secondo contratto
Credito e abbonamento sono gestiti tramite il tuo account esistente e possono essere disdetti lì. Non ci sono costi aggiuntivi per l'API.
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
}
}Sicurezza
Quattro punti da chiarire prima dell'integrazione.
La chiave rimane lato server
stx_live_… va inserito in un Secret-Manager, non in bundle per browser, app mobili, URL, prompt o log. Oscura l'header Authorization prima di registrare le richieste nei log.
Visibile una sola volta, revocabile in qualsiasi momento
Il segreto completo viene mostrato solo una volta al momento della creazione. La creazione, l'elenco e la revoca avvengono esclusivamente tramite la pagina delle chiavi dopo aver effettuato l'accesso.
Una chiave, molti processi
La stessa chiave autentica un numero qualsiasi di processi, in sequenza o in parallelo. L'Idempotency-Key è un'altra cosa: un identificatore del processo, non un segreto.
Nessun training con i tuoi testi
I tuoi testi vengono elaborati per il processo. Non li utilizziamo per l'addestramento di modelli di IA.
Domande
Un'interfaccia REST tramite la quale puoi far rielaborare programmaticamente i testi IA per renderli più naturali. Una richiesta POST a /v1/humanize con il tuo testo, e in risposta ricevi la versione umanizzata e i valori di AI-Detection per entrambe le versioni. Dietro c'è la stessa elaborazione dell'Humanizer IA nel browser.
Sì, per quanto riguarda i contenuti. Dietro l'API dell'Humanizer IA ci sono lo stesso riconoscimento della lingua, la stessa misurazione delle parole e la stessa elaborazione dell'Humanizer IA nell'interfaccia web. Le uniche differenze sono l'accesso – Bearer-Token invece del login – e il credito: tramite l'API pubblica vengono utilizzate esclusivamente parole a pagamento.
Come strumento. Definisci un tool con un unico campo obbligatorio – il testo – e l'agente lo chiama quando un output deve essere rielaborato. Funziona allo stesso modo in LangChain, CrewAI, nell'SDK di Anthropic o in un loop personalizzato. Per i modelli, le descrizioni sono disponibili anche come OpenAPI 3.1, come Markdown e come llms.txt.
Registrati gratuitamente o accedi, apri la pagina delle chiavi nell'app e crea una chiave. Vedrai il segreto completo solo una volta: copialo immediatamente nel tuo Secret-Manager. Puoi revocarlo lì in qualsiasi momento.
Tramite un Bearer-Token nell'header Authorization: Authorization: Bearer stx_live_… La stessa chiave è valida per /v1/humanize e /v1/balance e può autenticare molti processi in sequenza o in parallelo. Va utilizzata esclusivamente nel codice lato server.
Con testi provenienti da tutti i modelli più comuni: ChatGPT, Claude, Gemini, DeepSeek, Llama, Mistral e altri. L'API riceve testo, non il nome di un modello: ciò che conta sono i pattern nella bozza, non la sua origine.
Non lo promettiamo. L'API fornisce una formulazione più naturale e, in aggiunta, i valori AI misurati per l'originale e il risultato. Questi valori sono probabilità di classe di un rilevatore, non una prova né una garanzia. I rilevatori modificano i loro modelli, giungono a valutazioni diverse a seconda del fornitore e classificano erroneamente anche testi puramente umani. Ciò che ottieni è un confronto prima/dopo tracciabile, che puoi visualizzare o registrare nel tuo prodotto.
No, e non puoi nemmeno farlo. La lingua dominante del testo di input viene rilevata e mantenuta nella risposta: tedesco e oltre 40 altre. L'API non accetta un campo `language`.
Sì. Vengono addebitate esattamente le parole di input misurate, indipendentemente dalla lunghezza della risposta. Tramite l'API pubblica vengono utilizzate esclusivamente parole a pagamento; la quota mensile gratuita è valida per l'interfaccia web. Puoi verificare lo stato attuale con GET /v1/balance.
Sì, per utente: 60 nuove richieste ogni 60 secondi, 60 in elaborazione simultaneamente e 30 richieste di saldo al minuto. Le richieste che superano questi limiti vengono respinte con un 429, non vengono messe in coda e non vengono addebitate. Se disponibile, l'header Retry-After indica il tempo di attesa.
In caso di errore con error.retryable=true, la prenotazione è stata rilasciata: un nuovo tentativo è sicuro. Se la connessione si interrompe senza alcuna risposta, non conosci il risultato: per questo caso esiste l'Idempotency-Key opzionale. Con la stessa chiave e lo stesso testo, riceverai la risposta salvata invece di un secondo addebito.
L'utilizzo avviene tramite il tuo account StudyTexter e viene fatturato attraverso di esso, anche se sono i tuoi utenti a innescare la chiamata. Le condizioni contrattuali applicabili sono indicate nei nostri T&C; per volumi maggiori o domande sull'utilizzo, contattaci in anticipo.
Crea la chiave e invia la prima richiesta
POST /v1/humanize · Fatturazione in base alle parole di input · Nessuna durata minima del contratto