ضبط مستوى الصوت بالديسيبل
تتنبأ حاسبة كسب الصوت هذه بما يحدث لذروة مقيسة عند رفع الإشارة أو خفضها بمقدار محدد من الديسيبل.
شغّل الأداة مجانًا
أدخلوا الذروة الحالية بوحدة dBFS والكسب بوحدة dB لتحصلوا على الذروة الناتجة والهامش المتبقي ومؤشر واضح للقص. تفيد الحاسبة في فحص تغيير المستوى قبل معالجة ملف أو إعداد جهاز مزج أو إنشاء سير عمل صوتي آلي. الحساب حتمي، ولا تُرفع الملفات الصوتية ولا تُفك ترميزاتها ولا تُعدّل.
ميّزوا بين مستوى الذروة والكسب
تُقاس الذروة الرقمية عادةً بوحدة 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. أما النتيجة المساوية تماماً لـ0 dBFS فتصل إلى النطاق الكامل من دون أن تتجاوزه، ولذلك تعرض الحاسبة عدم وجود قص وهامشاً صفرياً. يجعل هذا الفرق اختبارات الحدود قابلة للتوقع في الأتمتة. تعني نتيجة موجبة مثل 1.5 dBFS أن الكسب المقترح سيدفع الذروة المعروفة بمقدار 1.5 dB فوق النطاق الكامل، ومن ثم يكون الهامش المعروض -1.5 dB. وتترك النتيجة السالبة هامشاً موجباً. هذا تحذير رياضي وليس محاكاة لنظام صوتي بعينه. تستطيع صيغ الفاصلة العائمة وبعض سلاسل المعالجة الداخلية تمثيل قيم أعلى من النطاق الكامل مؤقتاً، في حين قد تتصرف عمليات التصدير الصحيحة والمسارات الرقمية التناظرية وبرامج الترميز والمكونات الإضافية ومتطلبات الإتقان بطريقة مختلفة. يحتفظ المهندسون غالباً بهامش إضافي للذروات الحقيقية أو المعالجة اللاحقة. استخدموا المؤشر لاكتشاف التجاوز الواضح، ثم راعوا الهامش ومتطلبات صيغة الوجهة عند اختيار كسب نهائي آمن.
استخدموا الحساب في مسارات صوتية قابلة للتكرار
صُممت الحاسبة للقرارات الصغيرة القابلة للتدقيق التي يجب أن تعطي الجواب نفسه كل مرة. في مسار معالجة دفعية، يستطيع ماسح الذروة توفير قيمة dBFS الحالية، ثم تقيّم هذه الإمكانية الكسب المطلوب قبل بدء التصيير. ويمكن لواجهة المستخدم عرض الذروة المتوقعة ومنع تصدير غير آمن، أو يمكن لمهمة مراقبة الجودة تسجيل مؤشر القص إلى جانب القياس الأصلي. يعمل الكسب السالب بصورة طبيعية، لذلك تصلح نقطة النهاية نفسها للتوهين ولتحديد أهداف الهامش. يجب أن يكون كلا الإدخالين رقمين محدودين في JSON؛ وتُرفض السلاسل التي تبدو أرقاماً حتى لا يدمج التكامل نصوصاً أو يقبل قيمة ملتبسة. يكرر الكائن الناتج الإدخالين بعد التحقق منهما، ويعرض الذروة المحسوبة، ويبين وجود القص، ويعبّر عن الهامش المتبقي بوصفه سالب الذروة الناتجة. ولأن الدالة لا تستخدم شبكة أو عشوائية أو ساعة أو مفكك صوت أو حالة خفية، فإن المدخلات المتطابقة تنتج نتائج JSON متطابقة. تذكروا أنها تقيّم ذروة مزودة وتعديلاً موحداً للكسب، ولا تفحص ملفاً صوتياً أو تحسب أثر المعالجة اللاحقة.
حالات الاستخدام
افحصوا تغيير الكسب مسبقاً
تحققوا قبل التصدير مما إذا كانت الزيادة المخططة سترفع ذروة الملف المقيسة فوق 0 dBFS.
اخفضوا المستوى لهامش آمن
طبّقوا كسباً سالباً وتأكدوا من الذروة الناتجة والهامش المتاح للمرحلة التالية.
أضيفوا حاجزاً آلياً ضد القص
ادمجوا ماسح ذروة مع هذا الحساب الحتمي لرفض إعدادات الكسب غير الآمنة في المعالجة الدفعية.
الأسئلة الشائعة
كيف تُحسب الذروة الناتجة؟
يُضاف الكسب بوحدة dB مباشرةً إلى الذروة الحالية بوحدة dBFS: الذروة الناتجة = الذروة الحالية + الكسب.
متى يُشار إلى حدوث القص؟
يكون القص صحيحاً عندما تتجاوز الذروة الناتجة 0 dBFS. أما النتيجة المساوية تماماً لـ0 dBFS فلا تتجاوز النطاق الكامل.
هل يمكن استخدام كسب سالب؟
نعم. يوهن الكسب السالب الإشارة ويخفض الذروة المتوقعة بمقدار الديسيبل المحدد.
هل يُفحص ملف الصوت أو يُعدّل؟
لا. تُجرى العملية على قيمتي الذروة والكسب اللتين تقدمونهما فقط؛ ولا يُستقبل الصوت ولا يُفك ترميزه ولا يُعدّل.
ما تكلفة مطالبة API؟
تكلف كل مطالبة API مبلغ $0.002.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر 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"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
max_mb | 200 |
max_minutes | 180 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |