ForHosting KIT · 音声・文字起こし

音量をデシベルで調整

この音声ゲイン計算ツールでは、測定済みのピークに指定したデシベル数の増幅または減衰を適用した場合の変化を予測できます。現在のピークをdBFS、ゲインをdBで入力すると、処理後のピーク、残りのヘッドルーム、クリッピングの有無が明確に返されます。ファイル処理前のレベル確認、ミキサー設定、自動音声ワークフローの事前判定に適しています。計算は決定論的であり、音声のアップロード、デコード、変更は行いません。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

ピークレベルとゲインを区別して入力します

デジタル音声のピークは一般にdBFSで表します。0 dBFSが表現可能な最大レベルであり、クリッピングしていない通常のピークは負の値になります。一方、ゲインはdBで表す相対的な変化量です。3 dBのゲインを加えるとピークは3 dB上がり、-3 dBを指定すると同じ量だけ減衰します。この計算ツールでは役割を明確に分けています。current_peak_dbfsは信号の開始レベル、gain_dbは適用予定の変化量です。処理後のピークは両者の算術和になります。たとえば、-8 dBFSのピークに5 dBを加えると-3 dBFSです。波形解析は行わないため、現在のピークには信頼できるメーター、編集ソフト、ラウドネスレポート、または前処理工程の測定値をご使用ください。結果は理想的なゲイン適用後のピーク位置だけを予測します。ラウドネス、ダイナミクス、サンプル間ピーク、コーデックのオーバーシュート、コンプレッション、リミッティング、イコライザー、ミックス、サンプル変換による変化は推定しません。

0 dBFS境界のクリッピングとヘッドルームを判断します

クリッピングは、計算後のピークが0 dBFSを超えた場合にのみtrueになります。結果がちょうど0 dBFSの場合はフルスケールに到達していますが、超過はしていません。そのため、クリッピングはfalse、ヘッドルームはゼロとして返されます。この区別により、自動処理でも境界条件を一貫して判定できます。1.5 dBFSのような正の結果は、予定したゲインによって既知のピークがフルスケールを1.5 dB超えることを意味し、ヘッドルームは-1.5 dBになります。負の結果では正のヘッドルームが残ります。これは数学的な警告であり、特定の音響システムのシミュレーションではありません。浮動小数点形式や一部の内部処理ではフルスケール超過を一時的に表現できますが、整数形式への書き出し、D/A経路、コーデック、プラグイン、マスタリング要件では動作が異なる場合があります。実務ではトゥルーピークや後続処理のために追加の余裕を設けることがあります。明白な超過の検出にこの判定を使い、最終ゲインはヘッドルームと出力形式の要件を踏まえて安全に設定してください。

再現可能な音声ワークフローに組み込みます

この計算ツールは、常に同じ回答が必要な小規模で監査可能な判断に適しています。バッチ処理では、ピークスキャナーから現在のdBFS値を受け取り、レンダリング開始前に要求されたゲインを評価できます。画面に予測ピークを表示して危険な書き出しを停止したり、品質管理処理で元の測定値とクリッピング判定を一緒に記録したりできます。負のゲインにもそのまま対応するため、減衰とヘッドルーム確保の両方に同じエンドポイントを使用できます。入力はどちらも有限のJSON数値でなければなりません。数値に見える文字列は拒否されるため、連携処理が文字列を連結したり曖昧な値を受理したりすることを防げます。返却オブジェクトには検証済みの2入力、計算後のピーク、クリッピング判定、処理後ピークの符号を反転した残りのヘッドルームが含まれます。ネットワーク、乱数、時刻、音声デコーダー、隠れた状態を使用しないため、同じ入力からは同じJSON結果が得られます。評価対象は指定された1つのピークと一様なゲインであり、音声ファイルや後続処理そのものではありません。

活用例

ゲイン変更を事前確認します

書き出し前に、予定した増幅で測定済みピークが0 dBFSを超えるか確認できます。

安全な余裕まで減衰します

負のゲインを適用し、処理後のピークと次工程に残るヘッドルームを確認できます。

クリッピング防止を自動化します

ピークスキャナーと決定論的な計算を組み合わせ、バッチ処理で危険なゲイン設定を拒否できます。

よくある質問

処理後のピークはどのように計算されますか？

dB単位のゲインを現在のdBFSピークに直接加えます。処理後ピーク = 現在ピーク + ゲインです。

クリッピングはいつ判定されますか？

処理後のピークが0 dBFSを超えるとtrueです。ちょうど0 dBFSの場合はフルスケールを超えていません。

負のゲインも使用できますか？

はい。負のゲインは信号を減衰させ、予測ピークを指定したデシベル数だけ下げます。

音声ファイルは解析または変更されますか？

いいえ。ご指定のピークとゲインだけを計算し、音声の受信、デコード、変更は行いません。

APIリクエストの料金はいくらですか？

APIリクエスト1回の料金は$0.002です。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/audio/volume-adjust-db

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

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)

リクエスト例

{
  "current_peak_dbfs": -6,
  "gain_db": 4.5
}

レスポンス例

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

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

`max_mb`	200
`max_minutes`	180

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →