Skip to main content
POST
/
voices
/
mix
Mix Voices
curl --request POST \
  --url https://api.cartesia.ai/voices/mix \
  --header 'Cartesia-Version: <cartesia-version>' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "voices": [
    {
      "id": "<string>",
      "weight": 123
    }
  ]
}
'
{
  "embedding": [
    123
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint is deprecated! Voices created using this endpoint will not work after June 1, 2026. Please migrate to the Clone Voice endpoint instead. Reach out to support@cartesia.ai if you have any questions.

Authorizations

X-API-Key
string
header
required

Headers

Cartesia-Version
enum<string>
required

API version header.

Available options:
2024-06-10,
2024-11-13,
2025-04-16,
2026-03-01
Example:

"2024-11-13"

Body

application/json
voices
(IdSpecifier · object | EmbeddingSpecifier · object)[]
required

Response

200 - application/json
embedding
number<double>[]
required

A 192-dimensional vector (i.e. a list of 192 numbers) that represents the voice.