Skip to main content
POST
Typescript (SDK)

Autorizações

Authorization
string
header
obrigatório

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

X-On-Behalf-Of
string

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

Corpo

application/json

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.

llm
object
obrigatório

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.

stt
object

Configuração opcional de VAD (detecção de atividade de voz) para STT (conversão de fala em texto).

language
enum<string>

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.

Opções disponíveis:
en,
zh,
hi,
es,
ar,
bn,
pt,
ru,
ja,
pa,
de,
ko,
fr,
tr,
it,
th,
pl,
nl,
id,
vi,
ur,
uk

Resposta

200 - application/json

OK

Resposta contendo um token de acesso LiveKit, URL do servidor e o nome da sala gerada.

token
string
obrigatório

Token de acesso JWT para autenticação com a sala LiveKit

url
string<uri>
obrigatório

URL do WebSocket do servidor LiveKit para conectar-se (por exemplo, wss://apigw.mka1.com/api/v1/livekit)

room_name
string
obrigatório

Nome da sala UUID gerado automaticamente atribuído a esta sessão