Skip to main content
POST
Typescript (SDK)

Autorizaciones

Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Encabezados

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Cuerpo

application/json

Parámetros de solicitud para generar un token de sala de LiveKit con configuración de LLM, ajustes opcionales de STT y un idioma opcional.

llm
object
requerido

Configuración de LLM para la sesión de voz. Utiliza un subconjunto del esquema de respuestas creado: se excluyen campos como entrada, flujo, fondo, webhooks y almacenamiento, ya que el agente de voz gestiona esos. ADVERTENCIA: Este objeto se serializa en los metadatos JWT de LiveKit, que se transmiten a través de encabezados HTTP. Mantenga las cargas pequeñas: los arrays de herramientas grandes pueden exceder el límite de tamaño de encabezado de ~8KB impuesto por la mayoría de los servidores y proxies.

stt
object

Configuración opcional de VAD (detección de voz) para STT (conversión de voz a texto).

language
enum<string>

Código de idioma ISO 639-1 opcional (por ejemplo, 'en' o 'uk') para la sesión de voz; debe ser uno de los idiomas compatibles con la conversión de texto a voz. Se incluye en los metadatos del participante para que el agente de voz lo use para el reconocimiento y la síntesis de voz en lugar de la detección automática. Omítalo para permitir que el agente lo detecte automáticamente.

Opciones disponibles:
en,
zh,
hi,
es,
ar,
bn,
pt,
ru,
ja,
pa,
de,
ko,
fr,
tr,
it,
th,
pl,
nl,
id,
vi,
ur,
uk

Respuesta

200 - application/json

Está bien

Respuesta que contiene un token de acceso de LiveKit, URL del servidor y el nombre de la sala generada.

token
string
requerido

Token de acceso JWT para autenticarte con la sala de LiveKit

url
string<uri>
requerido

URL de WebSocket del servidor LiveKit para conectar (por ejemplo, wss://apigw.mka1.com/api/v1/livekit)

room_name
string
requerido

Nombre de sala UUID generado automáticamente asignado a esta sesión