Calculadora de error de afinación en cents

Las frecuencias no válidas o no positivas fallan con invalid_input y no se facturan.

Qué significa el error de afinación en cents en el trabajo fino de altura

Por definición, el intervalo entre dos frecuencias positivas f_high y f_low es mil doscientos veces el logaritmo en base dos de su cociente; aplicado a la afinación, el error es mil doscientos veces log2 de tocado dividido por objetivo.

Contrato de entrada, campos de respuesta y comportamiento ante errores

Ejemplo: played cuatrocientos treinta y ocho frente a cuatrocientos cuarenta produce un error negativo pequeño —grave—, así que usted sube el tono. Mantenga ambos valores en la misma unidad (hercios) y dentro de los límites de magnitud declarados para que el cociente siga siendo finito y positivo. Envíe por POST un cuerpo JSON con dos números finitos estrictamente positivos obligatorios: played, la frecuencia sonora observada en hercios, y target, la altura pretendida en hercios. Alias como played_hz, observed, actual o measured se asignan a played; target_hz, intended, desired o reference se asignan a target. Cada campo puede llegar como número JSON o como cadena numérica; campos ausentes, cadenas vacías, valores no finitos y frecuencias cero o negativas fallan con invalid_input indicando el problema, y esos fallos no consumen saldo. En caso de éxito el cuerpo repite played y target con redondeo estable a doce decimales, error_cents como error de afinación con signo, abs_error_cents como su valor absoluto, direction como sharp, flat o in_tune, ratio como played entre target, unit igual a cents, una cadena formula que reescribe la identidad log2, un mensaje legible que indica si debe subir o bajar el tono, y un array steps que muestra la aritmética para docencia o depuración. Ejemplo: played cuatrocientos cuarenta y dos hercios frente a target cuatrocientos cuarenta produce un pequeño error positivo de unos siete coma ocho cinco cents —agudo—, así que usted suaviza el tono hacia abajo. Frecuencias iguales devuelven cero cents y direction in_tune.

Dónde una API de error de afinación aporta valor real

Técnicos de instrumentos y lutieres registran cuerdas al aire y posiciones de cejilla como pares de frecuencias y necesitan un error en cents determinista para notas de montaje y listas de control de calidad. Directores de conjunto que fijan una altura de sala distinta de cuatrocientos cuarenta hercios (por ejemplo cuatrocientos cuarenta y dos en orquestas brillantes, o más baja en interpretación historicista) usan ese valor como target y miden la deriva de cada sección sin convertir primero a nombres de nota. Diseñadores de patches de sintetizador y modular comparan lecturas de oscilador con objetivos programados en scripts de automatización para que los desajustes de detune sean honestos entre firmware y frecuencias de muestreo del host. Educadores musicales y aplicaciones de práctica muestran al alumno una señal en vivo de agudo o grave cuando un micrófono o un detector de altura reporta hercios; llamar a un endpoint de parse pequeño evita reimplementar log2 en cents en cada lenguaje cliente. Como la implementación es parse puro de nivel A, cada llamada correcta cuesta el precio base publicado $0.002 sin tokens de modelo y sin red saliente. Fije el campo error_cents redondeado en las pruebas, rechace pronto las frecuencias no positivas y obtendrá una guía de afinación fina reproducible para aulas, talleres de reparación y workers en el borde sin montar una pila completa de análisis musical propia.