Get specific custom voice by ID

Fetches a specific Custom Voice by ID.

Refer to our voices guide for details on creating a custom voice.

Path parameters

idstringRequiredformat: "uuid"

Identifier for a Custom Voice. Formatted as a UUID.

Response

Success

idstring

Identifier for a Custom Voice. Formatted as a UUID.

versioninteger

Version number for a Custom Voice. Custom Voices, Prompts, Configs, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine configurations and revert to previous versions if needed. Version numbers are integer values representing different iterations of the Custom Voice. Each update to the Custom Voice increments its version number.

namestring

The name of the Custom Voice. Maximum length of 75 characters.

created_onlong

Time at which the Custom Voice was created. Measured in seconds since the Unix epoch.

modified_onlong

Time at which the Custom Voice was last modified. Measured in seconds since the Unix epoch.

base_voiceenum

The base voice used to create the Custom Voice.

parameter_modelenum

The name of the parameter model used to define which attributes are used by the parameters field. Currently, only 20241004-11parameter is supported as the parameter model.

Allowed values:

parametersobject

The specified attributes of a Custom Voice. If a parameter’s value is 0 (default), it will not be included in the response.

1	from hume import HumeClient
2
3	client = HumeClient(
4	api_key="YOUR_API_KEY",
5	)
6	client.empathic_voice.custom_voices.get_custom_voice(
7	id="id",
8	)

1	{
2	"id": "foo",
3	"version": 42,
4	"name": "foo",
5	"created_on": 42,
6	"modified_on": 42,
7	"base_voice": "ITO",
8	"parameter_model": "20241004-11parameter",
9	"parameters": {
10	"gender": 42,
11	"assertiveness": 42,
12	"buoyancy": 42,
13	"confidence": 42,
14	"enthusiasm": 42,
15	"nasality": 42,
16	"relaxedness": 42,
17	"smoothness": 42,
18	"tepidity": 42,
19	"tightness": 42
20	}
21	}

Path parameters

Headers

Response