تخطّي إلى المحتوى

Ffmpeg Api · Loudnorm

التكامل

معرّف النموذج 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
ما إذا كانت مداخل mono تُعامل كـ 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؛ مطلوبة عند استخدام الوضع الخطي.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 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"
  }
}
ملفاتك، خيارككل 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ملخص منظم لقياسات شدة الصوت، يُرجع عند طلبه.

مزيد من النماذج: الصوت

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/ffmpeg-api/loudnorm.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt