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"

Chiama qualsiasi strumento Loqal dal tuo codice.

Endpoint REST per clonazione vocale, traduzione, trascrizione e agenti di riunione, oltre ad avatar in tempo reale su LiveKit.

Sette strumenti, una chiave

Ogni strumento nello Studio è anche un endpoint REST. Stessa autenticazione, stesso account, stessa chiave.

API

POST/api/app/fm/generate

Mette in coda un episodio unico LoqalFM. Restituisce immediatamente un jobId: interroga GET /api/app/fm/jobs/{jobId} fino a status=completed, quindi scarica l'audio.

Autenticazione. Invia la tua chiave API Loqal come Authorization: Bearer mk_live_…. Nel browser viene utilizzato automaticamente il cookie di sessione connesso.

Richiesta

genrestringrichiestoFormato di trasmissione: annuncio, intervista, meteo, traffico, chiamata, psa, talkshow, flash di notizie.
languagestringopzionaleLingua di trasmissione BCP-47. Predefinito en-US.
world_infostringopzionaleArgomento / seme mondiale. Lascia vuoto per una sorpresa.
durationnumberopzionaleSostituisci la lunghezza predefinita del formato (secondi).

Esempio

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

Clona una voce da un campione audio e sintetizza il testo in essa, eventualmente traducendo prima. Passa voice_id per riutilizzare un clone esistente.

Autenticazione. Invia la tua chiave API Loqal come Authorization: Bearer mk_live_…. Nel browser viene utilizzato automaticamente il cookie di sessione connesso.

Richiesta

audiofileopzionaleCampione di voce (ometti quando riutilizzi voice_id).
textstringrichiestoCosa dovrebbe dire la voce clonata.
target_languagestringopzionaleLingua di output, ad esempio, es-ES. Predefinito en-US.
translatebooleanopzionaleTraduci il testo in target_language prima della sintesi.
voice_idstringopzionaleRiutilizza un clone da una chiamata precedente.

Esempio

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

Invia un breve clip parlato e una lingua di destinazione. Ricevi indietro la trascrizione, la traduzione e il discorso sintetizzato in una risposta.

Autenticazione. Invia la tua chiave API Loqal come Authorization: Bearer mk_live_…. Nel browser viene utilizzato automaticamente il cookie di sessione connesso.

Richiesta

audiofilerichiestoRegistrazione parlata breve.
target_langstringrichiestoLingua di destinazione BCP-47, ad esempio, es-ES.

Esempio

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

Carica una registrazione e ricevi un JSON di trascrizione, o un documento HTML/PDF stilizzato impostando il parametro di formato.

Autenticazione. Invia la tua chiave API Loqal come Authorization: Bearer mk_live_…. Nel browser viene utilizzato automaticamente il cookie di sessione connesso.

Richiesta

audiofilerichiestoFile audio o video.
targetstringopzionaleLingua di output BCP-47 per la traduzione. Predefinito en.
titlestringopzionaleTitolo del documento per output html/pdf.
formatquery: json|html|pdfopzionaleFormato della risposta. Predefinito json.

Esempio

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

Lancia un bot in Zoom, Meet o Teams. Restituisce bot_id e sid: interroga la trascrizione dal vivo, quindi rendi i verbali quando la chiamata termina.

Autenticazione. Invia la tua chiave API Loqal come Authorization: Bearer mk_live_…. Nel browser viene utilizzato automaticamente il cookie di sessione connesso.

Richiesta

meeting_urlstringrichiestoLink di Google Meet / Zoom / Teams.
modestringopzionaleconference | bilingual | monolingual. Default conference.
user_languagestringopzionaleSeconda lingua per modalità bilingue (interprete).
avatar_idstringopzionaleAvatar da rendere, da GET /api/app/meet/characters.

Esempio

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

Carica una lezione audio/video. La trascrive, quindi estrae un riassunto, glossari e domande di comprensione in user_language.

Autenticazione. Invia la tua chiave API Loqal come Authorization: Bearer mk_live_…. Nel browser viene utilizzato automaticamente il cookie di sessione connesso.

Richiesta

mediafilerichiestoLezione audio o video.
user_languagestringopzionaleLingua di supporto per glossari/domande. Predefinito en.
glosses_onlybooleanopzionaleRestituisci solo glossari, saltando le domande.

Esempio

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

Restituisce un token LiveKit e un URL per connettere un client a un agente avatar dal vivo. Elenca prima gli avatar con GET /api/app/voqal/avatars.

Autenticazione. Invia la tua chiave API Loqal come Authorization: Bearer mk_live_…. Nel browser viene utilizzato automaticamente il cookie di sessione connesso.

Richiesta

avatar_idstringrichiestoUUID dell'avatar da GET /api/app/voqal/avatars.
languagestringopzionaleLingua parlata. Predefinito en.
namestringopzionaleNome visualizzato per il partecipante alla sessione.

Esempio

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

Prossimi passi