Files
SnapOtter/apps/docs/ar/tools/audio/volume-adjust.md
T
SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520)
Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.
2026-07-15 21:55:51 +08:00

1.8 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
رفع أو خفض مستوى الصوت بمقدار كسب ثابت بالديسيبل. 4bc993fd4e08 human d9fa73e130aa

ضبط مستوى الصوت

ارفع أو اخفض مستوى صوت ملف صوتي بتطبيق كسب ثابت بالديسيبل.

نقطة نهاية API

POST /api/v1/tools/audio/volume-adjust

يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف صوتي وحقل JSON بصيغة settings.

المعاملات

المعامل النوع مطلوب الافتراضي الوصف
gainDb number لا 3 ضبط مستوى الصوت بالديسيبل (من -30 إلى 30)

مثال على الطلب

curl -X POST http://localhost:1349/api/v1/tools/audio/volume-adjust \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@audio.mp3" \
  -F 'settings={"gainDb": 6}'

مثال على الاستجابة

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
  "originalSize": 4500000,
  "processedSize": 4500000
}

ملاحظات

  • ترفع القيم الموجبة مستوى الصوت؛ وتخفضه القيم السالبة.
  • قد تسبّب قيم الكسب الموجبة الكبيرة قصًّا في الإشارة. استخدم normalize-audio للحصول على تسوية آمنة للجهارة.
  • يحتفظ الخرج عادةً بحاوية الدخل نفسها. يُكتب دخل AAC بصيغة M4A، وتعود المدخلات القابلة للفك فقط وغير المدعومة إلى MP3.