> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nineninesix.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Voices

> List, fetch, and clone voices for text-to-speech generation.

## GET /voices

Returns the voices available to your organization (the shared library plus any you've cloned). The list is paginated.

### Response

```json theme={null}
{
  "data": [
    {
      "id": "a0e99841-438c-4a64-b679-ae501e7d6091",
      "name": "Barbershop Man",
      "description": "A friendly, conversational voice",
      "language": "en"
    }
  ],
  "has_more": false,
  "next_page": null
}
```

`language` is a BCP-47 tag. Most voices use a base code like `en`, but some are region-specific — for example, Dutch voices are tagged `nl-NL`. Match on the full tag (and filter with `?language=nl-NL`), not just the base subtag.

### Example

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.nineninesix.ai/voices \
    -H "Authorization: Bearer sk_996_your_api_key"
  ```

  ```typescript Node.js theme={null}
  import { Cartesia } from "@cartesia/cartesia-js";

  const client = new Cartesia({ apiKey: "sk_996_your_api_key", baseURL: "https://api.nineninesix.ai" });

  for await (const voice of client.voices.list({ limit: 100 })) {
    console.log(voice.id, voice.name);
  }
  ```
</CodeGroup>

## GET `/voices/{id}`

Fetch metadata for a single voice.

## DELETE `/voices/{id}`

Remove a cloned voice you own.

## POST /voices/clone

Clone a voice from a reference audio sample (multipart upload). Use the returned voice `id` in your `/tts/bytes` and `/tts/websocket` requests.

```typescript theme={null}
const voice = await client.voices.clone({
  name: "My Voice",
  // see the Cartesia SDK for the full clone parameters (audio file, language, etc.)
});
```

## Choosing a Voice

Browse and preview voices in the [Playground](https://nineninesix.ai/playground) before integrating them. Pass the voice `id` in the `voice` field:

```json theme={null}
{ "voice": { "mode": "id", "id": "<voice-id>" } }
```