פוסט/api/app/voice200 OK · audio/mpeg
curl -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"

הפעל כל כלי Loqal מהקוד שלך.

נקודות קצה של REST לשכפול קול, תרגום, תמלול וסוכני פגישות, בנוסף לאווטרים בזמן אמת ב-LiveKit.

שבעה כלים, מפתח אחד

כל כלי בסטודיו הוא גם נקודת קצה REST. אותה אימות, אותו חשבון, אותו מפתח.

API

POST/api/app/fm/generate

מכניס לתור פרק חד פעמי LoqalFM. מחזיר jobId מיד: בצע polling ל-GET /api/app/fm/jobs/{jobId} עד status=completed, ואז הורד את האודיו.

אימות. שלח את מפתח ה-API שלך של Loqal כ-Authorization: Bearer mk_live_…. בדפדפן נעשה שימוש אוטומטי בעוגיית המושב המחובר.

בקשה

genrestringנדרשפורמט שידור: פרסומת, ראיון, מזג אוויר, תנועה, שיחה, psa, תוכנית אירוח, חדשות בזק.
languagestringאופציונלישפת שידור BCP-47. ברירת מחדל en-US.
world_infostringאופציונלינושא / זרע עולמי. השאר ריק להפתעה.
durationnumberאופציונליעקוף את אורך ברירת המחדל של הפורמט (שניות).

דוגמה

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

POST/api/app/voice

משכפל קול מדגימת אודיו ומסנתז טקסט בתוכה, עם אפשרות לתרגם קודם. העבר voice_id כדי להשתמש מחדש בשכפול קיים.

אימות. שלח את מפתח ה-API שלך של Loqal כ-Authorization: Bearer mk_live_…. בדפדפן נעשה שימוש אוטומטי בעוגיית המושב המחובר.

בקשה

audiofileאופציונלידוגמת קול (לדלג בעת שימוש חוזר ב-voice_id).
textstringנדרשמה שהקול המשוכפל צריך לומר.
target_languagestringאופציונלישפת פלט, לדוגמה, es-ES. ברירת מחדל en-US.
translatebooleanאופציונליתרגם טקסט ל-target_language לפני הסינתזה.
voice_idstringאופציונליהשתמש שוב בשכפול משיחה קודמת.

דוגמה

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

POST/api/app/translate

שלח קליפ קצר מדובר ושפה יעד. קבל בחזרה את התמלול, התרגום והדיבור המסונתז בתגובה אחת.

אימות. שלח את מפתח ה-API שלך של Loqal כ-Authorization: Bearer mk_live_…. בדפדפן נעשה שימוש אוטומטי בעוגיית המושב המחובר.

בקשה

audiofileנדרשהקלטה קצרה מדוברת.
target_langstringנדרששפת יעד 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

POST/api/app/transcribe

העלה הקלטה וקבל בחזרה JSON של תמלול, או מסמך HTML/PDF מעוצב על ידי הגדרת פרמטר הפורמט.

אימות. שלח את מפתח ה-API שלך של Loqal כ-Authorization: Bearer mk_live_…. בדפדפן נעשה שימוש אוטומטי בעוגיית המושב המחובר.

בקשה

audiofileנדרשקובץ אודיו או וידאו.
targetstringאופציונלישפת פלט BCP-47 לתרגום. ברירת מחדל אנגלית.
titlestringאופציונליכותרת המסמך לפלט html/pdf.
formatquery: json|html|pdfאופציונליצורת תגובה. ברירת מחדל json.

דוגמה

curl -X POST "https://sorato.group/api/app/transcribe?format=json" \
  -H "Authorization: Bearer mk_live_..." \
  -F "[email protected]"

API

POST/api/app/meet/launch

השק בוט ב-Zoom, Meet או Teams. מחזיר bot_id ו-sid: בצע polling לתמלול החי, ואז הצג את הפרוטוקול כשהשיחה מסתיימת.

אימות. שלח את מפתח ה-API שלך של Loqal כ-Authorization: Bearer mk_live_…. בדפדפן נעשה שימוש אוטומטי בעוגיית המושב המחובר.

בקשה

meeting_urlstringנדרשקישור Google Meet / Zoom / Teams.
modestringאופציונליconference | bilingual | monolingual. Default conference.
user_languagestringאופציונלישפה שנייה למצב דו-לשוני (מתורגמן).
avatar_idstringאופציונליאווטאר להצגה, מ-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

POST/api/app/learn

העלה שיעור אודיו/וידאו. מתמלל אותו, ואז מחלץ סיכום, גלוסות ושאלות הבנה ב-user_language.

אימות. שלח את מפתח ה-API שלך של Loqal כ-Authorization: Bearer mk_live_…. בדפדפן נעשה שימוש אוטומטי בעוגיית המושב המחובר.

בקשה

mediafileנדרששיעור אודיו או וידאו.
user_languagestringאופציונלישפת תמיכה לגלוסרים/שאלות. ברירת מחדל en.
glosses_onlybooleanאופציונליהחזר רק גלוסרים, דלג על שאלות.

דוגמה

curl -X POST https://sorato.group/api/app/learn \
  -H "Authorization: Bearer mk_live_..." \
  -F "[email protected]" \
  -F "user_language=es"

API

POST/api/app/voqal/token

מחזיר אסימון LiveKit ו-URL לחיבור לקוח לסוכן אווטאר חי. הצג תחילה אווטארים עם GET /api/app/voqal/avatars.

אימות. שלח את מפתח ה-API שלך של Loqal כ-Authorization: Bearer mk_live_…. בדפדפן נעשה שימוש אוטומטי בעוגיית המושב המחובר.

בקשה

avatar_idstringנדרשUUID של האווטאר מ-GET /api/app/voqal/avatars.
languagestringאופציונלישפה מדוברת. ברירת מחדל en.
namestringאופציונלישם תצוגה למשתתף הסשן.

דוגמה

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

השלבים הבאים