Gerar token de sala LiveKit
Gera um token de acesso LiveKit para entrar em uma sala de voz em tempo real. O token inclui credenciais criptografadas e configuração de modelo para o agente de voz.
Autorizações
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>.
Cabeçalhos
Optional external end-user identifier forwarded by the API gateway.
Corpo
Parâmetros de solicitação para gerar um token de sala LiveKit com configuração de LLM, configurações opcionais de STT e idioma opcional.
Configuração do LLM para a sessão de voz. Utiliza um subconjunto do esquema de criação de respostas — campos como entrada, stream, fundo, webhooks e armazenamento estão excluídos, pois o agente de voz gerencia esses. AVISO: Este objeto é serializado nos metadados JWT do LiveKit, que são transmitidos através de cabeçalhos HTTP. Mantenha as cargas úteis pequenas — grandes arrays de ferramentas podem exceder o limite de tamanho de cabeçalho de ~8KB imposto pela maioria dos servidores e proxies.
Configuração opcional de VAD (detecção de atividade de voz) para STT (conversão de fala em texto).
Código de idioma ISO 639-1 opcional (por exemplo, 'en' ou 'uk') para a sessão de voz; deve ser um dos idiomas suportados por conversão de texto em fala. Incluído nos metadados do participante para que o agente de voz o use no reconhecimento e na síntese de fala, em vez de detectar automaticamente. Omitir para permitir que o agente detecte automaticamente.
en, zh, hi, es, ar, bn, pt, ru, ja, pa, de, ko, fr, tr, it, th, pl, nl, id, vi, ur, uk Resposta
OK
Resposta contendo um token de acesso LiveKit, URL do servidor e o nome da sala gerada.
Token de acesso JWT para autenticação com a sala LiveKit
URL do WebSocket do servidor LiveKit para conectar-se (por exemplo, wss://apigw.mka1.com/api/v1/livekit)
Nome da sala UUID gerado automaticamente atribuído a esta sessão