Verifique a legibilidade para seu público-alvo
Uma pontuação de legibilidade só é útil quando interpretada para as pessoas que lerão o material.
Executar grátis
Este verificador recebe um nível escolar calculado e um público-alvo, e compara o número com uma faixa esperada clara. Ele informa se o texto está adequado, fácil demais ou difícil demais. Use-o após qualquer calculadora de nível para transformar uma pontuação abstrata em uma decisão editorial consistente para informações públicas, documentação técnica ou materiais destinados a crianças.
Comece com um nível escolar calculado
Esta capacidade avalia um nível que você já possui; ela não analisa texto bruto nem calcula uma fórmula de legibilidade. Informe o resultado numérico de uma ferramenta como Flesch-Kincaid e um identificador de público aceito. Valores decimais são bem-vindos, pois as fórmulas costumam gerar resultados como 7.4. O verificador preserva o valor e o compara com limites inclusivos. Para crianças, a faixa esperada vai de 1 a 5; para o público geral, de 6 a 8; e para material técnico, de 9 a 14. Essas faixas são metas editoriais, não afirmações sobre a escolaridade ou a capacidade de uma pessoa. Um resultado dentro da faixa é marcado como adequado. Abaixo dela, o texto é considerado fácil demais; acima, difícil demais. Separar o cálculo da avaliação permite reutilizar a decisão com diferentes sistemas de pontuação, desde que o resultado represente um nível escolar convencional. Isso também permite armazenar a pontuação original junto da decisão para futuras revisões.
Escolha o público conforme a função do documento
Selecione children quando o material for escrito intencionalmente para jovens leitores independentes, como instruções escolares, atividades de museu ou explicações básicas de segurança. Selecione general_public para serviços, comunicados, páginas de ajuda e informações ao consumidor que precisam ser compreendidas sem formação especializada. Use technical quando se espera vocabulário profissional e estruturas mais densas, como em notas de engenharia, conceitos de API ou operações de pesquisa. Os nomes são exatos: children, general_public e technical. Um valor desconhecido gera erro, em vez de uma tentativa de adivinhação, pois um padrão silencioso poderia aprovar conteúdo pela norma errada. A escolha deve seguir a finalidade do documento, e não apenas a identidade de quem o escreveu. Uma empresa de software pode publicar orientações de cobrança para o público geral e documentação técnica de integração. Além disso, uma nota baixa nem sempre é melhor: simplificação excessiva pode retirar precisão, enquanto um texto acima da faixa infantil pode dificultar a ação dos leitores.
Use a avaliação como sinal editorial
A saída inclui o nível informado, o público selecionado, a faixa exata, uma confirmação booleana e uma avaliação compacta. Um resultado adequado indica que o número está dentro da faixa, inclusive nos limites. Difícil demais sugere procurar frases longas, orações aninhadas, palavras incomuns ou termos sem explicação antes de calcular novamente. Fácil demais indica que o texto ficou abaixo da meta; em trabalhos técnicos, confira se a simplificação removeu distinções, restrições ou termos necessários. O resultado é determinístico: entradas idênticas sempre geram saídas idênticas, sem julgamento de modelo, rede, aleatoriedade ou dados mutáveis. Isso o torna apropriado para etapas de publicação, sistemas de conteúdo e auditorias reproduzíveis. Ainda assim, o nível mede dificuldade superficial, não precisão factual, tom, acessibilidade ou adequação cultural. Trate a correspondência como uma evidência, não como aprovação final. A revisão humana continua importante para instruções críticas e materiais infantis. Em automações, guarde a pontuação e a avaliação para justificar alertas, aprovações e exceções documentadas.
Casos de uso
Controle conteúdo de serviço público
Sinalize comunicados acima da faixa geral antes da publicação para que uma pessoa editora possa simplificá-los.
Revise materiais infantis
Compare o nível calculado com a faixa infantil e identifique trechos que precisam de revisão.
Padronize documentação técnica
Aplique uma política explícita de leitura a manuais, bases de conhecimento e notas de versão.
Perguntas frequentes
Este recurso calcula o nível a partir do texto?
Não. Informe um nível já calculado por uma fórmula de legibilidade ou outra ferramenta de pontuação.
Quais faixas são usadas?
Crianças usam níveis 1–5, público geral 6–8 e leitores técnicos 9–14. Os limites são inclusivos.
O nível pode ter casas decimais?
Sim. Qualquer número finito de 0 a 20 é aceito e preservado no resultado.
O que ocorre com um público desconhecido?
A solicitação falha com erro de entrada inválida, sem escolher uma faixa automaticamente.
Quanto custa a verificação pela API?
Cada solicitação de API custa US$ 0,002. A mesma verificação determinística pode ser executada gratuitamente no navegador.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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)Exemplo de requisição
{
"grade_level": 7.4,
"audience": "general_public"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "write.readability_by_audience",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_tokens | 20000 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |