Desarrolladores | API Loqal

Siete herramientas, una clave

Cada herramienta en el Studio también es un punto final REST. Misma autenticación, misma cuenta, misma clave.

API

POST/api/app/fm/generate

Coloca en cola un episodio único LoqalFM. Devuelve un jobId inmediatamente: consulta GET /api/app/fm/jobs/{jobId} hasta que status=completed, luego descarga el audio.

Autenticación. Envía tu clave API de Loqal como Authorization: Bearer mk_live_…. En el navegador, la cookie de sesión iniciada se usa automáticamente.

Solicitud

genre	string	requerido	Formato de transmisión: anuncio, entrevista, clima, tráfico, llamada, psa, programa de entrevistas, boletín de noticias.
language	string	opcional	Idioma de transmisión BCP-47. Predeterminado en-US.
world_info	string	opcional	Tema / semilla mundial. Deja en blanco para una sorpresa.
duration	number	opcional	Anula la longitud predeterminada del formato (segundos).

Ejemplo

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 voz a partir de una muestra de audio y sintetiza texto en ella, opcionalmente traduciendo primero. Pasa voice_id para reutilizar un clon existente.

Autenticación. Envía tu clave API de Loqal como Authorization: Bearer mk_live_…. En el navegador, la cookie de sesión iniciada se usa automáticamente.

Solicitud

audio	file	opcional	Muestra de voz (omitir al reutilizar voice_id).
text	string	requerido	Lo que la voz clonada debería decir.
target_language	string	opcional	Idioma de salida, por ejemplo, es-ES. Predeterminado en-US.
translate	boolean	opcional	Traducir texto a target_language antes de la síntesis.
voice_id	string	opcional	Reutilizar un clon de una llamada anterior.

Ejemplo

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

Envía un clip corto hablado y un idioma objetivo. Recibe de vuelta la transcripción, traducción y habla sintetizada en una respuesta.

Autenticación. Envía tu clave API de Loqal como Authorization: Bearer mk_live_…. En el navegador, la cookie de sesión iniciada se usa automáticamente.

Solicitud

audio	file	requerido	Grabación corta hablada.
target_lang	string	requerido	Idioma objetivo BCP-47, por ejemplo, es-ES.

Ejemplo

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

Sube una grabación y recibe un JSON de transcripción, o un documento HTML/PDF estilizado configurando el parámetro de formato.

Autenticación. Envía tu clave API de Loqal como Authorization: Bearer mk_live_…. En el navegador, la cookie de sesión iniciada se usa automáticamente.

Solicitud

audio	file	requerido	Archivo de audio o video.
target	string	opcional	Idioma de salida BCP-47 para la traducción. Predeterminado en.
title	string	opcional	Título del documento para salida en html/pdf.
format	query: json\|html\|pdf	opcional	Formato de respuesta. Predeterminado json.

Ejemplo

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

Lanza un bot en Zoom, Meet o Teams. Devuelve bot_id y sid: consulta la transcripción en vivo, luego renderiza las actas cuando termine la llamada.

Autenticación. Envía tu clave API de Loqal como Authorization: Bearer mk_live_…. En el navegador, la cookie de sesión iniciada se usa automáticamente.

Solicitud

meeting_url	string	requerido	Enlace de Google Meet / Zoom / Teams.
mode	string	opcional	conference \| bilingual \| monolingual. Default conference.
user_language	string	opcional	Segundo idioma para modo bilingüe (intérprete).
avatar_id	string	opcional	Avatar para renderizar, de GET /api/app/meet/characters.

Ejemplo

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

Sube una lección de audio/vídeo. La transcribe, luego extrae un resumen, glosas y preguntas de comprensión en user_language.

Autenticación. Envía tu clave API de Loqal como Authorization: Bearer mk_live_…. En el navegador, la cookie de sesión iniciada se usa automáticamente.

Solicitud

media	file	requerido	Lección de audio o vídeo.
user_language	string	opcional	Idioma de soporte para glosarios/preguntas. Predeterminado en.
glosses_only	boolean	opcional	Devolver solo glosarios, omitiendo preguntas.

Ejemplo

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

Devuelve un token de LiveKit y una URL para conectar un cliente a un agente de avatar en vivo. Lista primero los avatares con GET /api/app/voqal/avatars.

Autenticación. Envía tu clave API de Loqal como Authorization: Bearer mk_live_…. En el navegador, la cookie de sesión iniciada se usa automáticamente.

Solicitud

avatar_id	string	requerido	UUID del avatar de GET /api/app/voqal/avatars.
language	string	opcional	Idioma hablado. Predeterminado en.
name	string	opcional	Nombre para mostrar del participante de la sesión.

Ejemplo

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

Llama a cualquier herramienta Loqal desde tu propio código.

Siete herramientas, una clave

API

Solicitud

Ejemplo

API

Solicitud

Ejemplo

API

Solicitud

Ejemplo

API

Solicitud

Ejemplo

API

Solicitud

Ejemplo

API

Solicitud

Ejemplo

API

Solicitud

Ejemplo

Próximos pasos

Obtén una clave API

Especificación OpenAPI

Habla con nosotros