mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
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.
This commit is contained in:
SnapOtter
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "التحويل بين الأحادي والاستريو أو تبديل القناتين اليسرى واليمنى."
|
||||
i18n_source_hash: 4f5cd6b38c83
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2285476fc95d
|
||||
---
|
||||
|
||||
# قنوات الصوت {#audio-channels}
|
||||
|
||||
حوّل الصوت بين التخطيطين الأحادي والاستريو، أو بدّل القناتين اليسرى واليمنى لملف استريو.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/audio-channels`
|
||||
|
||||
تقبل بيانات نموذج متعدد الأجزاء مع ملف صوتي وحقل JSON `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| mode | string | نعم | - | عملية القناة: `stereo-to-mono`، `mono-to-stereo`، `swap` |
|
||||
|
||||
## مثال طلب {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/audio-channels \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"mode": "stereo-to-mono"}'
|
||||
```
|
||||
|
||||
## مثال استجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 2300000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- `stereo-to-mono` يمزج القناتين في مسار أحادي واحد.
|
||||
- `mono-to-stereo` يكرّر القناة الأحادية إلى اليسرى واليمنى معاً.
|
||||
- `swap` يبادل القناتين اليسرى واليمنى لملف استريو.
|
||||
- يبقي المخرج عادةً حاوية الإدخال. يُكتَب إدخال AAC بصيغة M4A، وتتراجع مدخلات فك التشفير فقط غير المدعومة إلى MP3.
|
||||
@@ -0,0 +1,73 @@
|
||||
---
|
||||
description: "عرض أو تحرير أو إزالة علامات بيانات الصوت الوصفية (ID3)."
|
||||
i18n_source_hash: 0717018e11cb
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2ea4443e1b26
|
||||
---
|
||||
|
||||
# بيانات الصوت الوصفية {#audio-metadata}
|
||||
|
||||
اعرض أو حرّر أو أزِل علامات بيانات الصوت الوصفية مثل العنوان والفنان والألبوم (ID3 وتنسيقات علامات مماثلة).
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/audio-metadata`
|
||||
|
||||
تقبل بيانات نموذج متعدد الأجزاء مع ملف صوتي وحقل JSON `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| strip | boolean | لا | `false` | إزالة جميع علامات البيانات الوصفية الموجودة |
|
||||
| title | string | لا | - | ضبط علامة العنوان (500 حرف كحد أقصى) |
|
||||
| artist | string | لا | - | ضبط علامة الفنان (500 حرف كحد أقصى) |
|
||||
| album | string | لا | - | ضبط علامة الألبوم (500 حرف كحد أقصى) |
|
||||
|
||||
## مثال طلب {#example-request}
|
||||
|
||||
تحرير علامات البيانات الوصفية:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/audio-metadata \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"title": "My Song", "artist": "Artist Name", "album": "Album Name"}'
|
||||
```
|
||||
|
||||
إزالة جميع البيانات الوصفية:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/audio-metadata \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"strip": true}'
|
||||
```
|
||||
|
||||
## مثال استجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4480000,
|
||||
"metadata": {
|
||||
"container": "mp3",
|
||||
"durationS": 245.3,
|
||||
"bitrateKbps": 192,
|
||||
"tags": {
|
||||
"title": "My Song",
|
||||
"artist": "Artist Name",
|
||||
"album": "Album Name"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- تتضمن الاستجابة كائن `metadata` يحتوي تنسيق الحاوية والمدة ومعدل البت والعلامات الحالية.
|
||||
- عندما يكون `strip` هو `true`، تُتجاهل جميع حقول العلامات وتُزال كل علامة موجودة.
|
||||
- تُحدَّث فقط العلامات التي تقدّمها؛ تبقى العلامات غير المحددة دون تغيير.
|
||||
- يطابق تنسيق المخرج تنسيق الإدخال.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "تسريع أو إبطاء تشغيل الصوت بمُضاعِف."
|
||||
i18n_source_hash: e39ba662e594
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 478709c261d8
|
||||
---
|
||||
|
||||
# سرعة الصوت {#audio-speed}
|
||||
|
||||
سرّع أو أبطئ تشغيل الصوت بتطبيق مُضاعِف سرعة.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/audio-speed`
|
||||
|
||||
تقبل بيانات نموذج متعدد الأجزاء مع ملف صوتي وحقل JSON `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| factor | number | لا | `1.5` | مُضاعِف السرعة (0.25 إلى 4). القيم أقل من 1 تُبطئ؛ وأعلى من 1 تُسرّع. |
|
||||
|
||||
## مثال طلب {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/audio-speed \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"factor": 2}'
|
||||
```
|
||||
|
||||
## مثال استجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 2250000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- المُضاعِف `0.25` يُشغّل بربع السرعة (أطول بـ 4 أضعاف). المُضاعِف `4` يُشغّل بأربعة أضعاف السرعة (أقصر بـ 4 أضعاف).
|
||||
- تُحفَظ طبقة الصوت أثناء تغيّر السرعة (تمدّد زمني). استخدم إزاحة طبقة الصوت لضبط الطبقة بشكل مستقل.
|
||||
- يبقي المخرج عادةً حاوية الإدخال. يُكتَب إدخال AAC بصيغة M4A، وتتراجع مدخلات فك التشفير فقط غير المدعومة إلى MP3.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "تحويل الصوت بين تنسيقات MP3 وWAV وOGG وFLAC وM4A."
|
||||
i18n_source_hash: fd02c059e6a9
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 37d17dd79052
|
||||
---
|
||||
|
||||
# تحويل الصوت {#convert-audio}
|
||||
|
||||
حوّل ملفات الصوت بين التنسيقات الشائعة بما فيها MP3 وWAV وOGG وFLAC وM4A، مع معدل بت إخراج قابل للتكوين.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/convert-audio`
|
||||
|
||||
تقبل بيانات نموذج متعدد الأجزاء مع ملف صوتي وحقل JSON `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | لا | `"mp3"` | تنسيق الإخراج: `mp3`، `wav`، `ogg`، `flac`، `m4a` |
|
||||
| bitrateKbps | integer | لا | `192` | معدل البت للإخراج بالكيلوبت في الثانية (32 إلى 320) |
|
||||
|
||||
## مثال طلب {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/convert-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"format": "flac", "bitrateKbps": 256}'
|
||||
```
|
||||
|
||||
## مثال استجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.flac",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 8200000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- تشمل تنسيقات الإدخال المدعومة MP3 وWAV وOGG وFLAC وAAC وM4A وWMA وAIFF وOPUS.
|
||||
- ينطبق معدل البت فقط على التنسيقات ذات الفقد (MP3 وOGG وM4A). التنسيقات عديمة الفقد مثل WAV وFLAC تتجاهل هذا الإعداد.
|
||||
- يبقي اسم ملف الإخراج الاسم الأصلي مع الامتداد الجديد.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "إضافة تأثيرات التلاشي التصاعدي والتلاشي التنازلي إلى الصوت."
|
||||
i18n_source_hash: 86856451ecb8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 4b753422f89b
|
||||
---
|
||||
|
||||
# تلاشي الصوت {#fade-audio}
|
||||
|
||||
أضف تأثيري التلاشي التصاعدي والتلاشي التنازلي إلى بداية ملف صوتي ونهايته.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/fade-audio`
|
||||
|
||||
تقبل بيانات نموذج متعدد الأجزاء مع ملف صوتي وحقل JSON `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| fadeInS | number | لا | `1` | مدة التلاشي التصاعدي بالثواني (0 إلى 30) |
|
||||
| fadeOutS | number | لا | `1` | مدة التلاشي التنازلي بالثواني (0 إلى 30) |
|
||||
|
||||
## مثال طلب {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/fade-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"fadeInS": 2, "fadeOutS": 3}'
|
||||
```
|
||||
|
||||
## مثال استجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- اضبط أي قيمة إلى `0` لتخطي ذلك الاتجاه من التلاشي. يجب أن تكون واحدة على الأقل أكبر من 0.
|
||||
- تُقيَّد مدة التلاشي إلى طول الصوت إذا تجاوزته.
|
||||
- يبقي المخرج عادةً حاوية الإدخال. يُكتَب إدخال AAC بصيغة M4A، وتتراجع مدخلات فك التشفير فقط غير المدعومة إلى MP3.
|
||||
@@ -0,0 +1,51 @@
|
||||
---
|
||||
description: "دمج عدة ملفات صوتية في مسار متتابع واحد."
|
||||
i18n_source_hash: defa993d3f87
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: b063efc606da
|
||||
---
|
||||
|
||||
# دمج الصوت {#merge-audio}
|
||||
|
||||
ادمج ملفين صوتيين أو أكثر في مسار متتابع واحد، مُلحَقة بالترتيب الذي رُفعت به.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/merge-audio`
|
||||
|
||||
تقبل بيانات نموذج متعدد الأجزاء مع عدة ملفات صوتية وحقل JSON `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | لا | `"mp3"` | تنسيق الإخراج: `mp3`، `wav`، `flac`، `m4a` |
|
||||
|
||||
## مثال طلب {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/merge-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@intro.mp3" \
|
||||
-F "file=@main.mp3" \
|
||||
-F "file=@outro.mp3" \
|
||||
-F 'settings={"format": "mp3"}'
|
||||
```
|
||||
|
||||
## مثال استجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.mp3",
|
||||
"originalSize": 9500000,
|
||||
"processedSize": 9200000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- يقبل من 2 إلى 10 ملفات صوتية لكل طلب.
|
||||
- تُلحَق الملفات بترتيب الرفع.
|
||||
- يُعاد ترميز جميع ملفات الإدخال إلى تنسيق الإخراج ومعدل العينة المختارين للانضمام السلس.
|
||||
- تنسيقات الإدخال المختلطة مدعومة (مثلاً ملف WAV وملف MP3).
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "تقليل ضوضاء الخلفية من الصوت بإزالة الضوضاء القائمة على FFT."
|
||||
i18n_source_hash: 57cbdbd449aa
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 7aedeed9f497
|
||||
---
|
||||
|
||||
# تقليل الضوضاء {#noise-reduction}
|
||||
|
||||
قلّل ضوضاء الخلفية في ملف صوتي باستخدام إزالة الضوضاء القائمة على FFT بقوة قابلة للاختيار.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/noise-reduction`
|
||||
|
||||
تقبل بيانات نموذج متعدد الأجزاء مع ملف صوتي وحقل JSON `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| strength | string | لا | `"medium"` | قوة إزالة الضوضاء: `light`، `medium`، `strong` |
|
||||
|
||||
## مثال طلب {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/noise-reduction \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"strength": "strong"}'
|
||||
```
|
||||
|
||||
## مثال استجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- `light` يحفظ تفاصيل أكثر لكنه يزيل ضوضاء أقل. `strong` يزيل ضوضاء أكثر لكنه قد يُدخل عناصر تشويه دقيقة.
|
||||
- أفضل النتائج على التسجيلات ذات ضوضاء الخلفية المتسقة (طنين المروحة، تكييف الهواء، التشويش الثابت).
|
||||
- يبقي المخرج عادةً حاوية الإدخال. يُكتَب إدخال AAC بصيغة M4A، وتتراجع مدخلات فك التشفير فقط غير المدعومة إلى MP3.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "توحيد مستوى الجهارة إلى مستويات معيار البث (EBU R128)."
|
||||
i18n_source_hash: 794d8cfa5ad8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 52afd57837a2
|
||||
---
|
||||
|
||||
# توحيد الصوت {#normalize-audio}
|
||||
|
||||
وحّد جهارة الصوت إلى مستويات معيار البث باستخدام تطبيع EBU R128 (-16 LUFS).
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/normalize-audio`
|
||||
|
||||
تقبل بيانات نموذج متعدد الأجزاء مع ملف صوتي وحقل JSON `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
ليس لهذه الأداة معاملات قابلة للتكوين. تطبّق تطبيع جهارة EBU R128 تلقائياً.
|
||||
|
||||
## مثال طلب {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/normalize-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3"
|
||||
```
|
||||
|
||||
## مثال استجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- يستخدم معيار جهارة EBU R128، مستهدفاً -16 LUFS.
|
||||
- مثالي لملفات البودكاست والكتب الصوتية ومحتوى البث حيث تكون الجهارة المتسقة مهمة.
|
||||
- يُحفَظ معدل عينة المصدر في المخرج.
|
||||
- يبقي المخرج عادةً حاوية الإدخال. يُكتَب إدخال AAC بصيغة M4A، وتتراجع مدخلات فك التشفير فقط غير المدعومة إلى MP3.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "رفع أو خفض طبقة الصوت بأنصاف نغمات دون تغيير السرعة."
|
||||
i18n_source_hash: 2804d0eeecc8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2c365898720f
|
||||
---
|
||||
|
||||
# إزاحة طبقة الصوت {#pitch-shift}
|
||||
|
||||
ارفع أو اخفض طبقة صوت ملف صوتي بعدد من أنصاف النغمات دون تغيير سرعة تشغيله.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/pitch-shift`
|
||||
|
||||
تقبل بيانات نموذج متعدد الأجزاء مع ملف صوتي وحقل JSON `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| semitones | integer | لا | `3` | أنصاف النغمات للإزاحة (-12 إلى 12). يجب أن تكون غير صفرية. |
|
||||
|
||||
## مثال طلب {#example-request}
|
||||
|
||||
```bash
|
||||
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}'
|
||||
```
|
||||
|
||||
## مثال استجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- القيم الموجبة ترفع الطبقة؛ والقيم السالبة تخفضها.
|
||||
- إزاحة 12 نصف نغمة تساوي أوكتاف واحد إلى الأعلى؛ و-12 تساوي أوكتاف واحد إلى الأسفل.
|
||||
- تبقى مدة التشغيل كما هي بغض النظر عن مقدار الإزاحة.
|
||||
- يبقي المخرج عادةً حاوية الإدخال. يُكتَب إدخال AAC بصيغة M4A، وتتراجع مدخلات فك التشفير فقط غير المدعومة إلى MP3.
|
||||
@@ -0,0 +1,44 @@
|
||||
---
|
||||
description: "عكس ملف صوتي ليُشغَّل بشكل عكسي."
|
||||
i18n_source_hash: 5c2017661803
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 0cd95cda51d5
|
||||
---
|
||||
|
||||
# عكس الصوت {#reverse-audio}
|
||||
|
||||
اعكس ملفاً صوتياً ليُشغَّل بشكل عكسي.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/reverse-audio`
|
||||
|
||||
تقبل بيانات نموذج متعدد الأجزاء مع ملف صوتي وحقل JSON `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
ليس لهذه الأداة معاملات قابلة للتكوين. يُعكَس ملف الصوت بالكامل.
|
||||
|
||||
## مثال طلب {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/reverse-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3"
|
||||
```
|
||||
|
||||
## مثال استجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- يُعكَس مسار الصوت الكامل من النهاية إلى البداية.
|
||||
- يبقي المخرج عادةً حاوية الإدخال. يُكتَب إدخال AAC بصيغة M4A، وتتراجع مدخلات فك التشفير فقط غير المدعومة إلى MP3.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "إنشاء مقطع نغمة رنين من أي ملف صوتي."
|
||||
i18n_source_hash: 8fcdcc545fbc
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 82f2757492e1
|
||||
---
|
||||
|
||||
# صانع نغمات الرنين {#ringtone-maker}
|
||||
|
||||
أنشئ مقطع نغمة رنين (.m4r) من أي ملف صوتي باختيار وقت البدء والمدة.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/ringtone-maker`
|
||||
|
||||
تقبل بيانات نموذج متعدد الأجزاء مع ملف صوتي وحقل JSON `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| startS | number | لا | `0` | وقت البدء بالثواني (الحد الأدنى 0) |
|
||||
| durationS | number | لا | `30` | مدة المقطع بالثواني (1 إلى 30) |
|
||||
|
||||
## مثال طلب {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/ringtone-maker \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"startS": 15, "durationS": 20}'
|
||||
```
|
||||
|
||||
## مثال استجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.m4r",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 620000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- المخرج دائماً بتنسيق M4R، متوافق مع نغمات رنين iPhone.
|
||||
- الحد الأقصى لمدة نغمة الرنين هو 30 ثانية (حد Apple).
|
||||
- يمكن استخدام أي تنسيق صوتي كإدخال.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "إزالة الأجزاء الصامتة من ملف صوتي."
|
||||
i18n_source_hash: a7624fc99b50
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: e01305f99796
|
||||
---
|
||||
|
||||
# إزالة الصمت {#silence-removal}
|
||||
|
||||
اكتشف الأجزاء الصامتة في ملف صوتي وأزِلها بناءً على عتبة قابلة للتهيئة ومدة دنيا.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/silence-removal`
|
||||
|
||||
يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف صوتي وحقل JSON بصيغة `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| thresholdDb | number | لا | `-50` | عتبة الصمت بوحدة dB (من -80 إلى -20). يُعتبر الصوت الأقل من هذا المستوى صامتًا. |
|
||||
| minSilenceS | number | لا | `0.5` | المدة الدنيا للصمت بالثواني لإزالتها (من 0.1 إلى 5) |
|
||||
|
||||
## مثال على الطلب {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/silence-removal \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"thresholdDb": -45, "minSilenceS": 1}'
|
||||
```
|
||||
|
||||
## مثال على الاستجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 3200000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- العتبة الأعلى (الأقل سلبية) أكثر عدوانية وتزيل المقاطع الأهدأ إلى جانب الصمت الحقيقي.
|
||||
- زِد قيمة `minSilenceS` لإزالة الوقفات الأطول فقط مع الحفاظ على الفجوات الطبيعية القصيرة.
|
||||
- مفيد لتنظيف تسجيلات البودكاست والمحاضرات والمذكرات الصوتية.
|
||||
- يحتفظ الخرج عادةً بحاوية الدخل نفسها. يُكتب دخل AAC بصيغة M4A، وتعود المدخلات القابلة للفك فقط وغير المدعومة إلى MP3.
|
||||
@@ -0,0 +1,64 @@
|
||||
---
|
||||
description: "تقسيم الصوت حسب الفواصل الزمنية أو الأجزاء المتساوية أو كشف الصمت."
|
||||
i18n_source_hash: c062a395dbac
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 629ea35d6920
|
||||
---
|
||||
|
||||
# تقسيم الصوت {#split-audio}
|
||||
|
||||
قسِّم ملفًا صوتيًا إلى مقاطع حسب فواصل زمنية ثابتة أو أجزاء متساوية أو كشف الصمت التلقائي. يُرجع أرشيف ZIP يحتوي على المقاطع.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/split-audio`
|
||||
|
||||
يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف صوتي وحقل JSON بصيغة `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| mode | string | لا | `"time"` | استراتيجية التقسيم: `time`، `parts`، `silence` |
|
||||
| segmentS | number | لا | `60` | طول المقطع بالثواني، من 1 إلى 3600 (يُستخدم عندما يكون mode هو `time`) |
|
||||
| parts | integer | لا | `2` | عدد الأجزاء المتساوية، من 2 إلى 20 (يُستخدم عندما يكون mode هو `parts`) |
|
||||
| thresholdDb | number | لا | `-40` | عتبة الصمت بوحدة dB، من -80 إلى -20 (يُستخدم عندما يكون mode هو `silence`) |
|
||||
| minSilenceS | number | لا | `0.3` | الفجوة الدنيا للصمت بالثواني، من 0.1 إلى 10 (يُستخدم عندما يكون mode هو `silence`) |
|
||||
|
||||
## مثال على الطلب {#example-request}
|
||||
|
||||
التقسيم إلى مقاطع مدتها 30 ثانية:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/split-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"mode": "time", "segmentS": 30}'
|
||||
```
|
||||
|
||||
التقسيم حسب كشف الصمت:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/split-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"mode": "silence", "thresholdDb": -35, "minSilenceS": 0.5}'
|
||||
```
|
||||
|
||||
## مثال على الاستجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio_parts.zip",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4600000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- يشير `downloadUrl` إلى أرشيف ZIP يحتوي على جميع المقاطع.
|
||||
- تُستخدم فقط المعاملات ذات الصلة بالوضع `mode` المختار؛ ويُتجاهل الباقي.
|
||||
- تُرقَّم أسماء ملفات المقاطع تسلسليًا (مثل `part-000.mp3`، `part-001.mp3`).
|
||||
- يطابق تنسيق الخرج تنسيق الدخل.
|
||||
@@ -0,0 +1,53 @@
|
||||
---
|
||||
description: "تحويل الكلام إلى نص عبر نسخ مدعوم بالذكاء الاصطناعي."
|
||||
i18n_source_hash: ae98c4c0aed2
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 7102449deaab
|
||||
---
|
||||
|
||||
# نسخ الصوت {#transcribe-audio}
|
||||
|
||||
حوِّل الكلام إلى نص باستخدام نسخ مدعوم بالذكاء الاصطناعي (faster-whisper). يدعم تنسيقات الخرج النصية العادية وSRT وVTT مع اختيار لغة تلقائي أو يدوي.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/transcribe-audio`
|
||||
|
||||
يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف صوتي وحقل JSON بصيغة `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| language | string | لا | `"auto"` | اللغة: `auto`، `en`، `de`، `fr`، `es`، `zh`، `ja`، `ko`، `id`، `th`، `vi` |
|
||||
| outputFormat | string | لا | `"txt"` | تنسيق الخرج: `txt`، `srt`، `vtt` |
|
||||
|
||||
## مثال على الطلب {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/transcribe-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"language": "en", "outputFormat": "srt"}'
|
||||
```
|
||||
|
||||
## مثال على الاستجابة {#example-response}
|
||||
|
||||
هذه أداة غير متزامنة. تُرجع API الاستجابة `202 Accepted` فورًا:
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
تابع التقدم عبر SSE على `GET /api/v1/jobs/{jobId}/progress`. عند اكتمال المهمة، يسلّم بث SSE النتيجة النهائية مع `downloadUrl`.
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- يتطلب تثبيت حزمة ميزة **transcription**. يُرجع `501` برمز `FEATURE_NOT_INSTALLED`، وحقل `feature` المفقود، و`featureName`، و`estimatedSize` إذا لم تكن الحزمة متاحة.
|
||||
- يستخدم faster-whisper للنسخ. تكتشف اللغة `auto` اللغة المنطوقة تلقائيًا.
|
||||
- يتضمّن تنسيقا `srt` و`vtt` طوابع زمنية لكل مقطع، مناسبة للترجمات.
|
||||
- يُرجع تنسيق `txt` نصًا عاديًا بدون طوابع زمنية.
|
||||
- هذه أداة ذكاء اصطناعي طويلة التشغيل؛ يعتمد وقت المعالجة على طول الصوت وعتاد الخادم.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "قص جزء من ملف صوتي عبر تحديد وقتي البداية والنهاية."
|
||||
i18n_source_hash: 8b80c5c8a711
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 871800d5f410
|
||||
---
|
||||
|
||||
# قص الصوت {#trim-audio}
|
||||
|
||||
اقتطع جزءًا من ملف صوتي عبر تحديد وقتي البداية والنهاية بالثواني.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/trim-audio`
|
||||
|
||||
يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف صوتي وحقل JSON بصيغة `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| startS | number | لا | `0` | وقت البداية بالثواني (الحد الأدنى 0) |
|
||||
| endS | number | نعم | - | وقت النهاية بالثواني (يجب أن يكون بعد البداية) |
|
||||
|
||||
## مثال على الطلب {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/trim-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"startS": 10, "endS": 45}'
|
||||
```
|
||||
|
||||
## مثال على الاستجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 1575000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- تُحدَّد الأوقات بالثواني ويمكن أن تتضمّن كسورًا عشرية (مثل `10.5`).
|
||||
- يجب أن تكون قيمة `endS` أكبر من `startS`.
|
||||
- إذا تجاوز `endS` مدة الصوت، يُقص الملف حتى النهاية.
|
||||
- يحتفظ الخرج عادةً بحاوية الدخل نفسها. يُكتب دخل AAC بصيغة M4A، وتعود المدخلات القابلة للفك فقط وغير المدعومة إلى MP3.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "رفع أو خفض مستوى الصوت بمقدار كسب ثابت بالديسيبل."
|
||||
i18n_source_hash: b9bc1de2c9ef
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: d9fa73e130aa
|
||||
---
|
||||
|
||||
# ضبط مستوى الصوت {#volume-adjust}
|
||||
|
||||
ارفع أو اخفض مستوى صوت ملف صوتي بتطبيق كسب ثابت بالديسيبل.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/volume-adjust`
|
||||
|
||||
يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف صوتي وحقل JSON بصيغة `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| gainDb | number | لا | `3` | ضبط مستوى الصوت بالديسيبل (من -30 إلى 30) |
|
||||
|
||||
## مثال على الطلب {#example-request}
|
||||
|
||||
```bash
|
||||
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}'
|
||||
```
|
||||
|
||||
## مثال على الاستجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- ترفع القيم الموجبة مستوى الصوت؛ وتخفضه القيم السالبة.
|
||||
- قد تسبّب قيم الكسب الموجبة الكبيرة قصًّا في الإشارة. استخدم normalize-audio للحصول على تسوية آمنة للجهارة.
|
||||
- يحتفظ الخرج عادةً بحاوية الدخل نفسها. يُكتب دخل AAC بصيغة M4A، وتعود المدخلات القابلة للفك فقط وغير المدعومة إلى MP3.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "توليد تصوير للموجة الصوتية كصورة PNG من ملف صوتي."
|
||||
i18n_source_hash: 5480106dfe48
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 90007da46f9d
|
||||
---
|
||||
|
||||
# صورة الموجة الصوتية {#waveform-image}
|
||||
|
||||
ولِّد تصويرًا للموجة الصوتية كصورة PNG من ملف صوتي، مع أبعاد ولون قابلين للتهيئة.
|
||||
|
||||
## نقطة نهاية API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/waveform-image`
|
||||
|
||||
يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف صوتي وحقل JSON بصيغة `settings`.
|
||||
|
||||
## المعاملات {#parameters}
|
||||
|
||||
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| width | integer | لا | `1024` | عرض الصورة بالبكسل (من 256 إلى 3840) |
|
||||
| height | integer | لا | `256` | ارتفاع الصورة بالبكسل (من 64 إلى 1080) |
|
||||
| color | string | لا | `"#4f46e5"` | لون الموجة الصوتية بصيغة hex (مثل `"#4f46e5"`) |
|
||||
|
||||
## مثال على الطلب {#example-request}
|
||||
|
||||
```bash
|
||||
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"}'
|
||||
```
|
||||
|
||||
## مثال على الاستجابة {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.png",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 45000
|
||||
}
|
||||
```
|
||||
|
||||
## ملاحظات {#notes}
|
||||
|
||||
- الخرج دائمًا صورة PNG، بغضّ النظر عن تنسيق الصوت المُدخل.
|
||||
- تُرسَم الموجة الصوتية على خلفية شفافة.
|
||||
- مفيدة للصور المصغّرة ومعاينات وسائل التواصل الاجتماعي أو التضمين في صفحات الويب.
|
||||
Reference in New Issue
Block a user