CAcartesia
Voices

Clone Voice

post/voices/clone

Request

Headers

Cartesia-Version'2026-03-01' date required
Example:2026-03-01

API version header.

Request body multipart/form-data

clipstring binary required

See Clone Voices for guidance on choosing a clip.

Supported audio formats: flac, mp3, mpeg, mpga, oga, ogg, wav, webm

namestring required

The name of the voice.

taglinestring

A few words describing the voice. At most 32 characters.

descriptionstring nullable

A description for the voice, typically longer than the tagline if both are provided.

language'en' | 'fr' | 'de' | 'es' | 'pt' | 'zh' | 'ja' | 'hi' | 'it' | 'ko' | 'nl' | 'pl' | 'ru' | 'sv' | 'tr' | 'tl' | 'bg' | 'ro' | 'ar' | 'cs' | 'el' | 'fi' | 'hr' | 'ms' | 'sk' | 'da' | 'ta' | 'uk' | 'hu' | 'no' | 'vi' | 'bn' | 'th' | 'he' | 'ka' | 'id' | 'te' | 'gu' | 'kn' | 'ml' | 'mr' | 'pa' required

The language that the given voice should speak the transcript in. This may depend on the model you're using. See Models for details.

base_voice_idstring

The ID of the voice. Find one in the Voice Library or via List Voices.

access[type]'private' | 'public'
  • private: only your organization can use the voice
  • public: anyone can use the voice

Response

idstring required

The ID of the voice. Find one in the Voice Library or via List Voices.

namestring required

The name of the voice.

taglinestring required

A few words describing the voice.

descriptionstring required

A description for the voice, typically longer than the tagline if both are provided.

created_atstring date-time required

The date and time the voice was created.

languagestring required

The voice's language, as an ISO 639-1 code (e.g. en, fr, zh)

is_publicboolean required

Whether the voice is publicly accessible. Always false on this endpoint.

user_idstring required

The ID of the user who owns the voice.

Example response

{
  "id": "f161df88-b5a0-4ea8-aa21-6be12859f761",
  "access": {
    "type": "private",
    "visibility": "owner"
  },
  "name": "My localized voice",
  "tagline": "",
  "description": "A voice that I localized",
  "created_at": "2026-01-01T00:00:00.000Z",
  "language": "en",
  "is_public": false,
  "user_id": "org_123"
}

Changes

No recorded changes to this operation across all 1 revision of this API.