ForHosting KIT · Testi e IA

Verifichi la leggibilità per il pubblico target

Un indice di leggibilità è utile solo se viene interpretato pensando alle persone che leggeranno il materiale.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Questo controllo riceve un livello scolastico calcolato e un pubblico target, quindi confronta il valore con un intervallo atteso chiaro. Indica se il testo è adeguato, troppo facile o troppo difficile. Lei può usarlo dopo qualsiasi calcolatore di livello per trasformare un punteggio astratto in una decisione editoriale coerente per informazioni pubbliche, documentazione tecnica o materiali destinati ai bambini.

Parta da un livello scolastico già calcolato

Questa capacità valuta un livello che Lei possiede già; non analizza prosa grezza e non calcola una formula di leggibilità. Inserisca il risultato numerico di uno strumento come Flesch-Kincaid insieme a un pubblico supportato. I valori decimali sono accettati, poiché le formule producono spesso risultati come 7.4. Il controllo conserva il valore e lo confronta con estremi inclusivi. Per i bambini sono previsti i livelli da 1 a 5, per il pubblico generale da 6 a 8 e per il materiale tecnico da 9 a 14. Queste fasce sono obiettivi editoriali, non giudizi sull'istruzione o sulle capacità di una persona. Un punteggio nella fascia è indicato come adeguato; un punteggio inferiore è troppo facile, mentre uno superiore è troppo difficile. Separare il calcolo dalla valutazione permette di riutilizzare la decisione con sistemi diversi, purché producano un livello scolastico convenzionale. Consente inoltre di conservare il punteggio originale accanto alla decisione per una revisione successiva.

Scelga il pubblico in base allo scopo del documento

Selezioni children quando il materiale è scritto appositamente per giovani lettori autonomi, per esempio istruzioni scolastiche, attività museali o spiegazioni basilari di sicurezza. Scelga general_public per servizi, annunci, pagine di assistenza e informazioni al consumatore che devono essere comprese senza preparazione specialistica. Usi technical quando il lettore conosce il lessico professionale e può affrontare strutture più dense, come in note ingegneristiche, concetti di API o procedure di ricerca. I nomi sono esatti: children, general_public e technical. Un valore sconosciuto genera un errore anziché una scelta presunta, perché un ripiego silenzioso potrebbe approvare contenuti secondo lo standard errato. Il pubblico deve riflettere la funzione del documento, non soltanto chi lo ha scritto. Un'azienda software può pubblicare indicazioni di fatturazione per tutti e documentazione tecnica di integrazione. Inoltre, un livello basso non è sempre migliore: una semplificazione eccessiva può eliminare precisione, mentre un testo sopra la fascia infantile può ostacolare i lettori previsti.

Usi la valutazione come segnale editoriale

Il risultato comprende il livello fornito, il pubblico scelto, l'intervallo esatto, un indicatore booleano e una valutazione sintetica. Un esito adeguato significa che il numero rientra nella fascia, estremi inclusi. Troppo difficile suggerisce di cercare frasi lunghe, subordinate annidate, parole inconsuete o termini non spiegati prima di misurare nuovamente. Troppo facile indica che il testo è sotto l'obiettivo; nei contenuti tecnici, controlli se la semplificazione ha rimosso distinzioni, vincoli o termini necessari. Il risultato è deterministico: input identici producono sempre lo stesso output, senza valutazioni di modelli, rete, casualità o dati mutevoli. È quindi adatto a controlli di pubblicazione, sistemi editoriali e verifiche ripetibili. Tuttavia, il livello misura la difficoltà superficiale, non accuratezza, tono, accessibilità o adeguatezza culturale. Consideri la corrispondenza un elemento di prova, non un'approvazione finale. La revisione umana resta importante per istruzioni critiche e materiali infantili. Nell'automazione, conservi punteggio e valutazione per rendere comprensibili segnalazioni, approvazioni ed eventuali eccezioni documentate.

Casi d'uso

Controlli i contenuti di servizio pubblico

Segnali prima della pubblicazione gli avvisi sopra la fascia generale affinché possano essere semplificati.

Revisioni i materiali per bambini

Confronti il livello calcolato con la fascia infantile e individui i passaggi da rivedere.

Uniformi la documentazione tecnica

Applichi una politica esplicita a manuali, basi di conoscenza e note di rilascio.

Domande frequenti

Questo strumento calcola il livello dal testo?

No. Inserisca un livello già calcolato con una formula di leggibilità o un altro strumento.

Quali intervalli vengono usati?

Bambini 1–5, pubblico generale 6–8 e lettori tecnici 9–14. Gli estremi sono inclusi.

Il livello può contenere decimali?

Sì. È accettato e conservato qualsiasi numero finito da 0 a 20.

Che cosa accade con un pubblico sconosciuto?

La richiesta restituisce un errore di input, senza scegliere automaticamente un intervallo.

Quanto costa il controllo tramite API?

Ogni richiesta API costa $0.002. Lo stesso controllo deterministico è gratuito nel browser.

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

POSThttps://api.kit.forhosting.com/write/readability-by-audience

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/write/readability-by-audience \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"grade_level":7.4,"audience":"general_public"}'

const res = await fetch("https://api.kit.forhosting.com/write/readability-by-audience", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "grade_level": 7.4,
    "audience": "general_public"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/write/readability-by-audience",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "grade_level": 7.4,
    "audience": "general_public"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/write/readability-by-audience", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"grade_level":7.4,"audience":"general_public"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"grade_level":7.4,"audience":"general_public"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/write/readability-by-audience", 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

{
  "grade_level": 7.4,
  "audience": "general_public"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "write.readability_by_audience",
  "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

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Limiti

max_tokens 20000

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.

Leggi la documentazione completa del KIT →