# API reference

Every endpoint, grouped by API. REST routes are under `https://api.dotwave.ai/v1`; each WebSocket, under `wss://api.dotwave.ai/v1`, links to its protocol pages.

## Live API

Full-duplex speech to speech. [Overview](https://dotwave.ai/docs/live/) · [Client events](https://dotwave.ai/docs/live/client-events/) · [Server events](https://dotwave.ai/docs/live/server-events/)

- `POST /v1/live/client_secrets`: [Create a client secret](https://dotwave.ai/docs/live/client-secrets/)
- `WSS /v1/live/sessions`: [Session socket](https://dotwave.ai/docs/live/websocket/)

## Realtime API

Streaming transcription in the OpenAI Realtime format. [Overview](https://dotwave.ai/docs/realtime/) · [Client events](https://dotwave.ai/docs/realtime/client-events/) · [Server events](https://dotwave.ai/docs/realtime/server-events/)

- `POST /v1/realtime/client_secrets`: [Create a client secret](https://dotwave.ai/docs/realtime/client-secrets/)
- `WSS /v1/realtime`: [Transcription socket](https://dotwave.ai/docs/realtime/websocket/)

## Deepgram-compatible API

Streaming transcription for Deepgram clients. [Overview](https://dotwave.ai/docs/deepgram/) · [Parameters](https://dotwave.ai/docs/deepgram/parameters/) · [Messages](https://dotwave.ai/docs/deepgram/messages/)

- `WSS /v1/listen`: [Transcription socket](https://dotwave.ai/docs/deepgram/)

## Models, sessions and usage

For every API. Authenticate with your API key; see [Authentication](https://dotwave.ai/docs/authentication/) and [Errors](https://dotwave.ai/docs/errors/).

JavaScript is required to render the REST routes. The OpenAPI document is available at [openapi.json](https://dotwave.ai/docs/api/openapi.json).