Calculadora de eficacia vacunal
Con 20 infecciones entre 1000 vacunados y 80 entre 1000 con placebo, la eficacia vacunal es del 75 %. Introduzca las cuatro cifras de la tabla de resultados de un ensayo para recalcular usted mismo el porcentaje publicado. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Infecciones en vacunados
- 20
- Vacunados (n)
- 1 000
- Infecciones con placebo
- 80
- Placebo (n)
- 1 000
- Tasa de ataque en vacunados
- 0,02 percent
- Tasa de ataque con placebo
- 0,08
- Riesgo relativo
- 0,25
- Eficacia (%)
- 75
La eficacia vacunal es la reducción porcentual del riesgo de infección entre las personas vacunadas frente a un grupo placebo o no vacunado observado en la misma ventana del estudio. Estudiantes, analistas de ensayos, periodistas y equipos de producto calculan ese porcentaje a partir de cuatro cifras: infecciones en el brazo vacunado, tamaño del brazo vacunado, infecciones en el brazo placebo y tamaño del brazo placebo. Esta calculadora de eficacia vacunal aplica la identidad clásica de uno menos el riesgo relativo: divida la tasa de ataque vacunada entre la del placebo, reste ese riesgo relativo de uno y multiplique por cien.
Qué significa la eficacia vacunal y cómo los cuatro recuentos se vuelven un porcentaje
La eficacia vacunal, a menudo abreviada VE, es la reducción porcentual del riesgo de un desenlace definido entre quienes recibieron la vacuna frente a quienes recibieron placebo o permanecieron sin vacunar. El estimador clásico de los manuales, los informes de agencias y los cursos introductorios de epidemiología es uno menos el riesgo relativo, expresado como porcentaje. El riesgo relativo es la tasa de ataque vacunada dividida entre la tasa de ataque del placebo.
Cuando las dos tasas de ataque coinciden, la eficacia es cero porque la vacuna no cambió el riesgo en esta tabla cruda. Cuando el brazo vacunado no tiene infecciones y el placebo sí, la eficacia es cien por ciento. Cuando el brazo vacunado tiene una tasa de ataque mayor que el placebo, el porcentaje es negativo, y esta calculadora lo informa con honestidad en lugar de recortarlo a cero u ocultar el signo.
Este extremo no ajusta curvas de Kaplan–Meier, modelos de Poisson ni intervalos de confianza; es la identidad de cuatro recuentos que periodistas y estudiantes realmente escriben en una hoja de cálculo. Úselo cuando ya tenga recuentos de cohorte cerrada y necesite un VE porcentual reproducible, no cuando aún precise persona-tiempo, seguimiento solapado o el análisis primario del protocolo.
Contrato de entrada, forma de la respuesta y comportamiento ante errores
Cualquier recuento negativo falla porque un ensayo no puede registrar menos tres infecciones ni una plantilla negativa. Un tamaño de grupo igual a cero falla porque la tasa de ataque es infecciones divididas entre n, y la división por cero no está definida. Los recuentos de infección que superan el tamaño de su grupo fallan porque una tasa de ataque mayor que uno no es una proporción válida de cohorte cerrada.
Si el brazo placebo registró cero infecciones, la tasa de ataque del placebo es cero y el riesgo relativo no está definido, de modo que la tarea falla en lugar de devolver Infinity. La validación fallida no se factura.
Dónde resulta útil y qué límites tiene
Las aulas y las plataformas de tutoría usan una calculadora de eficacia vacunal para que el alumnado compruebe la tarea contra un oráculo determinista en lugar de un error silencioso de hoja de cálculo en el paso del riesgo relativo. La validación fallida no consume saldo. Esto es una herramienta de cálculo y enseñanza, no un dispositivo médico de diagnóstico ni un sustituto de un análisis especificado por protocolo con persona-tiempo, intervalos de confianza solapados o desenlaces regulatorios.
Quienes toman decisiones de salud personal deben seguir el consejo médico profesional y el análisis estadístico publicado del ensayo, no un único porcentaje automatizado. Mantenga las solicitudes pequeñas, fije los campos redondeados en las pruebas y obtendrá eficacia vacunal reproducible para deberes, gráficos de redacción y workers de borde sin montar su propia pila de bioestadística.
Qué puede hacer con ella
Periodismo científico y explicadores de ensayos
Recalcule la eficacia vacunal titular de un ensayo publicado a partir de los cuatro recuentos de la tabla de resultados y cite un porcentaje determinista junto a las cifras de origen.
Preguntas frecuentes
¿Cómo se calcula la eficacia vacunal a partir de los recuentos de infección?
El porcentaje de eficacia es (1 − (ARV/ARU)) × 100, donde ARV son las infecciones vacunadas sobre n vacunado y ARU las infecciones placebo sobre n placebo.
¿Qué ocurre si el tamaño de un grupo es cero o un recuento es negativo?
Los recuentos negativos no son datos válidos de ensayo, y un tamaño de grupo nulo deja indefinida la tasa de ataque. Esos fallos no se facturan.
¿Puede la eficacia vacunal ser negativa o superar el cien por ciento?
Se devuelve eficacia negativa cuando la tasa de ataque vacunada supera la del placebo. Valores por encima del cien por ciento no ocurren con recuentos válidos de cohorte cerrada (las infecciones no pueden ser negativas, así que ARV no puede quedar por debajo de cero).
¿Cuál es la diferencia entre eficacia vacunal y efectividad vacunal?
Esta calculadora informa eficacia vacunal al estilo de un ensayo, de un brazo vacunado frente a un comparador placebo o no vacunado, usando cuatro recuentos. La efectividad vacunal observacional a partir de persona-tiempo del mundo real o diseños de test negativo es otro análisis y otra intención de búsqueda.
¿La calculadora da un intervalo de confianza?
No. Aplica solo la identidad de las cuatro cifras, uno menos el riesgo relativo. No ajusta curvas de Kaplan-Meier, modelos de Poisson ni intervalos de confianza, y no trabaja con persona-tiempo.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
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)Ejemplo de solicitud
{
"vaccinated_infections": 20,
"vaccinated_n": 1000,
"placebo_infections": 80,
"placebo_n": 1000
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "health.vaccine_efficacy",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
El resultado es un efficacy_percent estable que usted puede fijar en pruebas, hojas de cálculo y paneles. Los recuentos negativos y los tamaños de grupo nulos fallan con invalid_input y nunca se facturan.
Qué significa la eficacia vacunal y cómo los cuatro recuentos se vuelven un porcentaje
La tasa de ataque de cada brazo es simplemente infecciones divididas entre el tamaño de ese brazo: vaccinated_infections sobre vaccinated_n, y placebo_infections sobre placebo_n. Multiplicar el complemento de esa razón por cien produce efficacy_percent. Entradas idénticas producen siempre el mismo JSON porque la ruta es aritmética pura, sin red, sin modelo, sin semilla aleatoria y sin reloj de pared.
Contrato de entrada, forma de la respuesta y comportamiento ante errores
Envíe un cuerpo JSON con cuatro números finitos obligatorios. vaccinated_infections es el número de eventos de desenlace en el grupo vacunado. vaccinated_n es el número de personas, o unidades de plantilla comparables, de ese grupo y debe ser mayor que cero. placebo_infections es el número de eventos de desenlace en el comparador placebo o no vacunado. placebo_n es el tamaño del grupo comparador y debe ser mayor que cero. Cada campo puede llegar como número JSON o como cadena numérica; se aceptan alias documentados como vaccinated_cases, n_vaccinated, placebo_cases y unvaccinated_n cuando se omite el nombre canónico. Los campos ausentes, las cadenas vacías y los valores no finitos fallan con invalid_input nombrando el campo. Si tiene éxito, el cuerpo ecoa las cuatro entradas, informa vaccinated_attack_rate y placebo_attack_rate como proporciones, informa relative_risk como su razón y informa efficacy_percent como cien veces uno menos esa razón. unit es siempre percent. formula reitera la identidad para que una interfaz muestre la línea didáctica junto al número. method es siempre one_minus_relative_risk para que el código posterior ramifique sin olfatear formas.
Dónde gana su sitio una API de eficacia vacunal, precio y límites
Las mesas de divulgación científica recalculan el VE titular de un ensayo publicado a partir de los cuatro recuentos de la tabla de resultados y citan efficacy_percent sin volver a derivar la identidad bajo presión de plazo. Los equipos de producto que ya almacenan tamaños de brazo y recuentos de eventos en un almacén pueden enviar esos cuatro campos y persistir efficacy_percent junto a los recuentos brutos para paneles y columnas de exportación. Como la implementación es parse pura de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo y sin red de salida.
Casos de integración
Tareas de epidemiología y corrección de exámenes
Permita que el alumnado envíe recuentos de infección vacunados y placebo con tamaños de grupo y verifique efficacy_percent frente a la identidad clásica de uno menos el riesgo relativo.
Aplicaciones educativas de salud y backends SaaS
Llame al mismo contrato de cuatro recuentos desde un widget de navegador gratuito y desde la calificación API de prepago para que las demos de aula y las canalizaciones de producción nunca discrepen.
Preguntas técnicas
¿Cuánto cuesta la calculadora de eficacia vacunal?
La herramienta del navegador es gratuita. Las solicitudes API usan saldo KIT prepago a $0.002 por llamada exitosa; la entrada inválida no se factura.