Nível escolar do texto por comprimento

O caminho gratuito no navegador e a API paga compartilham um único módulo analítico puro, de modo que checagens de lição de casa, plugins LMS e painéis editoriais nunca discordam sobre a mesma entrada. Texto vazio e strings sem palavras alfabéticas falham com invalid_input e não são cobrados.

Contrato de entrada, campos de resposta e erros de validação

Trechos sem palavras alfabéticas (por exemplo só dígitos ou pontuação) também falham porque ASL e ASW seriam indefinidos ou sem sentido. Entradas extremamente longas acima do teto de caracteres documentado são rejeitadas em vez de pontuadas parcialmente. Exemplo: um trecho curto de leitor iniciante com sentenças curtas e palavras em sua maioria monossilábicas pontua perto dos graus iniciais do fundamental, enquanto prosa acadêmica com cláusulas longas aninhadas e termos multissilábicos tende a high school ou college. Validação falha não é cobrada. 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 pelo solver por conveniência ao ligar formulários antigos. O valor deve ser uma string não vazia após aparar espaços; números puros, objetos e strings vazias falham com invalid_input nomeando o campo text. No sucesso o corpo inclui word_count, sentence_count e syllable_count para auditar totais intermediários; avg_sentence_length e avg_syllables_per_word arredondados para clientes estáveis; grade_level como pontuação contínua Flesch–Kincaid arredondada; grade_level_clamped dentro de um intervalo educativo fixo; grade_band como etapa escolar em snake_case; strings formula e method que documentam a identidade; e uma mensagem curta legível resumindo ASL, ASW e o grau estimado.

Onde uma API de grau por comprimento se paga

Equipes de materiais escolares usam uma calculadora de nível de leitura para alinhar folhas de exercícios aos anos-alvo antes da impressão. Programas de acessibilidade e linguagem clara acompanham se avisos públicos ultrapassam a banda de grau que a política permite, sem pagar por token a um modelo generativo de reescrita quando só precisam de uma pontuação estrutural. Fluxos de publicação bloqueiam rascunhos de blog que disparam acima de um limiar de grau escolhido e deixam a reescrita estilística a editores humanos ou a uma capacidade separada de reescrita CEFR quando a paráfrase completa é necessária. Combine com estimativas de tempo de leitura ou painéis de legibilidade multi-métrica quando precisar de duração ou índices concorrentes; mantenha este endpoint quando a pergunta de produto for especificamente o grau escolar aproximado a partir do comprimento de frase e da densidade silábica.