Skip to main content
PATCH
/
api
/
v1
/
voice
/
clone
/
{voiceId}
Update cloned voice
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>', description: '<string>', language: '<string>', labels: {}})
};

fetch('https://blackbox.dasha.ai/api/v1/voice/clone/{voiceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "<string>",
  "provider": "<string>",
  "category": "Public",
  "name": "<string>",
  "voiceId": "<string>",
  "description": "<string>",
  "language": "<string>",
  "labels": {},
  "previewUrl": "<string>",
  "createdTime": "2023-11-07T05:31:56Z",
  "lastUpdatedTime": "2023-11-07T05:31:56Z"
}

Updatable Fields

  • Name: Voice identifier for display
  • Description: Voice characteristics and usage notes
  • Language: Primary language setting
  • Labels: Custom metadata tags
The actual voice model and audio characteristics cannot be changed. Only metadata can be updated.

Path Parameters

voiceId
string
required

Voice identifier

Body

Fields to update

Partial update request for voice metadata

name
string | null

Updated display name for the voice

Required string length: 1 - 100
description
string | null

Updated description of voice characteristics and intended use

Required string length: 1 - 1000
language
string | null

Updated primary language for the voice model

labels
object

Updated custom metadata labels for categorizing and organizing voices

Response

Cloned voice updated successfully

Response DTO for TTS voice cloning operations

id
string
required

Unique identifier for the voice

Minimum string length: 1
provider
string
required

TTS provider used for this voice. Supported providers: ElevenLabs, Cartesia, Lmnt.

Minimum string length: 1
category
enum<string>
required

Voice category. Public voices are provided by the TTS provider, Cloned voices are custom voices created through voice cloning.

Available options:
Public,
Cloned
name
string | null

Display name of the voice

voiceId
string | null

Voice ID used for synthesis

description
string | null

Description of voice characteristics

language
string | null

Primary language for the voice

labels
object

Custom metadata labels

previewUrl
string | null

URL for voice preview audio

createdTime
string<date-time> | null

Timestamp when voice was created

lastUpdatedTime
string<date-time> | null

Timestamp when voice was last updated