Skip to main content
GET
Get a stock voice

Authorizations

Authorization
string
header
required

Use Authorization: Bearer pyai_live_... (or pyai_test_...).

Path Parameters

id
string
required

Stock voice id, e.g. stock_dorit_en_us.

Response

Stock voice

object
string
Example:

"voice"

voice_id
string
Example:

"stock_dorit_en_us"

name
string
Example:

"Imogen"

gender
enum<string>
Available options:
M,
F
region
string

Accent / regional flavor.

Example:

"UK (England / RP)"

age
string
Example:

"32"

tone
string
Example:

"polished, reassuring"

bio
string
Example:

"Calm, articulate London front-desk."

language
string
Example:

"en"

avatar_url
string<uri>

Voice-matched avatar image (PNG).

preview_url
string<uri>

Optional pre-generated audio preview (MP3). If absent, synthesize a short sample with this voice_id.

accent
string

Normalized accent label used for matching.

age_band
string

Normalized age band, e.g. 25-34.

pitch_band
string

Normalized pitch band, e.g. low-medium.

pace
string

Normalized speaking pace.

use_cases
string[]

Recommended Agent and content use cases.

search_tags
string[]

Search and auto-suggest tags.

source_dataset
string

Source dataset attribution.

license
string

Source voice license identifier.