Presupuesto de tiempo del plan de clase
Una clase de 50 minutos con calentamiento, explicación, práctica guiada y ticket de salida con pesos 1, 3, 4 y 2 queda en 5, 15, 20 y 10 minutos. Usted indica cuánto importa cada parte y los minutos siempre suman la duración de la clase. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Duración (min)
- 50
- Cantidad de actividades
- 4
- Suma de pesos
- 10
- Minutos
- 5, 15, 20, 10
Los docentes, los asesores pedagógicos y las plataformas de currículo se enfrentan una y otra vez a la misma pregunta de planificación: si esta clase dura cincuenta minutos, ¿cuántos minutos deben recibir el calentamiento, la instrucción directa, la práctica guiada y el ticket de salida? Los pesos relativos capturan la intención mejor que adivinar cifras absolutas: un bloque puede merecer el doble de atención que otro sin que nadie conozca aún el reparto final en minutos. Este calculador de presupuesto de tiempo del plan de clase acepta una duración total positiva en minutos más una lista ordenada de actividades con nombre y pesos relativos no negativos, y devuelve minutos proporcionales por fila de modo que las partes sumen la duración de la clase.
Cómo funciona la asignación proporcional del tiempo
Un presupuesto de tiempo del plan de clase trata el periodo como un pastel fijo y cada actividad prevista como una porción cuyo tamaño lo fija un peso relativo y no una conjetura absoluta de minutos. Pesos iguales producen minutos iguales; un peso de dos junto a uno de uno significa el doble de duración, escriba 2 y 1 o 10 y 5.
Esa invariancia de escala es útil cuando un equipo negocia prioridades primero y solo después fija el horario de campana: cambie D de cuarenta y cinco a sesenta y cada parte se escala sin reescribir pesos. Se permite peso cero en una fila que quiera conservar en el plan como marcador con nombre que no recibe tiempo en esta pasada; lo que no se permite es que todos los pesos sean cero, porque la división por una suma nula no está definida.
Los pesos negativos se rechazan porque una porción negativa del periodo no tiene sentido en el aula.
Qué puede hacer con ella
Planificación de bloques y horario de campana
Reasigne minutos de calentamiento, instrucción, práctica y ticket de salida cuando cambie la duración del periodo, manteniendo los mismos pesos relativos de actividad.
Plantillas de coaching y observación
Genere cuotas de minutos y porcentajes planificados para formularios de observación a fin de que el coach compare el tiempo de habla previsto con el reloj.
Automatización LMS y de ritmo curricular
Invoque el mismo presupuesto de tiempo ponderado desde APIs de boletín o currículo para que plantillas y planificadores humanos no diverjan en los totales de minutos.
Preguntas frecuentes
¿Cómo se reparten los minutos entre actividades?
Pesos iguales dan minutos iguales; el doble de peso da el doble de tiempo. Los minutos devueltos suman la duración total.
¿Puede una actividad tener peso cero?
Sí. Una fila con peso cero conserva su nombre en el plan pero recibe cero minutos. Si todos los pesos son cero, la petición falla porque la suma de pesos dividiría por cero.
¿Necesito minutos absolutos por actividad de antemano?
No. Indique pesos relativos y una sola duración total. Cambie la duración más tarde y vuelva a ejecutar para escalar cada actividad sin reescribir la estructura del plan.
¿Qué pasa si cambia la duración de la clase?
Mantenga los mismos pesos y cambie solo el total. Cada actividad se ajusta en la misma proporción, así que una sesión más larga o más corta conserva el reparto sin volver a escribir nada, y los pesos 2 y 1 equivalen a 10 y 5.
¿Los minutos suman siempre exactamente la duración de la clase?
Sí. Repartir por pesos puede dejar un pequeño sobrante por redondeo, y ese sobrante se asigna a la última actividad con peso mayor que cero, de modo que las partes siempre suman la sesión indicada.
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/edu/lesson-plan-time-budget \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"duration_minutes":50,"activities":[{"name":"Warm-up","weight":1},{"name":"Direct instruction","weight":3},{"name":"Guided practice","weight":4},{"name":"Exit ticket","weight":2}]}'const res = await fetch("https://api.kit.forhosting.com/edu/lesson-plan-time-budget", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"duration_minutes": 50,
"activities": [
{
"name": "Warm-up",
"weight": 1
},
{
"name": "Direct instruction",
"weight": 3
},
{
"name": "Guided practice",
"weight": 4
},
{
"name": "Exit ticket",
"weight": 2
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/edu/lesson-plan-time-budget",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"duration_minutes": 50,
"activities": [
{
"name": "Warm-up",
"weight": 1
},
{
"name": "Direct instruction",
"weight": 3
},
{
"name": "Guided practice",
"weight": 4
},
{
"name": "Exit ticket",
"weight": 2
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/lesson-plan-time-budget", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"duration_minutes":50,"activities":[{"name":"Warm-up","weight":1},{"name":"Direct instruction","weight":3},{"name":"Guided practice","weight":4},{"name":"Exit ticket","weight":2}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"duration_minutes":50,"activities":[{"name":"Warm-up","weight":1},{"name":"Direct instruction","weight":3},{"name":"Guided practice","weight":4},{"name":"Exit ticket","weight":2}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/lesson-plan-time-budget", 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
{
"duration_minutes": 50,
"activities": [
{
"name": "Warm-up",
"weight": 1
},
{
"name": "Direct instruction",
"weight": 3
},
{
"name": "Guided practice",
"weight": 4
},
{
"name": "Exit ticket",
"weight": 2
}
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "edu.lesson_plan_time_budget",
"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
Una duración no positiva y una suma de pesos cero fallan con invalid_input en lugar de inventar un horario.
Cómo funciona la asignación proporcional del tiempo
Si duration_minutes es D y la actividad i tiene peso w_i, los minutos asignados son D por w_i dividido entre la suma de todos los pesos. Tras la multiplicación proporcional, el redondeo en coma flotante puede dejar un residuo mínimo de modo que los minutos limpios ya no sumen exactamente D; este endpoint absorbe ese residuo en la última actividad con peso positivo para que el array minutes sea siempre una partición de la duración pedida. La respuesta también informa share_ratio y percent por actividad para que los paneles grafiquen el mismo reparto sin recalcular la suma de pesos.
Contrato de entrada, forma de la respuesta y errores
El campo activities es un array no vacío de objetos, cada uno con una cadena name no vacía y un weight numérico finito no negativo. En esta ruta parse gratuita se aceptan hasta cien actividades. Un array paralelo minutes respeta el orden de entrada para scripts que solo necesitan la asignación numérica. Comprobaciones clásicas de aula incluyen un bloque de cincuenta minutos con pesos uno, tres, cuatro y dos para calentamiento, instrucción directa, práctica guiada y ticket de salida, que produce cinco, quince, veinte y diez minutos respectivamente. Conecte el formulario gratuito del navegador a un tablero de planificación para uso humano, y llame al mismo contrato desde un servicio de boletín o guía de ritmo cuando la automatización necesite cifras idénticas. Envíe por POST un cuerpo JSON con dos campos obligatorios. El campo duration_minutes es un número finito estrictamente mayor que cero que representa la duración total de la clase en minutos; cero y valores negativos fallan con invalid_input nombrando el campo. Campos ausentes, listas vacías, filas que no son objeto, nombres en blanco, números no finitos, pesos negativos y una suma de pesos cero fallan con invalid_input y no se facturan. En el éxito el cuerpo repite duration_minutes, informa activity_count y weight_sum, y devuelve un array activities de objetos con index, name, weight, share_ratio, minutes y percent. Method es weighted_time_budget y formula reafirma que minutes_i es duration_minutes por weight_i entre la suma de pesos. Las llamadas API correctas usan el precio base publicado $0.002 por ítem; los fallos de validación no consumen saldo prepago.
Dónde un API de presupuesto de tiempo de clase aporta valor
Los equipos de diseño instruccional usan un calculador de presupuesto de tiempo del plan de clase para que las plantillas multiperiodo sigan siendo coherentes cuando el distrito acorta o alarga el horario de campana: mantenga los mismos pesos relativos y vuelva a ejecutar con el nuevo duration_minutes. Las herramientas de coaching incrustan el endpoint para que un formulario de observación muestre si la parte planificada de habla del alumnado coincidió con el reloj observado, usando percent y minutes de una sola fuente de verdad. Los constructores de ed-tech evitan enviar sus propios casos límite de coma flotante —duración cero, todos los pesos a cero, redondeo residual— porque esas rutas ya están cubiertas por invalid_input determinista o absorción de residuo.
Preguntas técnicas
¿Qué ocurre si la duración total de la clase es cero o negativa?
La tarea falla con invalid_input. duration_minutes debe ser un número finito estrictamente mayor que cero; los totales no positivos no se facturan.
¿Cuánto cuesta el calculador de presupuesto de tiempo del plan de clase?
La herramienta del navegador es gratuita. Las peticiones API usan saldo prepago KIT a $0.002 por llamada exitosa; la entrada inválida no se factura.