mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

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

2.7 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
عرض أو تحرير أو إزالة علامات بيانات الصوت الوصفية (ID3).	0717018e11cb	human	2ea4443e1b26

بيانات الصوت الوصفية

اعرض أو حرّر أو أزِل علامات بيانات الصوت الوصفية مثل العنوان والفنان والألبوم (ID3 وتنسيقات علامات مماثلة).

نقطة نهاية API

POST /api/v1/tools/audio/audio-metadata

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

المعاملات

المعامل	النوع	مطلوب	الافتراضي	الوصف
strip	boolean	لا	`false`	إزالة جميع علامات البيانات الوصفية الموجودة
title	string	لا	-	ضبط علامة العنوان (500 حرف كحد أقصى)
artist	string	لا	-	ضبط علامة الفنان (500 حرف كحد أقصى)
album	string	لا	-	ضبط علامة الألبوم (500 حرف كحد أقصى)

مثال طلب

تحرير علامات البيانات الوصفية:

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"}'

إزالة جميع البيانات الوصفية:

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}'

مثال استجابة

{
  "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"
    }
  }
}

ملاحظات

تتضمن الاستجابة كائن metadata يحتوي تنسيق الحاوية والمدة ومعدل البت والعلامات الحالية.
عندما يكون strip هو true، تُتجاهل جميع حقول العلامات وتُزال كل علامة موجودة.
تُحدَّث فقط العلامات التي تقدّمها؛ تبقى العلامات غير المحددة دون تغيير.
يطابق تنسيق المخرج تنسيق الإدخال.

2.7 KiB Raw Blame History