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.

POST /api/v1/llm/speech/livekit/token

Python (SDK)

Python

from mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.speech.livekit_token(llm={
        "model": "auto",
    })

    # Handle response
    print(res)

200

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "url": "wss://apigw.mka1.com/api/v1/livekit",
  "roomName": "550e8400-e29b-41d4-a716-446655440000"
}

Authorizations

Authorization · string · header · required

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

X-On-Behalf-Of · string

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

Body

application/json

Request parameters for generating a LiveKit room token with LLM configuration and optional STT settings.

llm · object · required

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.

Show child attributes

stt · object

Optional STT (speech-to-text) VAD configuration.

Show child attributes

Response

200 - application/json

OK

Response containing a LiveKit access token, server URL, and the generated room name.

token · string · required

JWT access token for authenticating with the LiveKit room

url · string<uri> · required

LiveKit server WebSocket URL to connect to (e.g., wss://apigw.mka1.com/api/v1/livekit)

roomName · string · required

Auto-generated UUID room name assigned to this session