Bỏ qua đến nội dung

Ffmpeg Api · Loudnorm

Tích hợp

Id mô hình 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"

Tối đa 0,306 $ mỗi lần chạy tính phí theo mức sử dụng thực tế, phần còn lại được hoàn tiền Chạy trên trang này

Lấy khóa API
Utility Âm thanh #ffmpeg

Chuẩn hóa độ lớn âm thanh theo mục tiêu EBU R128 với các thiết lập LUFS, đỉnh thực và dải động có thể điều chỉnh

Utility · Âm thanh

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc audio_url
Thả tệp hoặc

URL trỏ đến tệp âm thanh cần chuẩn hóa.

Nâng cao integrated_loudness · true_peak · loudness_range · offset · measured_i · measured_lra · measured_tp · measured_thresh · linear · dual_mono · print_summary
mặc định -18

Giá trị mục tiêu cho độ lớn âm thanh tích hợp, tính bằng LUFS.

mặc định -0.1

Mức trần true-peak, tính bằng dBTP.

mặc định 7

Phạm vi độ lớn âm thanh mục tiêu, tính bằng LU.

mặc định 0

Độ lệch gain, tính bằng dB, được áp dụng trước bộ giới hạn true-peak.

Phép đo độ lớn tích hợp mà chế độ tuyến tính yêu cầu từ tệp đầu vào, được cung cấp theo LUFS.

Phép đo phạm vi độ lớn cần cho chế độ tuyến tính, lấy từ tệp đầu vào và cung cấp theo LU.

Phép đo true-peak cần cho chế độ tuyến tính, được cung cấp theo dBTP từ tệp đầu vào.

Ngưỡng được đo của âm thanh đầu vào, tính bằng LUFS; bắt buộc khi dùng chế độ tuyến tính.

POST /run/ffmpeg-api/loudnorm?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Ffmpeg Api · Loudnorm

Áp dụng chuẩn hóa độ lớn cho tệp tại `audio_url`. Các mục tiêu gồm `integrated_loudness` (-70 đến -5 LUFS), `true_peak` (-9 đến 0 dBTP) và `loudness_range` (1 đến 20 LU). Chế độ động hai lượt là mặc định. Chế độ tuyến tính một lượt cần các giá trị đã đo của đầu vào và có thể trả về bản tóm tắt đo lường.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
audio_urlbắt buộc audio
Kiểuurl · audio
URL trỏ đến tệp âm thanh cần chuẩn hóa.
integrated_loudnesstùy chọn
Kiểunumber
Mặc định-18
-70 – -5
Giá trị mục tiêu cho độ lớn âm thanh tích hợp, tính bằng LUFS.
true_peaktùy chọn
Kiểunumber
Mặc định-0.1
-9 – 0
Mức trần true-peak, tính bằng dBTP.
loudness_rangetùy chọn
Kiểunumber
Mặc định7
1 – 20
Phạm vi độ lớn âm thanh mục tiêu, tính bằng LU.
offsettùy chọn
Kiểunumber
Mặc định0
-99 – 99
Độ lệch gain, tính bằng dB, được áp dụng trước bộ giới hạn true-peak.
lineartùy chọn
Kiểuboolean
Mặc địnhfalse
Bộ chọn chế độ chuẩn hóa: false chọn phương pháp động hai lượt có chất lượng cao hơn; true chọn xử lý tuyến tính một lượt.
dual_monotùy chọn
Kiểuboolean
Mặc địnhfalse
Xác định đầu vào mono có được xử lý như dual-mono để các phép đo độ lớn EBU R128 chính xác trên hệ thống stereo hay không.
print_summarytùy chọn
Kiểuboolean
Mặc địnhfalse
Bao gồm bản tóm tắt các phép đo độ lớn cùng với âm thanh đã chuẩn hóa.
measured_itùy chọn
Kiểunumber | null
-99 – 0
Phép đo độ lớn tích hợp mà chế độ tuyến tính yêu cầu từ tệp đầu vào, được cung cấp theo LUFS.
measured_lratùy chọn
Kiểunumber | null
0 – 99
Phép đo phạm vi độ lớn cần cho chế độ tuyến tính, lấy từ tệp đầu vào và cung cấp theo LU.
measured_tptùy chọn
Kiểunumber | null
-99 – 99
Phép đo true-peak cần cho chế độ tuyến tính, được cung cấp theo dBTP từ tệp đầu vào.
measured_threshtùy chọn
Kiểunumber | null
-99 – 0
Ngưỡng được đo của âm thanh đầu vào, tính bằng LUFS; bắt buộc khi dùng chế độ tuyến tính.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
audio
object {url, content_type, file_name, file_size}Tệp âm thanh sau khi chuẩn hóa.
summary
object {input_integrated, input_true_peak, input_lra, input_threshold, output_integrated, output_true_peak, output_lra, output_threshold, normalization_type, target_offset} | nullBản tóm tắt có cấu trúc về các phép đo độ lớn, được trả về khi được yêu cầu.

Thêm mô hình: Âm thanh

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/ffmpeg-api/loudnorm.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt