- التوثيق
مقدمة
Welcome to the documentation for Dubbix. A powerful solution designed to revolutionize the way you approach audio localization and content creation.
ماذا يوجد داخل واجهة برمجة التطبيقات API v2 الخاصة بنا؟
تعمل واجهة برمجة التطبيقات الخاصة بنا على تبسيط ترجمة المحتوى. ما عليك سوى تحميل الفيديو الخاص بك والحصول على النتيجة المترجمة دون عناء.
إشعار إهمال API v1
تم إيقاف دعم API v1 رسميًا بعد إصدار API v2.
اعتبارًا من مايو 2025، تم إهمال API v1 بالكامل ولم يعد الوصول إليها متاحًا.
يجب أن تستخدم جميع عمليات التكامل الآن واجهة برمجة التطبيقات API v2.
القيود
قائمة قيود API v2
نحن نعمل باستمرار على تحسين واجهة برمجة التطبيقات (API) الخاصة بنا، ومع ذلك، هذه قائمة بالقيود الحالية:
1. ندعم حاليًا الطرق التالية لتحميل الفيديو الخاص بك:
التحميل عبر رابط باستخدام روابط للفيديو على Youtube أو Google Drive أو S3 أو Vimeo أو رابط وصول مباشر;
التحميل المحلي من جهازك.
3. ليس من الممكن بعد إنشاء فيديو مع ترجمة عبر واجهة برمجة التطبيقات. ستتم إضافة هذه الميزة في المستقبل، في غضون ذلك، يمكنك استخدام منصة الويب الخاصة بنا للحصول على نسخة من الفيديو المترجم مع ترجمة باللغة المستهدفة مدمجة فيه.
تحويل النص إلى كلام (TTS)
عنوان URL الأساسي:** 'https://api.example.com'
نقاط النهاية
WebSocket /tts_stream/bytes
نقطة نهاية دفق تحويل النص إلى كلام في الوقت الحقيقي التي تقبل إدخال النص وتدفق المقاطع الصوتية أثناء إنشائها.
**عنوان URL:** 'ws://ws://api.example.com/tts_stream/bytes' أو 'wss://api.example.com/tts_stream/bytes'
**البروتوكول:** WebSocket
#### اتصال ####
إنشاء اتصال WebSocket بنقطة النهاية. يتم تعيين معرف مستخدم فريد لكل اتصال تلقائياً.
#### تنسيق الرسالة ####
إرسال رسائل JSON بالبنية التالية:
تحويل الصوت
تقوم نقطة النهاية هذه بتحويل الصوت من كلام إلى كلام.
التي تقدمها:
- ملف صوتي مرجعي ** (الصوت الذي تريد تقليده)**
- ملف صوتي مدخل ** (المحتوى الذي تريد نطقه بهذا الصوت)**
تقوم واجهة برمجة التطبيقات بإرجاع ملف WAV محوّل مع محتوى الإدخال المنطوق بالصوت المرجعي.
## نقطة النهاية
POST /voice_convert_convert/vc
## الطلب
### الرؤوس
قبول: تطبيق/جسون
نوع المحتوى: متعدد الأجزاء/النموذج-بيانات
### معلمات بيانات النموذج ### ### معلمات بيانات النموذج
reference_file (ملف، مطلوب) - ملف صوتي مرجعي (.wav أو .mp3) يحتوي على الصوت المستهدف input_file (ملف، مطلوب) - ملف صوتي مرجعي (.wav أو .mp3) يحتوي على المحتوى المراد تحويله
## أمثلة على الطلبات
### cURL
إرسال رسائل JSON بالبنية التالية:
### بايثون (الطلبات)
'''بيثون
استيراد الطلبات
## القيود:
- يجب أن يتراوح طول الملف الصوتي المرجعي بين 4 و20 ثانية، والمدى الموصى به هو 12-15 ثانية.
## ملاحظات
- Both files must be short enough for processing (recommend < 30MB each).
- Output is always returned as WAV.
- The endpoint streams the file back — remember to save the binary output.
ملخص الصوت والفيديو
تسمح لك واجهة برمجة التطبيقات هذه بـ **تحميل ملفات الصوت أو الفيديو** واستقبالها:
- **النسخة النصية** (نص المحتوى المنطوق)
- **الطوابع الزمنية** (متناسقة مع مقاطع النص)
- **ملخص** (نسخة مختصرة من المحتوى)
1. تلخيص ملف الصوت/الفيديو
**نقطة النهاية**
قبول: تطبيق/جسون
نوع المحتوى: متعدد الأجزاء/النموذج-بيانات
**الوصف**
قم بتحميل ملف صوتي أو فيديو (على سبيل المثال، 'wav' أو 'mp3' أو 'mp4') واحصل على نسخة نص وطوابع زمنية وملخص خاص باللغة.
## توصيات للاستخدام:
+ Always include a unique `request_id` for better tracking.
+ Keep file sizes reasonable (<100MB recommended).
الدبلجة/الترجمة
التحدث إلى كلام إلى كلام
**عنوان URL الأساسي:** 'https://api.example.com'
## نقاط النهاية
### POST ### POST /speech/translate
ترجمة الكلام من لغة إلى أخرى، وإرجاع الصوت المترجم كملف WAV.