Pular para o conteúdo 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.

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 LLM e configurações opcionais de STT.

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

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)

​
roomName
string
obrigatório

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