Made in 10Docs
GuidesAPI
ReferenceCloned voices

Get a cloned voice

One cloned voice, with the characters that speak with it and its consent record.

GET
/voices/{clone_id}

Authorization

secretKey
headerAuthorizationBearer <sk_live_… or sk_test_… (a prefix and 40 base62 characters)>

A secret key from the dashboard, sent as Authorization: Bearer sk_live_…. Live keys run real, charged calls; test keys (sk_test_…) run calls of at most 60 seconds, 20 a day per organization, never charged. Each key sees only its own env's calls, meetings, webhooks, memories and analytics. Publishable keys (pk_…) are refused.

Path Parameters

clone_id*string

The cloned voice's own id (vce_…, the catalog's clone_id), not the voice_id a character takes.

Match^vce_[0-9A-Za-z]{20}$
Example"vce_3Hq8Wm1ZxT6kRb9NcV4p"

Response Body

The voice.

application/json
  1. response

A voice of your organization's own.

Example
{  "id": "vce_3Hq8Wm1ZxT6kRb9NcV4p",  "voice_id": "c38kUX8pkfYO2kHyqfFy",  "name": "Hamid",  "description": "Calm, for support",  "labels": {    "accent": "Persian",    "gender": "male"  },  "status": "ready",  "error": null,  "samples": 2,  "character_ids": [    "chr_4fT9kQ2mXw7LbN3pZs8V"  ],  "consent": {    "version": "2026-11-05",    "by": "key_9Zc4Pw7NbT2xKm5RqL8v",    "email": "",    "at_unix": 1793300000  },  "created_unix": 1793300000,  "updated_unix": 1793300000}
id*ClonedVoiceId

A cloned voice's own id (its voice_id, what a character takes, is another).

Match^vce_[0-9A-Za-z]{20}$
Example"vce_3Hq8Wm1ZxT6kRb9NcV4p"
voice_id*|

What a character's voice_id takes; null until the voice is made.

name*string
Length1 <= length <= 80
description*string
Lengthlength <= 500
labels*

Words about the voice, each one line of at most 40 characters. Empty ones are dropped.

Example
{  "accent": "Persian",  "gender": "male"}
status*string

creating (for a moment, while it is made), ready, needs_verification (kept, but not offered to characters until it is verified), failed (cut off on our side: delete it and try again).

Value in"creating""ready""needs_verification""failed"
error*|

Why it failed, in our words.

samples*integer

How many recordings it was made from.

character_ids*array<>

The characters that speak with it.

consent*

The consent record.

created_unix*Unix

Unix seconds, UTC.

Formatint64
Example1793300000
updated_unix*Unix

Unix seconds, UTC.

Formatint64
Example1793300000
Example Request
curl -X GET 'https://api.daxov.com/v1/voices/vce_3Hq8Wm1ZxT6kRb9NcV4p'
Example Response
{  "id": "vce_3Hq8Wm1ZxT6kRb9NcV4p",  "voice_id": "c38kUX8pkfYO2kHyqfFy",  "name": "Hamid",  "description": "Calm, for support",  "labels": {    "accent": "Persian",    "gender": "male"  },  "status": "ready",  "error": null,  "samples": 2,  "character_ids": [    "chr_4fT9kQ2mXw7LbN3pZs8V"  ],  "consent": {    "version": "2026-11-05",    "by": "key_9Zc4Pw7NbT2xKm5RqL8v",    "email": "",    "at_unix": 1793300000  },  "created_unix": 1793300000,  "updated_unix": 1793300000}