API Reference

Overview & Base URLs

Shunya TTS exposes three endpoints: batch HTTP synthesis, streaming WebSocket synthesis, and a health check.


Base URLs

ENDPOINTURLPROTOCOL
Batch HTTPhttps://tts.shunyalabs.aiHTTPS
Streaming WSwss://tts.shunyalabs.ai/wsWebSocket (WSS)
Health Checkhttps://tts.shunyalabs.ai/healthHTTPS

Notes

  • All endpoints require TLS. Plain HTTP and WS connections are rejected.
  • The batch endpoint accepts POST /v1/audio/speech with a JSON body.
  • The WebSocket endpoint accepts a query parameter for authentication and JSON frames for configuration and text.
  • The health check requires no authentication and returns the server status.