POST/api/app/voice200 OK · áudio/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"

Chame qualquer ferramenta Loqal a partir do seu próprio código.

Endpoints REST para clonagem de voz, tradução, transcrição e agentes de reunião, além de avatares em tempo real no LiveKit.

Sete ferramentas, uma chave

Cada ferramenta no Studio também é um endpoint REST. Mesma autenticação, mesma conta, mesma chave.

API

POST/api/app/fm/generate

Coloca na fila um episódio único LoqalFM. Retorna um jobId imediatamente: faça polling em GET /api/app/fm/jobs/{jobId} até status=completed, depois baixe o áudio.

Autenticação. Envie sua chave de API Loqal como Authorization: Bearer mk_live_…. No navegador, o cookie de sessão autenticada é usado automaticamente.

Solicitação

genrestringobrigatórioFormato de transmissão: anúncio, entrevista, clima, tráfego, chamada, psa, talkshow, boletim de notícias.
languagestringopcionalIdioma de transmissão BCP-47. Padrão en-US.
world_infostringopcionalTópico / semente mundial. Deixe em branco para uma surpresa.
durationnumberopcionalSubstitua o comprimento padrão do formato (segundos).

Exemplo

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 uma voz a partir de uma amostra de áudio e sintetiza texto nela, opcionalmente traduzindo primeiro. Passe voice_id para reutilizar um clone existente.

Autenticação. Envie sua chave de API Loqal como Authorization: Bearer mk_live_…. No navegador, o cookie de sessão autenticada é usado automaticamente.

Solicitação

audiofileopcionalExemplo de voz (omitir ao reutilizar voice_id).
textstringobrigatórioO que a voz clonada deve dizer.
target_languagestringopcionalIdioma de saída, por exemplo, es-ES. Padrão en-US.
translatebooleanopcionalTraduzir texto para target_language antes da síntese.
voice_idstringopcionalReutilize um clone de uma chamada anterior.

Exemplo

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

Envie um clipe falado curto e um idioma alvo. Receba de volta a transcrição, tradução e fala sintetizada em uma resposta.

Autenticação. Envie sua chave de API Loqal como Authorization: Bearer mk_live_…. No navegador, o cookie de sessão autenticada é usado automaticamente.

Solicitação

audiofileobrigatórioGravação falada curta.
target_langstringobrigatórioIdioma alvo BCP-47, por exemplo, es-ES.

Exemplo

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

Envie uma gravação e receba de volta um JSON de transcrição, ou um documento HTML/PDF estilizado definindo o parâmetro de formato.

Autenticação. Envie sua chave de API Loqal como Authorization: Bearer mk_live_…. No navegador, o cookie de sessão autenticada é usado automaticamente.

Solicitação

audiofileobrigatórioArquivo de áudio ou vídeo.
targetstringopcionalIdioma de saída BCP-47 para tradução. Padrão en.
titlestringopcionalTítulo do documento para saída em html/pdf.
formatquery: json|html|pdfopcionalFormato da resposta. Padrão json.

Exemplo

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

Lance um bot no Zoom, Meet ou Teams. Retorna bot_id e sid: faça polling na transcrição ao vivo, depois renderize as atas quando a chamada terminar.

Autenticação. Envie sua chave de API Loqal como Authorization: Bearer mk_live_…. No navegador, o cookie de sessão autenticada é usado automaticamente.

Solicitação

meeting_urlstringobrigatórioLink do Google Meet / Zoom / Teams.
modestringopcionalconference | bilingual | monolingual. Default conference.
user_languagestringopcionalSegundo idioma para modo bilíngue (intérprete).
avatar_idstringopcionalAvatar para renderizar, de GET /api/app/meet/characters.

Exemplo

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

Carregue uma lição de áudio/vídeo. Transcreve, depois extrai um resumo, glossário e perguntas de compreensão em user_language.

Autenticação. Envie sua chave de API Loqal como Authorization: Bearer mk_live_…. No navegador, o cookie de sessão autenticada é usado automaticamente.

Solicitação

mediafileobrigatórioLição de áudio ou vídeo.
user_languagestringopcionalIdioma de suporte para glossários/perguntas. Padrão en.
glosses_onlybooleanopcionalRetornar apenas glossários, pulando perguntas.

Exemplo

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

Retorna um token LiveKit e URL para conectar um cliente a um agente de avatar ao vivo. Liste os avatares primeiro com GET /api/app/voqal/avatars.

Autenticação. Envie sua chave de API Loqal como Authorization: Bearer mk_live_…. No navegador, o cookie de sessão autenticada é usado automaticamente.

Solicitação

avatar_idstringobrigatórioUUID do avatar de GET /api/app/voqal/avatars.
languagestringopcionalIdioma falado. Padrão en.
namestringopcionalNome de exibição para o participante da sessão.

Exemplo

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

Próximos passos