Calculadora de erro de afinação em cents

Frequências inválidas ou não positivas falham com invalid_input e não são cobradas.

O que o erro de afinação em cents significa no trabalho fino de altura

Por definição, o intervalo entre duas frequências positivas f_high e f_low é mil e duzentas vezes o logaritmo de base dois da razão; aplicado à afinação, o erro é mil e duzentas vezes log2 de tocado dividido pelo alvo.

Contrato de entrada, campos de resposta e comportamento de erro

Exemplo: played quatrocentos e trinta e oito contra quatrocentos e quarenta produz um erro negativo pequeno —grave—, então você eleva o tom. Mantenha ambos os valores na mesma unidade (hertz) e dentro dos limites de magnitude declarados para que a razão permaneça finita e positiva. Envie por POST um corpo JSON com dois números finitos estritamente positivos obrigatórios: played, a frequência sonora observada em hertz, e target, a altura pretendida em hertz. Aliases como played_hz, observed, actual ou measured mapeiam para played; target_hz, intended, desired ou reference mapeiam para target. Cada campo pode chegar como número JSON ou como string numérica; campos ausentes, strings vazias, valores não finitos e frequências zero ou negativas falham com invalid_input nomeando o problema, e essas falhas não consomem saldo. Em sucesso o corpo ecoa played e target com arredondamento estável a doze casas decimais, error_cents como erro de afinação com sinal, abs_error_cents como valor absoluto, direction como sharp, flat ou in_tune, ratio como played sobre target, unit igual a cents, uma string formula que reafirma a identidade log2, uma mensagem legível que indica se você deve subir ou baixar o tom, e um array steps com a aritmética para ensino ou depuração. Exemplo: played quatrocentos e quarenta e dois hertz contra target quatrocentos e quarenta produz um pequeno erro positivo de cerca de sete vírgula oito cinco cents —agudo—, então você alivia o tom para baixo. Frequências iguais devolvem zero cents e direction in_tune.

Onde uma API de erro de afinação realmente vale a pena

Técnicos de instrumentos e luthieres registram cordas soltas e posições de capotraste como pares de frequência e precisam de um erro em cents determinístico para notas de setup e checklists de QC. Gestores de ensemble que definem afinação de casa diferente de quatrocentos e quarenta hertz (por exemplo quatrocentos e quarenta e dois para orquestras brilhantes, ou mais baixa para performance de época) usam esse valor como target e medem a deriva de cada seção sem converter primeiro para nomes de nota. Designers de patches de synth e modular comparam leituras de oscilador a alvos programados em scripts de automação para que offsets de detune fiquem honestos entre firmware e taxas de amostragem do host. Educadores musicais e apps de prática mostram ao aluno um aviso ao vivo de agudo ou grave depois que um microfone ou detector de altura reporta hertz; chamar um endpoint de parse pequeno evita reimplementar log2 em cents em cada linguagem cliente. Como a implementação é parse puro tier A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo e sem rede de saída. Fixe o campo error_cents arredondado nos testes, rejeite cedo frequências não positivas e você obtém orientação de afinação fina reproduzível para salas de aula, oficinas de reparo e workers de borda sem montar uma pilha completa de análise musical própria.