/api/app/voice200 OK · audio/mpegcurl -X POST https://sorato.group/api/app/voice \
-H "Authorization: Bearer mk_live_..." \
-F "text=Hello, this is my cloned voice." \
-F "target_language=es-ES"نقاط نهاية REST لاستنساخ الصوت والترجمة والنسخ ووكلاء الاجتماعات، بالإضافة إلى الصور الرمزية في الوقت الفعلي على LiveKit.
كل أداة في الاستوديو هي أيضًا نقطة نهاية REST. نفس المصادقة، نفس الحساب، نفس المفتاح.
/api/app/fm/generateيضع حلقة LoqalFM في قائمة الانتظار. يعيد jobId فورًا: استعلم GET /api/app/fm/jobs/{jobId} حتى status=completed، ثم قم بتنزيل الصوت.
Authorization: Bearer mk_live_…. في المتصفح، يتم استخدام ملف تعريف الارتباط للجلسة المسجلة تلقائيًا.| genre | string | مطلوب | تنسيق البث: إعلان، مقابلة، طقس، حركة المرور، اتصال، psa، برنامج حواري، نشرة أخبار. |
| language | string | اختياري | لغة البث BCP-47. الافتراضي en-US. |
| world_info | string | اختياري | موضوع / بذرة عالمية. اتركه فارغًا للمفاجأة. |
| duration | number | اختياري | تجاوز طول التنسيق الافتراضي (ثواني). |
curl -X POST https://sorato.group/api/app/fm/generate \
-H "Authorization: Bearer mk_live_..." \
-H "Content-Type: application/json" \
-d '{"genre": "interview", "world_info": "the history of tea"}'/api/app/voiceيستنسخ صوتًا من عينة صوتية ويقوم بتوليف النص فيه، مع إمكانية الترجمة أولاً. مرر voice_id لإعادة استخدام استنساخ موجود.
Authorization: Bearer mk_live_…. في المتصفح، يتم استخدام ملف تعريف الارتباط للجلسة المسجلة تلقائيًا.| audio | file | اختياري | عينة صوتية (تجاهل عند إعادة استخدام voice_id). |
| text | string | مطلوب | ما يجب أن يقوله الصوت المستنسخ. |
| target_language | string | اختياري | لغة الإخراج، مثل es-ES. الافتراضي en-US. |
| translate | boolean | اختياري | ترجمة النص إلى target_language قبل التركيب. |
| voice_id | string | اختياري | إعادة استخدام استنساخ من مكالمة سابقة. |
curl -X POST https://sorato.group/api/app/voice \
-H "Authorization: Bearer mk_live_..." \
-F "[email protected]" \
-F "text=Hello, this is my cloned voice." \
-F "target_language=es-ES"/api/app/translateأرسل مقطعًا قصيرًا منطوقًا ولغة مستهدفة. احصل على النص والترجمة والكلام المركب في استجابة واحدة.
Authorization: Bearer mk_live_…. في المتصفح، يتم استخدام ملف تعريف الارتباط للجلسة المسجلة تلقائيًا.| audio | file | مطلوب | تسجيل قصير منطوق. |
| target_lang | string | مطلوب | لغة الهدف BCP-47، مثل es-ES. |
curl -X POST https://sorato.group/api/app/translate \
-H "Authorization: Bearer mk_live_..." \
-F "[email protected]" \
-F "target_lang=es-ES"/api/app/transcribeحمل تسجيلًا واحصل على JSON للنص المفرغ، أو وثيقة HTML/PDF منسقة بتحديد معلمة التنسيق.
Authorization: Bearer mk_live_…. في المتصفح، يتم استخدام ملف تعريف الارتباط للجلسة المسجلة تلقائيًا.| audio | file | مطلوب | ملف صوتي أو فيديو. |
| target | string | اختياري | لغة الإخراج BCP-47 للترجمة. الافتراضي en. |
| title | string | اختياري | عنوان المستند لإخراج html/pdf. |
| format | query: json|html|pdf | اختياري | شكل الاستجابة. الافتراضي json. |
curl -X POST "https://sorato.group/api/app/transcribe?format=json" \
-H "Authorization: Bearer mk_live_..." \
-F "[email protected]"/api/app/meet/launchأطلق بوت في Zoom أو Meet أو Teams. يعيد bot_id و sid: استعلم النص الحي، ثم قم بعرض المحاضر عند انتهاء المكالمة.
Authorization: Bearer mk_live_…. في المتصفح، يتم استخدام ملف تعريف الارتباط للجلسة المسجلة تلقائيًا.| meeting_url | string | مطلوب | رابط Google Meet / Zoom / Teams. |
| mode | string | اختياري | conference | bilingual | monolingual. Default conference. |
| user_language | string | اختياري | اللغة الثانية لوضع ثنائي اللغة (مترجم). |
| avatar_id | string | اختياري | أفاتار للعرض، من GET /api/app/meet/characters. |
curl -X POST https://sorato.group/api/app/meet/launch \
-H "Authorization: Bearer mk_live_..." \
-H "Content-Type: application/json" \
-d '{"meeting_url": "https://meet.google.com/xyz-abcd-efg", "mode": "bilingual", "user_language": "es-ES"}'/api/app/learnقم بتحميل درس صوتي/فيديو. ينسخه، ثم يستخرج ملخصًا، وملخصات، وأسئلة الفهم في user_language.
Authorization: Bearer mk_live_…. في المتصفح، يتم استخدام ملف تعريف الارتباط للجلسة المسجلة تلقائيًا.| media | file | مطلوب | درس صوتي أو فيديو. |
| user_language | string | اختياري | لغة دعم للمصطلحات/الأسئلة. الافتراضي en. |
| glosses_only | boolean | اختياري | إرجاع المصطلحات فقط، تخطي الأسئلة. |
curl -X POST https://sorato.group/api/app/learn \
-H "Authorization: Bearer mk_live_..." \
-F "[email protected]" \
-F "user_language=es"/api/app/voqal/tokenيعيد رمز LiveKit وURL لتوصيل عميل بوكيل أفاتار حي. قم بإدراج الأفاتارات أولاً باستخدام GET /api/app/voqal/avatars.
Authorization: Bearer mk_live_…. في المتصفح، يتم استخدام ملف تعريف الارتباط للجلسة المسجلة تلقائيًا.| avatar_id | string | مطلوب | UUID للأفاتار من GET /api/app/voqal/avatars. |
| language | string | اختياري | اللغة المنطوقة. الافتراضي en. |
| name | string | اختياري | اسم العرض للمشارك في الجلسة. |
curl -X POST https://sorato.group/api/app/voqal/token \
-H "Authorization: Bearer mk_live_..." \
-H "Content-Type: application/json" \
-d '{"avatar_id": "...", "language": "es"}'