Files
SnapOtter/apps/docs/ar/tools/audio/pitch-shift.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

1.9 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
رفع أو خفض طبقة الصوت بأنصاف نغمات دون تغيير السرعة. 2804d0eeecc8 human 2c365898720f

إزاحة طبقة الصوت

ارفع أو اخفض طبقة صوت ملف صوتي بعدد من أنصاف النغمات دون تغيير سرعة تشغيله.

نقطة نهاية API

POST /api/v1/tools/audio/pitch-shift

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

المعاملات

المعامل النوع مطلوب الافتراضي الوصف
semitones integer لا 3 أنصاف النغمات للإزاحة (-12 إلى 12). يجب أن تكون غير صفرية.

مثال طلب

curl -X POST http://localhost:1349/api/v1/tools/audio/pitch-shift \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@audio.mp3" \
  -F 'settings={"semitones": -5}'

مثال استجابة

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

ملاحظات

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