Get a voice

GET

/v1/voices/{id}

Returns a saved or preset voice.

Authorization

bearer

headerAuthorizationBearer <API key>

An API key from Settings, starting vcp_live_.

Path Parameters

id*string

Response Body

OK.

application/json

response

id*string

A uuid for saved voices, or the preset id.

name*string

type*string

Value in"clone""design""preset"

model*|

The model a preset belongs to, or null for saved voices.

duration_seconds*|

Length of the reference clip, or null.

Range0 <= value

created_at*|

When the voice was saved, or null for presets.

Formatdate-time

Example Request

curl -X GET 'https://api.vcp.name/v1/voices/string'

Example Request

curl -X GET 'https://api.vcp.name/v1/voices/string'

Example ResponseSchema

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "name": "Narrator",
  "type": "clone",
  "model": null,
  "duration_seconds": 12.4,
  "created_at": "2026-10-30T00:10:42Z"
}

{  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",  "name": "Narrator",  "type": "clone",  "model": null,  "duration_seconds": 12.4,  "created_at": "2026-10-30T00:10:42Z"}

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Path Parameters

Response Body