Files
SnapOtter/apps/docs/ar/tools/audio/waveform-image.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
توليد تصوير للموجة الصوتية كصورة PNG من ملف صوتي. 5480106dfe48 human 90007da46f9d

صورة الموجة الصوتية

ولِّد تصويرًا للموجة الصوتية كصورة PNG من ملف صوتي، مع أبعاد ولون قابلين للتهيئة.

نقطة نهاية API

POST /api/v1/tools/audio/waveform-image

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

المعاملات

المعامل النوع مطلوب الافتراضي الوصف
width integer لا 1024 عرض الصورة بالبكسل (من 256 إلى 3840)
height integer لا 256 ارتفاع الصورة بالبكسل (من 64 إلى 1080)
color string لا "#4f46e5" لون الموجة الصوتية بصيغة hex (مثل "#4f46e5")

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

curl -X POST http://localhost:1349/api/v1/tools/audio/waveform-image \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@audio.mp3" \
  -F 'settings={"width": 1920, "height": 400, "color": "#e07832"}'

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

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

ملاحظات

  • الخرج دائمًا صورة PNG، بغضّ النظر عن تنسيق الصوت المُدخل.
  • تُرسَم الموجة الصوتية على خلفية شفافة.
  • مفيدة للصور المصغّرة ومعاينات وسائل التواصل الاجتماعي أو التضمين في صفحات الويب.