# API reference

Every endpoint, with links to the page that documents it.

Every endpoint, with links to the page that documents it in full. The live OpenAPI spec is at `https://api.kenpathlabs.com/openapi.json`.

## Speech

```http
POST /v1/audio/speech
```

Primary TTS: text in, audio out; set `stream` for a chunked response. See [Text to speech](https://docs.kenpathlabs.com/text-to-speech.md).

```http
POST /v1/text-to-speech/{voice_id}
```

```http
POST /v1/text-to-speech/{voice_id}/stream
```

```http
POST /v1/text-to-speech/{voice_id}/with-timestamps
```

ElevenLabs-compatible synthesis, incl. streaming and character timestamps. `output_format` like `mp3_44100_128`, `pcm_24000`. See [SDKs](https://docs.kenpathlabs.com/sdks.md).

## WebSocket

```http
WS /v1/audio/speech/stream-input
```

Native input streaming with `mode=eager`. Send text fragments, receive PCM. See [Input streaming](https://docs.kenpathlabs.com/input-streaming.md).

```http
WS /v1/text-to-speech/{voice_id}/stream-input
```

ElevenLabs-compatible realtime WebSocket (BOS/text/flush/EOS protocol).

## Voices

```http
GET /v1/voices
```

```http
GET /v2/voices
```

```http
GET /v1/voices/{voice_id}
```

```http
GET /v1/voices/{voice_id}/preview
```

Roster, search/paging, single voice, and bundled preview clip.

```http
GET /v1/voices/{voice_id}/settings
```

Stub for ElevenLabs SDK compatibility: returns permissive defaults so client flows that read voice settings don’t break.

## Utility

```http
GET /health
```

Capability negotiation: `engine`, `stream_formats`, `default_voice`. No auth.

```http
GET /v1/languages
```

```http
GET /v1/models
```

Supported languages and models. No auth.

```http
GET /v1/usage
```

```http
GET /v1/user/subscription
```

Your plan, balance and month-to-date usage — the second is the ElevenLabs-shaped dialect. See [Usage & subscription](https://docs.kenpathlabs.com/usage-api.md).