Logo de Teddies AITeddies AI
Endpoint WebSocket

Envía audio y recibe texto del asistente en streaming.

El endpoint sigue recibiendo audio como paquetes Opus por /ws, pero ahora también puede devolver respuestas en texto cuando text_mode está activo. Usa la página separada del playground cuando quieras subir un archivo WAV u OGG y ver cómo llega el texto del asistente paso a paso.

WSSwss://test.teddies.ai/ws

Headers de conexión

product_id

Obligatorio. Identifica el producto registrado para la sesión.

firmware_id

Opcional en la implementación actual. Si falta, el servidor usa su valor por defecto.

text_mode

Usa true o 1 para recibir la respuesta del asistente como texto en vez de audio.

stream_text

Usa true o 1 junto con text_mode para recibir fragmentos de texto en streaming.

Nota para navegador

El objeto nativo WebSocket del navegador no puede enviar headers arbitrarios. La ruta del playground resuelve eso con un bridge del lado del servidor, mientras que este comando está pensado para pruebas directas en terminal contra test.teddies.ai.

CódigoCondición
1008Más de 5 intentos de conexión desde la misma IP en 60 segundos
4001Falta el header product_id
4002Producto desconocido, usuario o personaje faltante, error al actualizar firmware o error al inicializar TTS
4003El producto está bloqueado
Flujo de transporte

La entrada de audio no cambia. La salida ahora puede ser texto en streaming.

No envíes un archivo completo .wav o .ogg directamente al WebSocket. Decodifica el archivo en el cliente o en el bridge, codifica frames Opus de 20 ms, envíalos después de record y termina con stop. En modo texto, la respuesta del asistente llega como mensajes de texto entre play y stop.

ready

Devuelve onboarding y confirma que la sesión está activa.

record

Inicia una nueva grabación y guarda los siguientes paquetes Opus binarios.

stop

Termina la grabación, dispara la transcripción y luego comienza la salida de audio o texto.

Ajustes de audio

CódecOpus
Frecuencia de muestreo16000 Hz
Canales1 mono
Duración de frame20 ms
Muestras por frame320
Payload binario WebSocketUn paquete Opus

Mensajes del servidor

onboardingSe envía después de ready
playIndica que la salida está por comenzar
fragmento de textoMensajes de texto del asistente en text_mode con stream_text=true
respuesta completaUn único mensaje de texto del asistente en text_mode con stream_text=false
paquete Opus binarioFrame de audio solo en modo audio
stopLa salida terminó
interruptedLa reproducción actual fue cancelada por un nuevo comando record
errorFalló la reproducción de audio pregrabado
En modo texto, el flujo de la sesión es ready, record, frames Opus en streaming, stop, luego play, fragmentos de texto en streaming y finalmente stop.