Voices

GET /voices

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

Response

{
  "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

curl https://api.nineninesix.ai/voices \
  -H "Authorization: Bearer sk_996_your_api_key"

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);
}

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.

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

The language field must be a well-formed BCP-47 tag — send the full dialect (en-US, en-GB, es-MX, pt-BR, nl-NL) since dialect tags drive per-language behavior. The value is canonicalized on save (en-us → en-US). A malformed tag (en_US, en-USA, english_, 123) is rejected with invalid_language (400):

{ "error": "invalid_language", "message": "language must be a BCP-47 tag like \"en-US\"; got \"en_US\"" }

Choosing a Voice

Browse and preview voices in the Playground before integrating them. Pass the voice id in the voice field:

{ "voice": { "mode": "id", "id": "<voice-id>" } }

Getting Started

Guides

Resources

GET /voices

Response

Example

GET `/voices/{id}`

DELETE `/voices/{id}`

POST /voices/clone

Choosing a Voice

​GET /voices

​Response

​Example

​GET /voices/{id}

​DELETE /voices/{id}

​POST /voices/clone

​Choosing a Voice

GET /voices

Response

Example

GET `/voices/{id}`

DELETE `/voices/{id}`

POST /voices/clone

Choosing a Voice