ForHosting KIT · Saúde e esporte

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
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Infecções em vacinados
20
Vacinados (n)
1.000
Infecções com placebo
80
Placebo (n)
1.000
Você obtém
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.

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.

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.

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.

POSThttps://api.kit.forhosting.com/health/vaccine-efficacy

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

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}'
{
  "vaccinated_infections": 20,
  "vaccinated_n": 1000,
  "placebo_infections": 80,
  "placebo_n": 1000
}
{
  "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.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

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.

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.

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.

Ver a documentação completa do KIT →