Перейти к содержимому

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
Определяет, обрабатываются ли монофонические входные данные как dual-mono, чтобы измерения громкости 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, data: URI размером до 10 MB или 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"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 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/ru/developers/models/ffmpeg-api/loudnorm.md. Все модели и руководства: https://doitong.com/developers/llms.txt