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

Canonical stock voice id or permanent alias. Alias lookups return the canonical voice_id.

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.

aliases
string[]

Permanent convenience identifiers accepted on the voice's advertised surfaces. API responses report the canonical voice_id.

available_on
enum<string>[]

Product surfaces on which this stock voice can be selected.

Available options:
speak,
omni
synthesis_modes
enum<string>[]

Delivery modes accepted for this voice on POST /v1/audio/speech. Every Speak-available voice accepts both; a voice served from a blocking-only fleet answers a streaming request with x-pyai-stream: buffered. An empty list means the voice has no Speak surface at all (check available_on).

Available options:
streaming,
async
tier
enum<string>

Customer-facing voice quality tier. The public catalog includes Standard and Natural voices; inspect available_on and synthesis_modes before use.

Available options:
standard,
natural
Example:

"standard"

pricing
object

Voice-specific pricing on top of the selected product's base rate.

source_dataset
string

Source dataset attribution.

license
string

Source voice license identifier.