Generate LiveKit room token
Generates a LiveKit access token for joining a real-time voice room. The token includes encrypted credentials and model configuration for the voice agent.
Authorizations
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>.
Headers
Optional external end-user identifier forwarded by the API gateway.
Body
Request parameters for generating a LiveKit room token with LLM configuration, optional STT settings, and optional language.
LLM configuration for the voice session. Uses a subset of the responses create schema — fields like input, stream, background, webhooks, and store are excluded since the voice agent manages those. WARNING: This object is serialized into the LiveKit JWT metadata which is transmitted via HTTP headers. Keep payloads small — large tools arrays can exceed the ~8KB header size limit imposed by most servers and proxies.
Optional STT (speech-to-text) VAD configuration.
Optional ISO 639-1 language code (for example 'en' or 'uk') for the voice session; must be one of the languages supported by text-to-speech. Carried in the participant metadata so the voice agent uses it for speech recognition and synthesis instead of auto-detecting. Omit to let the agent auto-detect.
en, zh, hi, es, ar, bn, pt, ru, ja, pa, de, ko, fr, tr, it, th, pl, nl, id, vi, ur, uk Response
OK
Response containing a LiveKit access token, server URL, and the generated room name.