POSTEN/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"

Rufen Sie jedes Loqal-Tool aus Ihrem eigenen Code auf.

REST-Endpunkte für Sprachklonung, Übersetzung, Transkription und Meeting-Agenten sowie Echtzeit-Avatare auf LiveKit.

Sieben Werkzeuge, ein Schlüssel

Jedes Werkzeug im Studio ist auch ein REST-Endpunkt. Gleiche Authentifizierung, gleiches Konto, gleicher Schlüssel.

API

POST/api/app/fm/generate

Stellt eine einmalige LoqalFM-Episode in die Warteschlange. Gibt sofort eine jobId zurück: Abfrage GET /api/app/fm/jobs/{jobId} bis status=completed, dann Audio herunterladen.

Authentifizierung. Senden Sie Ihren Loqal API-Schlüssel als Authorization: Bearer mk_live_…. Im Browser wird das eingeloggte Session-Cookie automatisch verwendet.

Anfrage

genrestringerforderlichSendeformat: Werbung, Interview, Wetter, Verkehr, Anruf, PSA, Talkshow, Nachrichtenflash.
languagestringoptionalBCP-47 Sendesprache. Standard en-US.
world_infostringoptionalThema / Welt-Samen. Lassen Sie es leer für eine Überraschung.
durationnumberoptionalÜberschreiben Sie die Standardlänge des Formats (Sekunden).

Beispiel

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

Klonen Sie eine Stimme aus einer Audioaufnahme und synthetisieren Sie Text darin, optional zuerst übersetzen. Übergeben Sie voice_id, um einen vorhandenen Klon wiederzuverwenden.

Authentifizierung. Senden Sie Ihren Loqal API-Schlüssel als Authorization: Bearer mk_live_…. Im Browser wird das eingeloggte Session-Cookie automatisch verwendet.

Anfrage

audiofileoptionalStimmprobe (weglassen bei Verwendung von voice_id).
textstringerforderlichWas die geklonte Stimme sagen soll.
target_languagestringoptionalAusgabesprache, z. B. es-ES. Standardmäßig en-US.
translatebooleanoptionalÜbersetzen Sie den Text in target_language vor der Synthese.
voice_idstringoptionalVerwenden Sie einen Klon aus einem vorherigen Anruf erneut.

Beispiel

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

Senden Sie einen kurzen gesprochenen Clip und eine Zielsprache. Erhalten Sie die Transkription, Übersetzung und synthetisierte Sprache in einer Antwort zurück.

Authentifizierung. Senden Sie Ihren Loqal API-Schlüssel als Authorization: Bearer mk_live_…. Im Browser wird das eingeloggte Session-Cookie automatisch verwendet.

Anfrage

audiofileerforderlichKurze gesprochene Aufnahme.
target_langstringerforderlichBCP-47 Zielsprache, z.B. es-ES.

Beispiel

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

Laden Sie eine Aufnahme hoch und erhalten Sie ein Transkript-JSON oder ein stilisiertes HTML/PDF-Dokument, indem Sie den Formatparameter einstellen.

Authentifizierung. Senden Sie Ihren Loqal API-Schlüssel als Authorization: Bearer mk_live_…. Im Browser wird das eingeloggte Session-Cookie automatisch verwendet.

Anfrage

audiofileerforderlichAudio- oder Videodatei.
targetstringoptionalBCP-47-Ausgabesprache für die Übersetzung. Standard en.
titlestringoptionalDokumenttitel für html/pdf-Ausgabe.
formatquery: json|html|pdfoptionalAntwortformat. Standard json.

Beispiel

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

Starten Sie einen Bot in Zoom, Meet oder Teams. Gibt bot_id und sid zurück: Abfrage des Live-Transkripts, dann Protokolle rendern, wenn der Anruf endet.

Authentifizierung. Senden Sie Ihren Loqal API-Schlüssel als Authorization: Bearer mk_live_…. Im Browser wird das eingeloggte Session-Cookie automatisch verwendet.

Anfrage

meeting_urlstringerforderlichGoogle Meet / Zoom / Teams Link.
modestringoptionalconference | bilingual | monolingual. Default conference.
user_languagestringoptionalZweite Sprache für den zweisprachigen (Dolmetscher-)Modus.
avatar_idstringoptionalAvatar zum Rendern, von GET /api/app/meet/characters.

Beispiel

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

Laden Sie eine Audio-/Video-Lektion hoch. Transkribiert sie, extrahiert dann eine Zusammenfassung, Glossare und Verständnisfragen in user_language.

Authentifizierung. Senden Sie Ihren Loqal API-Schlüssel als Authorization: Bearer mk_live_…. Im Browser wird das eingeloggte Session-Cookie automatisch verwendet.

Anfrage

mediafileerforderlichAudio- oder Video-Lektion.
user_languagestringoptionalUnterstützungssprache für Glossare/Fragen. Standard en.
glosses_onlybooleanoptionalGibt nur Glossare zurück, Fragen werden übersprungen.

Beispiel

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

Gibt ein LiveKit-Token und eine URL zurück, um einen Client mit einem Live-Avatar-Agenten zu verbinden. Listen Sie zuerst Avatare mit GET /api/app/voqal/avatars auf.

Authentifizierung. Senden Sie Ihren Loqal API-Schlüssel als Authorization: Bearer mk_live_…. Im Browser wird das eingeloggte Session-Cookie automatisch verwendet.

Anfrage

avatar_idstringerforderlichAvatar-UUID von GET /api/app/voqal/avatars.
languagestringoptionalGesprochene Sprache. Standard en.
namestringoptionalAnzeigename für den Sitzungsteilnehmer.

Beispiel

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

Nächste Schritte