Saltar al contenido principal
POST
/
api
/
v1
/
llm
/
speech
/
livekit
/
token
Python (SDK)
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)
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "url": "wss://apigw.mka1.com/api/v1/livekit",
  "roomName": "550e8400-e29b-41d4-a716-446655440000"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mka1.com/llms.txt

Use this file to discover all available pages before exploring further.

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 y opciones de configuración de STT.

​
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).

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)

​
roomName
string
requerido

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