Livello scolastico del testo da lunghezza
Tre frasi brevi con 16 parole e 17 sillabe risultano sotto la prima classe, all'inizio della scuola primaria. Incolli un testo in inglese e veda la sua classe scolastica approssimativa, calcolata dalla lunghezza delle frasi e dalle sillabe per parola. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Redattori, insegnanti e progettisti curricolari spesso hanno bisogno di una risposta rapida a una domanda semplice: a grandi linee in quale anno scolastico si può leggere questo brano senza uno sforzo eccessivo? Questo stimatore del livello di lettura accetta un brano in inglese, conta frasi, parole e sillabe con un’euristica fissa e restituisce un livello di grado scolastico statunitense approssimativo basato sulla lunghezza media della frase e sulla media di sillabe per parola — gli stessi ingredienti strutturali della classica formula Flesch–Kincaid Grade Level. Usi il punteggio come segnale trasparente di lunghezza e complessità, non come affermazione su rarità lessicale o difficoltà tematica.
Come il livello si ottiene da euristiche di lunghezza
Il livello scolastico qui non è un giudizio editoriale soggettivo né un classificatore di machine learning. È una stima in forma chiusa da due statistiche di superficie che correlano con la domanda di lettura nella prosa inglese: quanto lunghe tendono a essere le frasi e quanti nuclei sillabici ogni parola tende a portare. La lunghezza media della frase (ASL) è il numero di token di parola alfabetici diviso per il numero di unità di frase.
Le unità si ottengono dividendo sulla punteggiatura terminale come punto, punto interrogativo e punto esclamativo; se il brano non ha marca terminale, l’intero testo trimmato conta come una sola frase così il rapporto resta definito. La media di sillabe per parola (ASW) è il totale delle sillabe diviso per il conteggio delle parole. Le sillabe sono stimate con un’euristica deterministica di gruppi vocalici inglesi: vocali consecutive formano un nucleo, una e muta finale di solito si omette per parole più lunghe e ogni token alfabetico contribuisce almeno una sillaba.
La formula di grado è l’identità pubblica Flesch–Kincaid Grade Level: zero virgola tre nove volte ASL più undici virgola otto volte ASW meno quindici virgola cinque nove, con i coefficienti 0.39, 11.8 e 15.59. Frasi più lunghe e più parole polisillabiche spingono il punteggio verso l’alto; clausole brevi e dizione monosilabica lo trascinano verso le bande della scuola elementare iniziale.
La risposta inoltre limita il punteggio continuo a un intervallo pratico di visualizzazione e lo mappa a un’etichetta grossolana di banda come elementary, middle school, high school o college, così le interfacce possono mostrare un’etichetta in linguaggio semplice accanto al grado numerico senza inventare soglie proprie.
Casi d'uso
Allineamento di classe e schede di lavoro
Incolli bozze di brani e verifichi che il livello stimato resti vicino all’anno scolastico target prima di stampare i materiali.
Controlli di policy sul linguaggio chiaro
Valuti avvisi pubblici e articoli di aiuto così i team segnalino bozze che superano la banda media o superiore consentita.
Domande frequenti
Il livello di grado è esatto per ogni lettore?
No. È una stima strutturale approssimativa da euristiche di lunghezza. Non modella lessico raro, conoscenze pregresse né morfologia non inglese. Lo usi come segnale trasparente insieme alla revisione umana.
In che modo differisce da una suite completa di leggibilità?
Questa capacità si concentra sul livello scolastico approssimativo da ASL e ASW. Gli strumenti multi-metrici possono anche restituire indici di facilità o indici concorrenti; l’intento di ricerca qui è il grado da lunghezza per istruzione e linguaggio chiaro.
Quale formula usa la stima?
Quella di Flesch–Kincaid: 0,39 per la media di parole per frase, più 11,8 per la media di sillabe per parola, meno 15,59. Frasi e parole più lunghe fanno salire la classe.
Perché il mio testo ottiene una classe negativa?
Frasi molto brevi fatte di parole di una sillaba portano il risultato sotto lo zero. L'esempio su un gatto, una giornata di sole e uccelli che cantano dà -0,9725, che indica semplicemente l'inizio della primaria.
Posso analizzare un testo che non è in inglese?
Lo strumento è pensato per la prosa inglese. Le sillabe si contano con le regole dei gruppi vocalici dell'inglese e la formula è stata creata per questa lingua, quindi serve solo per testi in inglese.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/edu/reading-level-grade \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"The cat sat on the mat. It was a sunny day. Birds sang in the trees."}'const res = await fetch("https://api.kit.forhosting.com/edu/reading-level-grade", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "The cat sat on the mat. It was a sunny day. Birds sang in the trees."
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/edu/reading-level-grade",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "The cat sat on the mat. It was a sunny day. Birds sang in the trees."
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/reading-level-grade", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"The cat sat on the mat. It was a sunny day. Birds sang in the trees."}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"The cat sat on the mat. It was a sunny day. Birds sang in the trees."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/reading-level-grade", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"text": "The cat sat on the mat. It was a sunny day. Birds sang in the trees."
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "edu.reading_level_grade",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Il percorso gratuito nel browser e l’API a pagamento condividono un unico modulo analitico puro, così i controlli dei compiti, i plugin LMS e le dashboard editoriali non divergono mai sulla stessa entrata. Il testo vuoto e le stringhe senza parole alfabetiche falliscono con invalid_input e non vengono addebitati.
Contratto di input, campi di risposta ed errori di validazione
I brani senza parole alfabetiche (ad esempio solo cifre o punteggiatura) falliscono pure perché ASL e ASW sarebbero indefiniti o privi di senso. Input estremamente lunghi oltre il tetto di caratteri documentato vengono rifiutati invece di essere valutati in parte. Esempio: un breve brano da primo lettore con frasi corte e parole perlopiù monosilabiche ottiene punteggi vicino ai gradi bassi della primaria, mentre la prosa accademica con lunghe clausole annidate e termini polisillabici punta verso high school o college. La validazione fallita non viene addebitata. Invii con POST un corpo JSON con un campo stringa obbligatorio chiamato text: il brano inglese da valutare. Gli alias passage, content, body e input_text sono accettati dal solver per comodità nel collegare form più vecchi. Il valore deve essere una stringa non vuota dopo il trim degli spazi; numeri puri, oggetti e stringhe vuote falliscono con invalid_input nominando il campo text. In caso di successo il corpo include word_count, sentence_count e syllable_count per auditare i totali intermedi; avg_sentence_length e avg_syllables_per_word arrotondati per client stabili; grade_level come punteggio continuo Flesch–Kincaid arrotondato; grade_level_clamped entro un intervallo educativo fisso; grade_band come fase scolastica in snake_case; stringhe formula e method che documentano l’identità; e un breve messaggio leggibile che riassume ASL, ASW e il grado stimato.
Dove un’API di grado da lunghezza conviene
I team di materiali didattici usano un calcolatore di livello di lettura per allineare le schede agli anni target prima della stampa. I programmi di accessibilità e linguaggio chiaro monitorano se gli avvisi pubblici superano la banda di grado consentita dalla policy, senza pagare per token un modello generativo di riscrittura quando serve solo un punteggio strutturale. I flussi di pubblicazione bloccano bozze di blog che superano una soglia di grado scelta e lasciano la riscrittura stilistica a redattori umani o a una capacità separata di riscrittura CEFR quando è richiesta la parafrasi completa. La combini con stime del tempo di lettura o dashboard di leggibilità multi-metrica quando serve durata o indici concorrenti; tenga questo endpoint quando la domanda di prodotto è specificamente il grado scolastico approssimativo da lunghezza della frase e densità sillabica.
Casi di integrazione
Automazione CMS ed editoriale
Chiami l’API da una pipeline di contenuti per etichettare i post con grade_level e grade_band senza eseguire un modello generativo.
Domande tecniche
Come si calcola il livello di lettura dal testo?
L’API conta parole, frasi e sillabe, poi applica grade = 0.39×(words/sentences) + 11.8×(syllables/words) − 15.59, la formula Flesch–Kincaid Grade Level basata sulla lunghezza media della frase e sulla media di sillabe per parola.
Quale input richiede il calcolatore di livello di grado del testo?
Invii una stringa inglese non vuota nel campo text (alias: passage, content, body, input_text). Stringhe vuote e testo senza parole alfabetiche falliscono con invalid_input e non vengono addebitati.
Quanto costa lo stimatore del livello di lettura?
Lo strumento nel browser è gratuito. Le richieste API usano il saldo prepagato KIT a $0.002 per chiamata riuscita; l’input non valido non viene addebitato.