Ajustar volume em decibéis
Esta calculadora de ganho de áudio prevê o que acontece com um pico medido quando você aumenta ou reduz um sinal por uma quantidade definida de decibéis.
Executar grátis
Informe o pico atual em dBFS e o ganho em dB para receber o pico resultante, a folga restante e um aviso claro de clipping. Ela ajuda a conferir uma mudança de nível antes de processar um arquivo, configurar um mixer ou montar um fluxo de áudio automatizado. O cálculo é determinístico e não envia, decodifica nem altera áudio.
Diferencie o nível de pico do ganho
Um pico digital costuma ser expresso em dBFS, escala em que 0 dBFS é o nível máximo representável e picos normais sem clipping aparecem como valores negativos. O ganho, por sua vez, é uma alteração relativa expressa em dB. Um ganho de 3 dB eleva o pico em 3 dB, enquanto um ganho de -3 dB o atenua na mesma proporção. Esta calculadora mantém as duas funções explícitas: current_peak_dbfs descreve o ponto inicial do sinal, e gain_db descreve a mudança que você pretende aplicar. O pico resultante é a soma aritmética dos dois valores. Por exemplo, um pico de -8 dBFS com ganho de 5 dB passa a -3 dBFS. Não há análise da forma de onda; portanto, o pico atual deve vir de um medidor, editor, relatório de loudness ou etapa anterior confiável. O resultado prevê apenas a posição do pico após um ganho ideal. Ele não estima loudness, dinâmica, picos entre amostras, excesso de codec nem alterações causadas por compressão, limitação, equalização, mixagem ou conversão de amostras.
Interprete clipping e folga no limite de 0 dBFS
O indicador de clipping se torna verdadeiro somente quando o pico calculado é maior que 0 dBFS. Um resultado exatamente igual a 0 dBFS atinge a escala máxima, mas não a ultrapassa; por isso, a calculadora informa clipping falso e folga zero. Essa distinção torna previsíveis as verificações de limite em automações. Um resultado positivo, como 1.5 dBFS, significa que o ganho proposto levaria o pico conhecido 1.5 dB além da escala máxima; assim, a folga retornada é -1.5 dB. Um resultado negativo deixa folga positiva. Este é um alerta matemático, não uma simulação de um sistema de áudio específico. Formatos de ponto flutuante e algumas cadeias internas conseguem representar temporariamente valores acima da escala máxima, enquanto exportações inteiras, caminhos digital-analógicos, codecs, plug-ins e requisitos de masterização podem reagir de outra maneira. Profissionais costumam reservar uma margem adicional para true peak ou processamento posterior. Use o indicador para detectar um excesso evidente e considere a folga e as exigências do formato de destino ao escolher um ganho final seguro.
Use o cálculo em fluxos de áudio repetíveis
A calculadora foi criada para decisões pequenas e auditáveis que precisam produzir sempre a mesma resposta. Em um pipeline em lote, um analisador de picos pode fornecer o valor atual em dBFS, e esta capacidade pode avaliar o ganho solicitado antes do início da renderização. Uma interface pode exibir o pico previsto e impedir uma exportação insegura, ou uma rotina de controle de qualidade pode registrar o indicador de clipping junto com a medição original. Ganhos negativos funcionam naturalmente, permitindo usar o mesmo endpoint para atenuação e metas de folga. As duas entradas devem ser números JSON finitos; strings que parecem números são rejeitadas para impedir que uma integração concatene texto ou aceite um valor ambíguo. O objeto retornado repete as entradas validadas, fornece o pico calculado, informa o clipping e expressa a folga restante como o oposto do pico resultante. Como a função não utiliza rede, aleatoriedade, relógio, decodificador de áudio nem estado oculto, entradas idênticas geram resultados JSON idênticos. Lembre-se de que ela avalia um pico informado e um ajuste uniforme, sem inspecionar um arquivo ou considerar processamentos posteriores.
Casos de uso
Confira uma mudança de ganho
Verifique se um aumento planejado levaria o pico medido de um arquivo acima de 0 dBFS antes da exportação.
Atenue com folga segura
Aplique um ganho negativo e confirme o pico resultante e a folga disponível para a próxima etapa.
Inclua uma proteção contra clipping
Combine um analisador de picos com este cálculo determinístico para rejeitar ganhos inseguros em lotes de áudio.
Perguntas frequentes
Como o pico resultante é calculado?
O ganho em dB é somado diretamente ao pico atual em dBFS: pico resultante = pico atual + ganho.
Quando o clipping é indicado?
O clipping é verdadeiro quando o pico resultante supera 0 dBFS. Um resultado exatamente em 0 dBFS não ultrapassa a escala máxima.
Posso usar ganho negativo?
Sim. Um ganho negativo atenua o sinal e reduz o pico previsto pela quantidade indicada de decibéis.
Meu arquivo de áudio é inspecionado ou alterado?
Não. O cálculo usa apenas os valores de pico e ganho fornecidos por você; nenhum áudio é recebido, decodificado ou alterado.
Quanto custa uma solicitação de API?
Cada solicitação de API custa US$ 0,002.
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
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/audio/volume-adjust-db \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"current_peak_dbfs":-6,"gain_db":4.5}'const res = await fetch("https://api.kit.forhosting.com/audio/volume-adjust-db", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"current_peak_dbfs": -6,
"gain_db": 4.5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/audio/volume-adjust-db",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"current_peak_dbfs": -6,
"gain_db": 4.5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/audio/volume-adjust-db", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"current_peak_dbfs":-6,"gain_db":4.5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"current_peak_dbfs":-6,"gain_db":4.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/audio/volume-adjust-db", 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
{
"current_peak_dbfs": -6,
"gain_db": 4.5
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "audio.volume_adjust_db",
"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
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_mb | 200 |
max_minutes | 180 |
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. |