Calculadora de eficácia vacinal
Com 20 infecções entre 1000 vacinados e 80 entre 1000 no placebo, a eficácia vacinal é de 75%. Informe os quatro números da tabela de resultados de um estudo para recalcular você mesmo o percentual divulgado. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Infecções em vacinados
- 20
- Vacinados (n)
- 1.000
- Infecções com placebo
- 80
- Placebo (n)
- 1.000
- Taxa de ataque em vacinados
- 0,02 percent
- Taxa de ataque com placebo
- 0,08
- Risco relativo
- 0,25
- Eficácia (%)
- 75
A eficácia vacinal é a redução percentual do risco de infecção entre pessoas vacinadas em comparação com um grupo placebo ou não vacinado observado na mesma janela do estudo. Estudantes, analistas de ensaios, jornalistas e equipes de produto calculam esse percentual a partir de quatro números: infecções no braço vacinado, tamanho do braço vacinado, infecções no braço placebo e tamanho do braço placebo. Esta calculadora de eficácia vacinal aplica a identidade clássica de um menos o risco relativo: divida a taxa de ataque vacinada pela taxa de ataque do placebo, subtraia esse risco relativo de um e multiplique por cem.
O que significa eficácia vacinal e como as quatro contagens viram um percentual
A eficácia vacinal, frequentemente abreviada VE, é a redução percentual do risco de um desfecho definido entre pessoas que receberam a vacina em comparação com quem recebeu placebo ou permaneceu sem vacinar. O estimador clássico usado em livros, documentos de agências e cursos introdutórios de epidemiologia é um menos o risco relativo, expresso como percentual. O risco relativo é a taxa de ataque vacinada dividida pela taxa de ataque do placebo.
Quando as duas taxas de ataque são iguais, a eficácia é zero porque a vacina não alterou o risco nesta tabela bruta. Quando o braço vacinado não tem infecções e o placebo tem algumas, a eficácia é cem por cento. Quando o braço vacinado tem taxa de ataque maior que o placebo, o percentual é negativo, e esta calculadora o informa com honestidade em vez de recortar para zero ou esconder o sinal.
Use-a quando você já tiver contagens de coorte fechada e precisar de um VE percentual reproduzível, não quando ainda precisar de pessoa-tempo, acompanhamento sobreposto ou a análise primária especificada no protocolo.
Contrato de entrada, forma da resposta e comportamento de erro
Qualquer contagem negativa falha porque um ensaio não pode registrar menos três infecções nem uma lista negativa. Um tamanho de grupo igual a zero falha porque a taxa de ataque é infecções divididas por n, e a divisão por zero é indefinida. Contagens de infecção que excedem o tamanho do próprio grupo falham porque uma taxa de ataque maior que um não é uma proporção válida de coorte fechada.
Se o braço placebo registrou zero infecções, a taxa de ataque do placebo é zero e o risco relativo é indefinido, então a tarefa falha em vez de devolver Infinity. Validação com falha não é cobrada.
Onde é útil e quais são os limites
Salas de aula e plataformas de tutoria usam uma calculadora de eficácia vacinal para que aprendizes confiram a lição contra um oráculo determinístico em vez de um erro silencioso de planilha no passo do risco relativo. Validação com falha não consome saldo. Isto é uma ferramenta de cálculo e ensino, não um dispositivo médico de diagnóstico nem um substituto de uma análise especificada pelo protocolo com pessoa-tempo, intervalos de confiança sobrepostos ou desfechos regulatórios.
Pessoas que tomam decisões de saúde pessoal devem seguir o conselho médico profissional e a análise estatística publicada do ensaio, não um único percentual automatizado. Mantenha as solicitações pequenas, fixe os campos arredondados nos testes e você obtém eficácia vacinal reproduzível para lição de casa, gráficos de redação e workers de borda sem montar a própria pilha de bioestatística.
Casos de uso
Jornalismo científico e explicadores de ensaios
Recalcule a eficácia vacinal de manchete de um ensaio publicado a partir das quatro contagens da tabela de resultados e cite um percentual determinístico ao lado dos números de origem.
Perguntas frequentes
Como a eficácia vacinal é calculada a partir das contagens de infecção?
O percentual de eficácia é (1 − (ARV/ARU)) × 100, em que ARV é infecções vacinadas sobre n vacinado e ARU é infecções placebo sobre n placebo.
O que acontece se o tamanho de um grupo for zero ou uma contagem for negativa?
Contagens negativas não são dados válidos de ensaio, e um tamanho de grupo igual a zero deixa a taxa de ataque indefinida. Essas falhas não são cobradas.
A eficácia vacinal pode ser negativa ou passar de cem por cento?
Eficácia negativa é devolvida quando a taxa de ataque vacinada supera a do placebo. Valores acima de cem por cento não ocorrem com contagens válidas de coorte fechada (infecções não podem ser negativas, então ARV não pode ficar abaixo de zero).
Qual é a diferença entre eficácia vacinal e efetividade vacinal?
Esta calculadora informa eficácia vacinal no estilo de um ensaio, de um braço vacinado versus um comparador placebo ou não vacinado, usando quatro contagens. A efetividade vacinal observacional a partir de pessoa-tempo do mundo real ou desenhos de teste negativo é outra análise e outra intenção de busca.
A calculadora dá um intervalo de confiança?
Não. Ela aplica só a identidade dos quatro números, um menos o risco relativo. Não ajusta curvas de Kaplan-Meier, modelos de Poisson nem intervalos de confiança, e não trabalha com pessoa-tempo.
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/health/vaccine-efficacy \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"vaccinated_infections":20,"vaccinated_n":1000,"placebo_infections":80,"placebo_n":1000}'const res = await fetch("https://api.kit.forhosting.com/health/vaccine-efficacy", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"vaccinated_infections": 20,
"vaccinated_n": 1000,
"placebo_infections": 80,
"placebo_n": 1000
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/health/vaccine-efficacy",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"vaccinated_infections": 20,
"vaccinated_n": 1000,
"placebo_infections": 80,
"placebo_n": 1000
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/health/vaccine-efficacy", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"vaccinated_infections":20,"vaccinated_n":1000,"placebo_infections":80,"placebo_n":1000}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"vaccinated_infections":20,"vaccinated_n":1000,"placebo_infections":80,"placebo_n":1000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/health/vaccine-efficacy", 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
{
"vaccinated_infections": 20,
"vaccinated_n": 1000,
"placebo_infections": 80,
"placebo_n": 1000
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "health.vaccine_efficacy",
"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
O resultado é um efficacy_percent estável que você pode fixar em testes, planilhas e painéis. Contagens negativas e tamanhos de grupo iguais a zero falham com invalid_input e nunca são cobrados.
O que significa eficácia vacinal e como as quatro contagens viram um percentual
A taxa de ataque em cada braço é simplesmente infecções divididas pelo tamanho daquele braço: vaccinated_infections sobre vaccinated_n, e placebo_infections sobre placebo_n. Multiplicar o complemento dessa razão por cem produz efficacy_percent. Este endpoint não ajusta curvas de Kaplan–Meier, modelos de Poisson nem intervalos de confiança; é a identidade de quatro contagens que jornalistas e estudantes realmente digitam numa planilha. Entradas idênticas sempre produzem o mesmo JSON porque o caminho é aritmética pura, sem rede, sem modelo, sem semente aleatória e sem relógio de parede.
Contrato de entrada, forma da resposta e comportamento de erro
Envie um corpo JSON com quatro números finitos obrigatórios. vaccinated_infections é o número de eventos de desfecho no grupo vacinado. vaccinated_n é o número de pessoas, ou unidades de lista comparáveis, naquele grupo e deve ser maior que zero. placebo_infections é o número de eventos de desfecho no comparador placebo ou não vacinado. placebo_n é o tamanho do grupo comparador e deve ser maior que zero. Cada campo pode chegar como número JSON ou como string numérica; aliases documentados como vaccinated_cases, n_vaccinated, placebo_cases e unvaccinated_n são aceitos quando o nome canônico é omitido. Campos ausentes, strings vazias e valores não finitos falham com invalid_input nomeando o campo. Em sucesso, o corpo ecoa as quatro entradas, informa vaccinated_attack_rate e placebo_attack_rate como proporções, informa relative_risk como a razão delas e informa efficacy_percent como cem vezes um menos essa razão. unit é sempre percent. formula reitera a identidade para que uma interface mostre a linha didática ao lado do número. method é sempre one_minus_relative_risk para que o código a jusante ramifique sem farejar formas.
Onde uma API de eficácia vacinal se paga, preço e limites
Mesas de divulgação científica recalculam o VE de manchete de um ensaio publicado a partir das quatro contagens da tabela de resultados e citam efficacy_percent sem rederivar a identidade sob prazo. Equipes de produto que já armazenam tamanhos de braço e contagens de eventos em um warehouse podem enviar esses quatro campos e persistir efficacy_percent ao lado das contagens brutas para painéis e colunas de exportação. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002, sem tokens de modelo e sem rede de saída.
Casos de integração
Lição de epidemiologia e correção de provas
Deixe os alunos enviarem contagens de infecção vacinadas e placebo com tamanhos de grupo e verificarem efficacy_percent contra a identidade clássica de um menos o risco relativo.
Apps de educação em saúde e backends SaaS
Chame o mesmo contrato de quatro contagens a partir de um widget de navegador gratuito e da correção API pré-paga para que demos de sala e pipelines de produção nunca discordem.
Perguntas técnicas
Quanto custa a calculadora de eficácia vacinal?
A ferramenta do navegador é gratuita. Solicitações API usam saldo KIT pré-pago a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.