Skip to main content

Visão geral

Este endpoint é usado para reconhecimento de fala, síntese de fala, tradução de fala ou modelos multimodais em tempo real. Um GET comum retorna metadados; o upgrade WebSocket é proxificado para a sessão upstream roteada.

Superfície compatível

Este endpoint é o proxy WebSocket em tempo real do TokenLab. Ele aceita uma verificação de metadados com GET /v1/realtime e upgrades WebSocket no mesmo caminho. Ele não expõe endpoints auxiliares REST do OpenAI Realtime, como POST /v1/realtime/client_secrets, POST /v1/realtime/translations/client_secrets, Realtime Calls (accept, hangup, refer, reject) nem criação de legacy beta REST session / transcription-session. Em apps web ou móveis, mantenha chaves API de longa duração no seu servidor. Este endpoint não emite Realtime client secrets de curta duração.
Agentes devem descobrir modelos com suporte a realtime em /v1/models antes de abrir o socket.

Conexão

string
obrigatório
ID do modelo em tempo real. Use um modelo cujo detalhes do modelo liste suporte a realtime.
string
obrigatório
Chave API Bearer. Clientes WebSocket devem enviar Authorization: Bearer sk-your-api-key na requisição de upgrade.

Mensagens

TokenLab encaminha mensagens WebSocket entre o cliente e o provedor realtime roteado. Preserve os eventos oficiais do modelo selecionado e passe model na query string.

Cobrança e encerramento

Sessões realtime usam o mesmo saldo da chave API. TokenLab pré-deduz uma pequena estimativa ao abrir e liquida ou reembolsa ao fechar. Feche o socket do cliente quando a sessão terminar. Se o upstream fechar primeiro, TokenLab repassa o código de fechamento quando possível.

Exemplo de resposta

Campos importantes

string
Tipo de evento ou mensagem retornado pela API.
string
Identificador emitido pelo provedor realtime; inclua-o em logs de suporte, não como URL de sessão REST.