Skip to main content
GET
/
v1
/
voices
/
{id}
Get a stock voice
curl --request GET \
  --url https://api.pyai.com/v1/voices/{id} \
  --header 'Authorization: Bearer <token>'
{
  "object": "voice",
  "voice_id": "stock_emma_en_gb",
  "name": "Imogen",
  "region": "UK (England / RP)",
  "age": "32",
  "tone": "polished, reassuring",
  "bio": "Calm, articulate London front-desk.",
  "language": "en",
  "avatar_url": "<string>",
  "preview_url": "<string>"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Stock voice id, e.g. stock_emma_en_gb.

Response

Stock voice

​
object
string
Example:

"voice"

​
voice_id
string
Example:

"stock_emma_en_gb"

​
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>

Short audio preview (MP3).