跳至內容

Ffmpeg Api · Loudnorm

整合

模型 id ffmpeg-api/loudnorm
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ffmpeg-api/loudnorm?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

每次執行最多 $0.306 依實際用量收費,其餘金額會退款 在此頁面執行

取得 API 金鑰
Utility 音訊 #ffmpeg

將音訊響度正規化至 EBU R128 目標,並可調整 LUFS、真峰值和範圍設定

Utility · 音訊

您的第一個結果會顯示在這裡

在下方建立請求,並使用您的 API 金鑰執行。輸出會複製到我們的儲存空間,可永久保留或免費保留 7 天。

建立請求

控制項是根據模型結構描述生成的。變更設定時,程式碼和價格會同步更新。

•必填 audio_url
拖放檔案,或

指向需要正規化之音訊檔案的 URL。

進階 integrated_loudness · true_peak · loudness_range · offset · measured_i · measured_lra · measured_tp · measured_thresh · linear · dual_mono · print_summary
預設 -18

整合響度的目標值,單位為 LUFS。

預設 -0.1

真峰值上限,單位為 dBTP。

預設 7

響度的目標範圍,單位為 LU。

預設 0

套用於真峰值限制器之前的增益偏移,單位為 dB。

線性模式從輸入檔案所需的整合響度測量值,以 LUFS 提供。

線性模式所需的響度範圍測量值,取自輸入檔案並以 LU 提供。

線性模式所需的真峰值測量值,取自輸入檔案並以 dBTP 提供。

輸入音訊測得的閾值,單位為 LUFS;使用線性模式時必須提供。

POST /run/ffmpeg-api/loudnorm?wait=20 報價 → $0.306
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ffmpeg-api/loudnorm?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

執行此請求

您的金鑰會保留在此瀏覽器中:只會傳送至 Doitong API,且只有在勾選「記住」時才會儲存至 localStorage。 取得 API 金鑰

關於 Ffmpeg Api · Loudnorm

對 `audio_url` 中的檔案套用響度正規化。目標包括 `integrated_loudness`(-70 至 -5 LUFS)、`true_peak`(-9 至 0 dBTP)和 `loudness_range`(1 至 20 LU)。動態雙通道模式為預設值。線性單通道模式需要輸入的測量值,也可回傳測量摘要。

參數

請傳送標準名稱或原生名稱其中之一,不要同時傳送兩者。 標準名稱

名稱類型 預設值允許值 說明
audio_url必填 audio
類型url · audio
指向需要正規化之音訊檔案的 URL。
integrated_loudness選填
類型number
預設值-18
-70 – -5
整合響度的目標值,單位為 LUFS。
true_peak選填
類型number
預設值-0.1
-9 – 0
真峰值上限,單位為 dBTP。
loudness_range選填
類型number
預設值7
1 – 20
響度的目標範圍,單位為 LU。
offset選填
類型number
預設值0
-99 – 99
套用於真峰值限制器之前的增益偏移,單位為 dB。
linear選填
類型boolean
預設值false
正規化模式選擇器:false 選擇品質較高的雙遍動態方式;true 選擇單遍線性處理。
dual_mono選填
類型boolean
預設值false
是否將單聲道輸入視為雙單聲道,以便在立體聲系統上正確測量 EBU R128 響度。
print_summary選填
類型boolean
預設值false
在正規化音訊旁包含響度測量摘要。
measured_i選填
類型number | null
-99 – 0
線性模式從輸入檔案所需的整合響度測量值,以 LUFS 提供。
measured_lra選填
類型number | null
0 – 99
線性模式所需的響度範圍測量值,取自輸入檔案並以 LU 提供。
measured_tp選填
類型number | null
-99 – 99
線性模式所需的真峰值測量值,取自輸入檔案並以 dBTP 提供。
measured_thresh選填
類型number | null
-99 – 0
輸入音訊測得的閾值,單位為 LUFS;使用線性模式時必須提供。
必填 標準名稱,也可使用

檔案參數接受公開的 https:// URL、最大 10 MB 的 data: URI,或上傳檔案的 file_url。 檔案

輸出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ffmpeg-api/loudnorm",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 306,
    "usd": "0.306",
    "charged": 306,
    "refunded": 0
  },
  "input": {
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "output": {
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_name": "0-output.mp3",
      "file_size": 1843200
    },
    "summary": {
      "input_integrated": 1.0,
      "input_true_peak": 1.0,
      "input_lra": 1.0,
      "input_threshold": 1.0,
      "output_integrated": 1.0,
      "output_true_peak": 1.0,
      "output_lra": 1.0,
      "output_threshold": 1.0,
      "normalization_type": "string",
      "target_offset": 1.0
    }
  },
  "outputs": [
    {
      "type": "audio",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_size": 1843200,
      "duration": 12,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
您的檔案,由您選擇每個 outputs[].url 都是儲存空間中的副本:可永久保留(按 GB-月計費),或免費保留 7 天;可透過帳戶設定或 ?storage= 設定。
所有模型使用相同結構圖片、影片和音訊皆包含 type、url、content_type、width、height 和 duration。output 是模型自己的結果物件。
輸出欄位
audio
object {url, content_type, file_name, file_size}正規化後的音訊檔案。
summary
object {input_integrated, input_true_peak, input_lra, input_threshold, output_integrated, output_true_peak, output_lra, output_threshold, normalization_type, target_offset} | null響度測量的結構化摘要,於提出要求時返回。

更多模型:音訊

給 AI 代理程式:此頁面的 Markdown 位於 https://doitong.com/zh-TW/developers/models/ffmpeg-api/loudnorm.md. 所有模型與指南: https://doitong.com/developers/llms.txt