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

Appelez n'importe quel outil Loqal depuis votre propre code.

Points de terminaison REST pour le clonage de voix, la traduction, la transcription et les agents de réunion, ainsi que des avatars en temps réel sur LiveKit.

Sept outils, une clé

Chaque outil du Studio est également un point de terminaison REST. Même authentification, même compte, même clé.

API

POST/api/app/fm/generate

Met en file d'attente un épisode unique LoqalFM. Retourne un jobId immédiatement : interrogez GET /api/app/fm/jobs/{jobId} jusqu'à ce que status=completed, puis téléchargez l'audio.

Auth. Envoyez votre clé API Loqal comme Authorization: Bearer mk_live_…. Dans le navigateur, le cookie de session connecté est utilisé automatiquement.

Requête

genrestringobligatoireFormat de diffusion : publicité, interview, météo, trafic, appel, psa, talkshow, flash info.
languagestringoptionnelLangue de diffusion BCP-47. Par défaut en-US.
world_infostringoptionnelSujet / graine mondiale. Laissez vide pour une surprise.
durationnumberoptionnelRemplacez la longueur par défaut du format (secondes).

Exemple

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

Clone une voix à partir d'un échantillon audio et synthétise du texte dedans, en traduisant éventuellement d'abord. Passez voice_id pour réutiliser un clone existant.

Auth. Envoyez votre clé API Loqal comme Authorization: Bearer mk_live_…. Dans le navigateur, le cookie de session connecté est utilisé automatiquement.

Requête

audiofileoptionnelÉchantillon de voix (omettre lors de la réutilisation de voice_id).
textstringobligatoireCe que la voix clonée doit dire.
target_languagestringoptionnelLangue de sortie, par exemple, es-ES. Par défaut en-US.
translatebooleanoptionnelTraduire le texte en target_language avant la synthèse.
voice_idstringoptionnelRéutiliser un clone d'un appel précédent.

Exemple

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

Envoyez un court extrait parlé et une langue cible. Recevez la transcription, la traduction et la parole synthétisée en une seule réponse.

Auth. Envoyez votre clé API Loqal comme Authorization: Bearer mk_live_…. Dans le navigateur, le cookie de session connecté est utilisé automatiquement.

Requête

audiofileobligatoireEnregistrement parlé court.
target_langstringobligatoireLangue cible BCP-47, par exemple, es-ES.

Exemple

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

Téléchargez un enregistrement et recevez un JSON de transcription, ou un document HTML/PDF stylisé en définissant le paramètre de format.

Auth. Envoyez votre clé API Loqal comme Authorization: Bearer mk_live_…. Dans le navigateur, le cookie de session connecté est utilisé automatiquement.

Requête

audiofileobligatoireFichier audio ou vidéo.
targetstringoptionnelLangue de sortie BCP-47 pour la traduction. Par défaut, en.
titlestringoptionnelTitre du document pour la sortie html/pdf.
formatquery: json|html|pdfoptionnelFormat de la réponse. Par défaut json.

Exemple

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

Lancez un bot dans Zoom, Meet ou Teams. Retourne bot_id et sid : interrogez la transcription en direct, puis rendez les minutes lorsque l'appel se termine.

Auth. Envoyez votre clé API Loqal comme Authorization: Bearer mk_live_…. Dans le navigateur, le cookie de session connecté est utilisé automatiquement.

Requête

meeting_urlstringobligatoireLien Google Meet / Zoom / Teams.
modestringoptionnelconference | bilingual | monolingual. Default conference.
user_languagestringoptionnelDeuxième langue pour le mode bilingue (interprète).
avatar_idstringoptionnelAvatar à rendre, de GET /api/app/meet/characters.

Exemple

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

Téléchargez une leçon audio/vidéo. La transcrit, puis extrait un résumé, des glossaires et des questions de compréhension en user_language.

Auth. Envoyez votre clé API Loqal comme Authorization: Bearer mk_live_…. Dans le navigateur, le cookie de session connecté est utilisé automatiquement.

Requête

mediafileobligatoireLeçon audio ou vidéo.
user_languagestringoptionnelLangue de support pour les glossaires/questions. Par défaut en.
glosses_onlybooleanoptionnelRetourner uniquement les glossaires, en sautant les questions.

Exemple

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

Retourne un jeton LiveKit et une URL pour connecter un client à un agent avatar en direct. Listez d'abord les avatars avec GET /api/app/voqal/avatars.

Auth. Envoyez votre clé API Loqal comme Authorization: Bearer mk_live_…. Dans le navigateur, le cookie de session connecté est utilisé automatiquement.

Requête

avatar_idstringobligatoireUUID de l'avatar de GET /api/app/voqal/avatars.
languagestringoptionnelLangue parlée. Par défaut en.
namestringoptionnelNom d'affichage du participant à la session.

Exemple

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

Prochaines étapes