Visão geral
Este endpoint é usado para reconhecimento de fala, síntese de fala, tradução de fala ou modelos multimodais em tempo real. UmGET 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 comGET /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 passemodel 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.