ForHosting KIT · Ferramentas para dev

Semitons entre frequências

A calculadora de semitons entre frequências transforma duas frequências positivas na distância musical com sinal entre elas no temperamento igual de doze tons.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Informe uma frequência inicial e outra final em hertz; a ferramenta calcula doze vezes o logaritmo de base dois da razão entre ambas. O resultado descreve oitavas e intervalos conhecidos, além de frações de semitom usadas em afinação, acústica, análise de áudio e correção de altura. A resposta também traz a razão e informa se a segunda frequência está acima, abaixo ou exatamente no mesmo ponto da primeira.

Informe as frequências na ordem pretendida

Use frequency_1_hz como referência ou frequência inicial e frequency_2_hz como a frequência que deseja comparar. Os dois valores precisam ser números finitos positivos em hertz. A ordem importa porque o resultado tem sinal: 440 Hz seguido de 880 Hz gera doze semitons positivos; 880 Hz seguido de 440 Hz gera doze negativos. Entradas iguais resultam em zero e na direção unison. Valores decimais, como 439.7 Hz ou 261.625565 Hz, são aceitos. Não informe nomes de notas, comprimentos de onda, cents ou razões nesses campos; converta-os antes para frequências. A resposta repete as entradas aceitas para facilitar o registro junto às medições originais. A validação rejeita campos ausentes, zero, negativos, strings numéricas, infinito e dados não numéricos, evitando que um logaritmo indefinido pareça um resultado válido.

Entenda o cálculo logarítmico

A calculadora divide primeiro a frequência final pela inicial, obtém o logaritmo de base dois dessa razão e multiplica o valor por doze. Isso corresponde ao temperamento igual de doze tons: dobrar a frequência eleva a altura em uma oitava, log2(2) é um e doze vezes um são doze semitons. Uma razão igual a um produz zero; razões menores que um produzem valores negativos. Diferentemente de uma tabela de nomes de notas, o método é contínuo e pode retornar 7.01955 semitons para uma quinta um pouco larga ou 0.23 para um pequeno desvio de afinação. Razão e semitons são arredondados em doze casas decimais, mantendo o JSON estável e precisão mais que suficiente para medições práticas. Os campos de fórmula e temperamento deixam clara a convenção quando outros programas poderiam supor cents ou outra afinação.

Interprete e aplique o resultado com sinal

Leia semitones como a distância dirigida da primeira frequência até a segunda. Um número positivo indica que a segunda é mais alta; um negativo, que é mais baixa; zero indica coincidência. O campo direction apresenta a mesma relação como up, down ou unison, para que interfaces não precisem deduzi-la do sinal. Resultados inteiros marcam passos exatos: doze é uma oitava, sete é uma quinta e um é um semitom. As frações são especialmente úteis ao afinar instrumentos, comparar picos espectrais ou definir um efeito de mudança de altura. Para converter o valor em cents, multiplique-o por cem. Preserve a precisão original da medição e evite arredondar as frequências antes do cálculo. Cada solicitação API bem-sucedida custa US$ 0,002 por item; a versão do navegador executa localmente o mesmo cálculo determinístico, sem enviar frequências a terceiros.

Casos de uso

Medir a afinação de um instrumento

Compare uma fundamental medida com a frequência-alvo e quantifique o desvio com sinal em frações de semitom.

Configurar uma mudança de altura

Calcule quantos semitons são necessários para levar um áudio de uma frequência conhecida até outra.

Analisar picos espectrais

Converta a razão entre dois picos detectados em um intervalo compreensível para músicos e ferramentas de áudio.

Perguntas frequentes

Qual fórmula a calculadora usa?

Ela usa semitones = 12 × log2(frequency_2_hz / frequency_1_hz), a relação padrão do temperamento igual de doze tons.

Por que o resultado pode ser negativo?

Um resultado negativo indica que a segunda frequência é mais baixa. Inverta as entradas para manter a magnitude e trocar o sinal.

O resultado pode ter uma fração de semitom?

Sim. Razões arbitrárias raramente coincidem exatamente com os passos temperados, portanto valores fracionários são esperados e úteis.

Como converter a resposta em cents?

Multiplique semitones por 100. Um semitom do temperamento igual equivale a 100 cents.

Quais entradas são inválidas?

Valores ausentes, zero, negativos, infinitos, não numéricos e strings são rejeitados. As duas frequências devem ser números JSON finitos positivos em hertz.

Quanto custa uma solicitação API?

Cada solicitação API bem-sucedida custa US$ 0,002 por item. O mesmo cálculo determinístico é gratuito no navegador.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/optics/semitones-between-frequencies

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/optics/semitones-between-frequencies \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"frequency_1_hz":440,"frequency_2_hz":880}'

const res = await fetch("https://api.kit.forhosting.com/optics/semitones-between-frequencies", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "frequency_1_hz": 440,
    "frequency_2_hz": 880
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/optics/semitones-between-frequencies",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "frequency_1_hz": 440,
    "frequency_2_hz": 880
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/optics/semitones-between-frequencies", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"frequency_1_hz":440,"frequency_2_hz":880}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"frequency_1_hz":440,"frequency_2_hz":880}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/optics/semitones-between-frequencies", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "frequency_1_hz": 440,
  "frequency_2_hz": 880
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "optics.semitones_between_frequencies",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →