Skip to main content
GET
/
v1
/
voices
List voices
curl --request GET \
  --url https://api.pyai.com/v1/voices \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "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_...).

Query Parameters

​
gender
enum<string>

Filter stock voices by gender (case-insensitive exact match).

Available options:
M,
F
​
region
string

Filter stock voices by region/accent (case-insensitive substring match, e.g. us, india, scotland).

​
source
enum<string>

Return only one kind of voice. Omit for the merged library.

Available options:
stock,
design

Response

Voice library (stock + designed)

​
object
string
Example:

"list"

​
data
object[]