Calculadora de duración de canción

Un tempo no positivo o un recuento de compases no positivo se rechaza con invalid_input para que un script nunca trate un boceto a BPM cero como una pista infinitamente larga. La ruta es matemática pura —sin red, sin semillas aleatorias, sin dependencia del reloj del sistema—, de modo que el ejecutor gratuito del navegador y la API de prepago devuelven el mismo JSON tras un redondeo decimal fijo cada vez que usted la llama.

Cómo BPM, indicación de compás y compases se vuelven minutos y segundos

La indicación de compás escribe dos cifras: el numerador, enviado como beats_per_bar, dice cuántos de esos pulsos llenan un compás, y el denominador, enviado como beat_unit, nombra la figura escrita que recibe el pulso — cuatro para la negra, ocho para la corchea, dos para la blanca, y uno, dieciséis o treinta y dos para el resto de valores legales.

Cómo llamar a la API y qué responde

Envíe un cuerpo JSON con cuatro números finitos obligatorios. El campo bpm es el tempo en pulsos por minuto; se aceptan los alias tempo, beats_per_minute y tempo_bpm. El campo measures es el recuento de barras; los alias bars, measure_count, num_measures y n_measures apuntan al mismo valor, y un recuento fraccionario es legal para una anacrusa o un fundido que no cae en tiempo fuerte. El campo beats_per_bar es el numerador de la indicación de compás (cuatro en 4/4, tres en 3/4, seis en 6/8). El campo beat_unit es un enum cerrado de figuras escritas que pueden ocupar el pie del metro: uno, dos, cuatro, ocho, dieciséis o treinta y dos. Los valores absolutos deben permanecer dentro del límite publicado de un billón, y bpm y measures deben ser estrictamente mayores que cero; campos ausentes, cadenas no numéricas, números no finitos y un tempo o recuento de barras no positivo devuelven invalid_input y nunca se cobran. Si acierta, la respuesta reitera las entradas redondeadas, asigna time_signature a la cadena canónica numerador-barra-denominador, informa seconds_per_beat, seconds_per_measure, beats_total, total_seconds y total_milliseconds, y parte esa misma longitud en hours, minutes y segundos restantes con un reloj de duration como 1:04 o 0:57.6. Formula reitera que total_seconds equivale a measures por beats_per_bar por sesenta entre bpm. El precio es una tarifa plana de $0.002 por solicitud exitosa con unidad item.

Consejos prácticos, límites y búsquedas afines

Mantenga BPM y el recuento de compases dentro del rango absoluto publicado para que la duración recíproca del pulso siga siendo finita en precisión doble IEEE tanto en el Worker como en el navegador. Al enseñar, combine un caso feliz positivo con un tempo deliberadamente cero o negativo y un recuento de barras a cero para demostrar la ruta estricta de invalid_input. Las tareas fallidas que devuelven invalid_input no consumen saldo prepagado, lo que mantiene baratos los scripts exploratorios cuando el alumnado prueba casos límite a propósito. Las comprobaciones de ida y vuelta son directas: recalcule measures por beats_per_bar por sesenta entre bpm y confirme que coincide con total_seconds dentro del redondeo a doce decimales; luego confirme que minutes y los segundos restantes reensamblan el mismo total y que la cadena duration coincide con el desglose del reloj.