Índice Coleman-Liau
Três frases curtas sobre um gato num tapete dão −2,975, perto da série −3: início do ensino fundamental. Cole um texto em inglês e veja a série Coleman-Liau com as letras e frases por 100 palavras que a explicam. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
O índice Coleman–Liau estima a série escolar dos Estados Unidos de que um leitor típico precisaria para compreender um trecho. Diferente das pontuações baseadas em sílabas como Flesch–Kincaid, esta fórmula usa apenas letras, palavras e frases: contagens que um computador obtém sem um dicionário de pronúncia. Cole prosa em inglês e esta calculadora devolve o índice, as duas taxas que o alimentam (letras por 100 palavras e frases por 100 palavras), uma série arredondada e uma faixa escolar grosseira. Use a pontuação como sinal transparente de complexidade de superfície, não como afirmação sobre vocabulário raro ou conhecimento do tema.
O que o índice Coleman-Liau mede e como a fórmula funciona
Meri Coleman e T. L. Liau publicaram este índice para que máquinas pudessem pontuar a legibilidade sem adivinhar sílabas a partir da grafia. A identidade pública é CLI igual a 0.0588 vezes L menos 0.296 vezes S menos 15.8.
L é o número médio de letras por cem palavras. S é o número médio de frases por cem palavras. Aqui as letras são caracteres alfabéticos de A a Z em qualquer caixa; dígitos, pontuação, marcas de moeda e espaços em branco não entram na contagem de letras.
Palavras são tokens alfabéticos, e uma contração com apóstrofo como don't conta como uma palavra, não como dois fragmentos. Frases são unidades encerradas por ponto, interrogação ou exclamação. Se o trecho não tem marca terminal, todo o texto aparado é tratado como uma frase para as duas taxas permanecerem definidas.
Palavras mais longas elevam L e empurram a série para cima. Quebras de frase mais frequentes elevam S e puxam a série para baixo. O resultado já é uma estimativa de série: uma pontuação perto de oito significa cerca da oitava série, não uma escala abstrata de facilidade de zero a cem.
Pontuações negativas ou muito baixas correspondem a material do fundamental inicial; as da metade da dezena ficam no nível universitário; valores ainda mais altos recebem o rótulo graduate. Esta página é especificamente a calculadora do índice Coleman-Liau, não um pacote de legibilidade multi-métrica nem um estimador de série escolar baseado em sílabas.
Contrato de entrada, contagens auditáveis e erros de validação
Trechos sem palavras alfabéticas, por exemplo só dígitos ou pontuação, também falham porque L e S ficariam indefinidos. Entradas extremamente longas acima do teto de caracteres documentado são recusadas em vez de pontuadas pela metade. Um trecho curto de primeiro leitor, com palavras breves e paradas frequentes, pontua perto das séries baixas do fundamental.
A prosa acadêmica com tokens latinos longos e poucos pontos se orienta para high school, college ou graduate. A validação falha não é cobrada. Fixe os campos arredondados nos testes para que uma mudança posterior de redação na mensagem não esconda uma regressão real da fórmula.
Onde uma calculadora Coleman-Liau se paga
Equipes editoriais usam uma calculadora do índice Coleman-Liau quando o guia de estilo já nomeia essa fórmula, em vez de uma pontuação genérica de legibilidade ou um grau Flesch–Kincaid baseado em sílabas. Programas de linguagem clara em governo, saúde e finanças citam Coleman–Liau com frequência porque é barato recalcular a cada rascunho e não depende de um léxico de pronúncia que mudaria conforme o dialeto.
Fluxos de publicação podem bloquear rascunhos de blog que ultrapassam uma série escolhida sem pagar por token uma reescrita generativa quando só precisam de uma pontuação estrutural. Trate a heurística como aproximada fora do inglês, ignore-a como medida de exatidão factual, e você obtém um sinal de série reproduzível para plugins LMS, painéis editoriais e workers de borda sem montar infraestrutura linguística própria.
Casos de uso
Meta editorial de série
Cole um rascunho e confirme que o índice Coleman-Liau fica perto da série que o guia de estilo nomeia antes de publicar ou imprimir.
Checagens de política de linguagem clara
Pontue avisos públicos e artigos de ajuda para as equipes sinalizarem rascunhos que ultrapassam a faixa permitida do fundamental II ou do ensino médio.
Perguntas frequentes
Como o índice Coleman-Liau é calculado?
O resultado é uma série escolar dos EUA aproximada.
Em que o Coleman-Liau difere de Flesch-Kincaid ou Gunning Fog?
Coleman-Liau nunca conta sílabas. Usa só letras, palavras e frases, por isso um computador pontua sem dicionário de pronúncia. Flesch-Kincaid e Gunning Fog dependem de heurísticas de sílaba ou de palavra complexa e respondem a outra busca.
A série é exata para cada leitor?
Não. É uma estimativa estrutural aproximada a partir das taxas de letras e de frases. Não modela vocabulário raro, conhecimento prévio nem morfologia fora do inglês. Use-a como sinal transparente junto à revisão humana.
O que significa uma pontuação Coleman-Liau negativa?
Que o texto é muito simples, do começo do ensino fundamental. Três frases curtas sobre um gato num tapete dão −2,975, perto da série −3, porque as palavras são curtas e os pontos finais aparecem com frequência.
Como baixo a série do meu texto?
Use palavras mais curtas e divida as frases longas. Palavras longas aumentam as letras por 100 palavras e puxam a série para cima; pontos finais mais frequentes aumentam as frases por 100 palavras e a puxam para baixo.
Ferramentas relacionadas
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/str/coleman-liau \
-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/str/coleman-liau", {
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/str/coleman-liau",
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/str/coleman-liau", 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/str/coleman-liau", 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
{
"text": "The cat sat on the mat. It was a sunny day. Birds sang in the trees."
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "str.coleman_liau",
"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.
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. |
Notas técnicas
Texto vazio e cadeias sem palavras alfabéticas falham com invalid_input e não são cobrados.
Contrato de entrada, contagens auditáveis e erros de validação
Envie por POST um corpo JSON com um campo de string obrigatório chamado text: o trecho em inglês a pontuar. Os aliases passage, content, body e input_text são aceitos ao ligar formulários antigos. O valor deve ser uma string não vazia após aparar espaços; objetos, arrays e strings vazias falham com invalid_input nomeando o campo text. No sucesso o corpo inclui letter_count, word_count e sentence_count para auditar os três ingredientes; letters_per_100_words e sentences_per_100_words como L e S arredondados para clientes estáveis; coleman_liau_index como a pontuação contínua arredondada; grade_level igual a esse índice; grade_level_rounded como a série inteira mais próxima; grade_band como etapa escolar em snake_case, por exemplo elementary, middle_school, high_school, college ou graduate; strings formula e method que documentam a identidade; e uma mensagem curta legível que resume L, S e a série estimada.
Onde uma calculadora Coleman-Liau se paga
Grupos de materiais de sala conferem se uma ficha fica perto da série pretendida antes da impressão e guardam letter_count, word_count e sentence_count ao lado do índice para um revisor ver por que a série se moveu. Como esta capacidade é parse de nível A, cada chamada bem-sucedida custa o US$ 0,002 publicado, sem tokens de modelo e sem rede de saída, o que torna acessível re-pontuar em lote um arquivo CMS. Combine-a com um painel de legibilidade multi-métrica ou com um estimador de série por sílabas quando esses forem os termos buscados; conserve este endpoint quando a pergunta de produto for especificamente Coleman–Liau a partir de letras, palavras e frases.
Casos de integração
Automação de CMS e pipeline
Chame a API a partir de um pipeline de conteúdo para marcar posts com coleman_liau_index e grade_band sem executar um modelo generativo.
Perguntas técnicas
Qual entrada a calculadora Coleman-Liau precisa?
Envie uma string inglesa não vazia no campo text (aliases: passage, content, body, input_text). Strings vazias e texto sem palavras alfabéticas falham com invalid_input e não são cobrados.
Quanto custa a calculadora do índice Coleman-Liau?
A ferramenta do navegador é grátis. Pedidos API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.