Ordene vocabulário por frequência para priorizar o ensino
Este classificador de frequência transforma uma lista de palavras proposta em uma ordem prática de ensino.
Executar grátis
Forneça as palavras que você está avaliando e uma tabela geral de frequência derivada de um corpus adequado aos seus estudantes. O resultado coloca primeiro as palavras encontradas, da maior para a menor frequência, mantém a ordem original nos empates e leva ao final os itens ausentes da referência. Cada resultado informa se houve correspondência e qual frequência foi usada, para que docentes, autores de currículos e equipes de produtos educacionais possam examinar a classificação em vez de aceitar uma pontuação sem explicação.
Escolha uma referência de frequência adequada aos estudantes
Uma classificação por frequência só é relevante quando o corpus de referência também é. Comece com uma tabela ampla obtida da língua e do registro de que seus estudantes precisam: conversação cotidiana, inglês escrito geral, textos escolares ou outra coleção claramente definida. Cada entrada precisa conter uma palavra e um valor de frequência não negativo. Esse valor pode ser uma contagem bruta, ocorrências por milhão de palavras ou outra taxa consistente, pois o classificador compara magnitudes sem pressupor uma unidade específica. Não misture contagens de corpora diferentes na mesma tabela: uma contagem bruta de uma fonte muito grande dominaria uma taxa normalizada de uma fonte menor. Por padrão, a correspondência ignora maiúsculas e remove espaços externos, portanto “Water” pode corresponder a “water”. Ative a diferenciação de maiúsculas apenas quando elas distinguirem itens importantes para a aula. As chaves devem ser únicas depois da normalização; duplicatas são rejeitadas, e não combinadas silenciosamente. Isso esclarece a origem de cada frequência e impede que linhas repetidas ou conflitantes gerem uma ordem arbitrária de ensino.
Interprete a lista ordenada e os itens sem correspondência
A resposta ordena o vocabulário encontrado da maior para a menor frequência de referência. Assim, uma palavra funcional comum pode aparecer antes de uma palavra de conteúdo conhecida, enquanto um termo especializado pode ficar bem mais abaixo. Quando dois itens têm exatamente a mesma frequência, eles preservam a ordem da lista original, produzindo um resultado estável entre execuções. Palavras ausentes da tabela aparecem depois de todas as correspondências e também mantêm sua ordem relativa. Elas recebem frequência zero e found_in_reference igual a false, permitindo distingui-las de correspondências reais pelo campo booleano. Os totais resumidos mostram quantos itens enviados foram encontrados e quantos não foram. A capacidade mantém palavras repetidas porque cada posição pode representar um item curricular intencional; ela não remove duplicatas nem altera a grafia. Considere a posição um sinal de priorização, e não uma afirmação de dificuldade. A frequência mostra quantas vezes uma forma ocorre no corpus escolhido, mas não mede complexidade conceitual, pronúncia, necessidade do estudante ou pré-requisitos didáticos.
Transforme evidências do corpus em uma sequência didática
Use a classificação como primeira etapa do planejamento curricular e depois aplique seu julgamento profissional. Palavras frequentes costumam oferecer ampla exposição e utilidade inicial, portanto são boas candidatas para aulas introdutórias, prática de recuperação ou espaço limitado em cartões. Ainda assim, uma palavra menos frequente pode ser essencial para uma unidade de ciências, uma tarefa profissional, um objetivo de prova ou uma instrução de segurança. Examine separadamente os itens não encontrados: a ausência pode indicar raridade, mas também uma variante ortográfica, uma forma flexionada, uma expressão composta ou uma lacuna no corpus. Para tornar o planejamento reproduzível, registre com a saída o nome, a versão, a data e a unidade de frequência do corpus, embora o cálculo não exija esses dados. O navegador atende listas individuais, enquanto fluxos curriculares automatizados podem chamar a mesma operação determinística pela API por US$ 0,002 por solicitação. Como não ocorre consulta de rede, você controla a referência e pode repetir exatamente a comparação. Um fluxo sólido ordena a lista, investiga ausências, acrescenta importância curricular e nível dos estudantes e documenta qualquer mudança intencional na ordem de frequência.
Casos de uso
Planeje um conjunto inicial de palavras
Coloque primeiro as palavras de exposição mais ampla quando o tempo de aula ou o espaço para cartões for limitado.
Audite uma lista curricular
Compare os termos propostos com um corpus documentado e sinalize palavras que não aparecem na referência.
Priorize conteúdo para aprender idiomas
Crie uma ordem inicial estável antes que editores apliquem critérios de nível, tema e metodologia.
Perguntas frequentes
Que tipos de valores de frequência posso usar?
Use contagens, ocorrências por milhão ou outra medida numérica não negativa, desde que todas as linhas adotem a mesma unidade e base de corpus.
O que acontece com palavras ausentes da tabela?
Elas aparecem depois de todas as correspondências, com found_in_reference igual a false e frequência zero, mantendo a ordem enviada.
Como os empates são resolvidos?
Palavras com o mesmo estado de correspondência e a mesma frequência preservam a ordem da lista original.
A correspondência diferencia maiúsculas?
Não por padrão. Ela remove espaços externos e ignora maiúsculas, a menos que case_sensitive seja true.
Quanto custa uma solicitação à API?
Cada solicitação à API custa US$ 0,002. A mesma classificação determinística também pode ser executada 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/edu/vocabulary-list-frequency-rank \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"words":["photosynthesis","water","ecosystem","the"],"frequency_table":[{"word":"the","frequency":22038615},{"word":"water","frequency":31245},{"word":"ecosystem","frequency":2310}]}'const res = await fetch("https://api.kit.forhosting.com/edu/vocabulary-list-frequency-rank", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"words": [
"photosynthesis",
"water",
"ecosystem",
"the"
],
"frequency_table": [
{
"word": "the",
"frequency": 22038615
},
{
"word": "water",
"frequency": 31245
},
{
"word": "ecosystem",
"frequency": 2310
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/edu/vocabulary-list-frequency-rank",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"words": [
"photosynthesis",
"water",
"ecosystem",
"the"
],
"frequency_table": [
{
"word": "the",
"frequency": 22038615
},
{
"word": "water",
"frequency": 31245
},
{
"word": "ecosystem",
"frequency": 2310
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/vocabulary-list-frequency-rank", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"words":["photosynthesis","water","ecosystem","the"],"frequency_table":[{"word":"the","frequency":22038615},{"word":"water","frequency":31245},{"word":"ecosystem","frequency":2310}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"words":["photosynthesis","water","ecosystem","the"],"frequency_table":[{"word":"the","frequency":22038615},{"word":"water","frequency":31245},{"word":"ecosystem","frequency":2310}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/vocabulary-list-frequency-rank", 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
{
"words": [
"photosynthesis",
"water",
"ecosystem",
"the"
],
"frequency_table": [
{
"word": "the",
"frequency": 22038615
},
{
"word": "water",
"frequency": 31245
},
{
"word": "ecosystem",
"frequency": 2310
}
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "edu.vocabulary_list_frequency_rank",
"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. |