Regolare il volume in decibel
Questo calcolatore di guadagno audio prevede come cambia un picco misurato quando Lei aumenta o riduce un segnale di un determinato numero di decibel.
Esegui gratis nel browser
Inserisca il picco attuale in dBFS e il guadagno in dB per ottenere il picco risultante, il margine residuo e una chiara segnalazione del clipping. È utile per verificare una modifica di livello prima di elaborare un file, impostare un mixer o creare un flusso audio automatico. Il calcolo è deterministico e non carica, decodifica né modifica alcun audio.
Distingua il livello di picco dal guadagno
Un picco digitale viene normalmente espresso in dBFS, dove 0 dBFS rappresenta il massimo livello disponibile e i normali picchi non tagliati hanno valori negativi. Il guadagno, invece, è una variazione relativa espressa in dB. Un guadagno di 3 dB innalza il picco di 3 dB, mentre un guadagno di -3 dB lo attenua della stessa quantità. Questo calcolatore mantiene distinti i due ruoli: current_peak_dbfs descrive il livello di partenza del segnale e gain_db la modifica che Lei intende applicare. Il picco risultante è la loro somma aritmetica. Per esempio, un picco di -8 dBFS con un guadagno di 5 dB diventa -3 dBFS. Non viene analizzata la forma d’onda, quindi il picco attuale deve provenire da un misuratore, un editor, un rapporto di loudness o una fase precedente affidabile. Il risultato prevede soltanto la posizione del picco dopo un guadagno ideale. Non stima loudness, dinamica, picchi inter-campione, sovraelongazioni dei codec né variazioni causate da compressione, limiting, equalizzazione, missaggio o conversione dei campioni.
Interpreti clipping e margine al limite di 0 dBFS
L’indicatore di clipping diventa vero soltanto quando il picco calcolato supera 0 dBFS. Un risultato esattamente pari a 0 dBFS raggiunge il fondo scala senza oltrepassarlo; il calcolatore restituisce quindi clipping falso e margine zero. Questa distinzione rende prevedibili i controlli del limite nelle automazioni. Un risultato positivo, come 1.5 dBFS, significa che il guadagno proposto porterebbe il picco noto 1.5 dB oltre il fondo scala; il margine restituito è perciò -1.5 dB. Un risultato negativo lascia un margine positivo. È un avviso matematico, non la simulazione di uno specifico sistema audio. I formati in virgola mobile e alcune catene interne possono rappresentare temporaneamente valori oltre il fondo scala, mentre esportazioni intere, percorsi digitale-analogico, codec, plug-in e requisiti di mastering possono comportarsi diversamente. I tecnici riservano spesso un margine ulteriore per i true peak o le elaborazioni successive. Usi l’indicatore per individuare un superamento evidente, poi consideri il margine e i requisiti del formato di destinazione per scegliere un guadagno finale sicuro.
Usi il calcolo in flussi audio ripetibili
Il calcolatore è pensato per decisioni circoscritte e verificabili che devono produrre sempre la stessa risposta. In una pipeline batch, un analizzatore può fornire il valore di picco attuale in dBFS e questa capacità può valutare il guadagno richiesto prima che inizi il rendering. Un’interfaccia può mostrare il picco previsto e impedire un’esportazione rischiosa, oppure un controllo qualità può registrare l’indicatore di clipping insieme alla misura originale. Il guadagno negativo funziona in modo naturale, quindi lo stesso endpoint serve sia per l’attenuazione sia per obiettivi di margine. Entrambi gli input devono essere numeri JSON finiti; le stringhe simili a numeri vengono rifiutate per evitare che un’integrazione concateni testo o accetti un valore ambiguo. L’oggetto restituito ripete gli input convalidati, fornisce il picco calcolato, segnala il clipping ed esprime il margine residuo come l’opposto del picco risultante. Poiché la funzione non usa rete, casualità, orologio, decoder audio o stato nascosto, input identici producono risultati JSON identici. Ricordi che viene valutato un solo picco fornito con una variazione uniforme, senza esaminare un file o considerare elaborazioni successive.
Casi d'uso
Verifichi una variazione di guadagno
Controlli prima dell’esportazione se un aumento previsto porterebbe il picco misurato oltre 0 dBFS.
Attenui con un margine sicuro
Applichi un guadagno negativo e confermi il picco risultante e il margine disponibile per la fase successiva.
Aggiunga una protezione dal clipping
Combini un analizzatore di picco con questo calcolo deterministico per rifiutare impostazioni rischiose nei batch audio.
Domande frequenti
Come viene calcolato il picco risultante?
Il guadagno in dB viene sommato direttamente al picco attuale in dBFS: picco risultante = picco attuale + guadagno.
Quando viene segnalato il clipping?
Il clipping è vero quando il picco risultante supera 0 dBFS. Un risultato esattamente pari a 0 dBFS non supera il fondo scala.
Posso usare un guadagno negativo?
Sì. Un guadagno negativo attenua il segnale e abbassa il picco previsto del numero di decibel indicato.
Il mio file audio viene analizzato o modificato?
No. Il calcolo usa soltanto i valori di picco e guadagno che Lei fornisce; nessun audio viene ricevuto, decodificato o modificato.
Quanto costa una richiesta API?
Ogni richiesta API costa $0.002.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
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)Esempio di richiesta
{
"current_peak_dbfs": -6,
"gain_db": 4.5
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "audio.volume_adjust_db",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_mb | 200 |
max_minutes | 180 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |