Skip to main content
GET
/
v1
/
labs
/
voices
Get Voices
curl --request GET \
  --url https://genaipro.vn/api/v1/labs/voices \
  --header 'Authorization: Bearer <token>'
[
  {
    "public_owner_id": "owner123",
    "voice_id": "JBFqnCBsd6RMkjVDRZzb",
    "date_unix": 1700000000,
    "name": "George",
    "accent": "British",
    "gender": "male",
    "age": "middle_aged",
    "descriptive": "warm",
    "use_case": "narration",
    "category": "professional",
    "language": "en",
    "locale": null,
    "description": "A warm, professional British male voice.",
    "preview_url": "https://example.com/preview.mp3",
    "image_url": "https://example.com/avatar.jpg",
    "rate": 0.0,
    "free_users_allowed": true,
    "featured": false,
    "verified_languages": [
      {
        "language": "en",
        "model_id": "eleven_multilingual_v2",
        "accent": "British",
        "locale": null,
        "preview_url": "https://example.com/preview-en.mp3"
      }
    ]
  }
]
Rate limit: 60 requests/minute

​
Query Parameters

​
page_size
integer
default:"30"
Number of voices to return. Maximum 100.
​
page
integer
default:"0"
Page number for pagination (0-indexed).
​
search
string
Search term to filter voices by name or description. If a 20-character voice ID is provided, it also searches default voices.
​
gender
string
Filter by gender (e.g. male, female).
​
age
string
Filter by age group (e.g. young, middle_aged, old).
​
accent
string
Filter by accent (e.g. american, british, australian).
​
language
string
Filter by language (e.g. en, vi, ja).
​
locale
string
Filter by locale.
​
category
string
Filter by voice category. Values: professional, famous, high_quality.
​
use_cases
string
Filter by use case (e.g. narration, conversational).
​
descriptives
string
Filter by descriptive tags.
​
featured
boolean
default:"false"
Filter featured voices only.
​
sort
string
Sort criteria for results.

​
Response

Returns an array of voice objects.
​
voice_id
string
Unique voice identifier.
​
name
string
Voice display name.
​
gender
string
Voice gender.
​
age
string
Voice age group.
​
accent
string
Voice accent.
​
language
string
Primary language.
​
locale
string
Voice locale (nullable).
​
description
string
Voice description.
​
descriptive
string
Descriptive tags.
​
use_case
string
Recommended use case.
​
category
string
Voice category (generated, cloned, premade, professional, famous, high_quality).
​
preview_url
string
URL to preview audio sample.
​
image_url
string
Voice avatar image URL.
​
rate
number
Voice usage rate.
​
verified_languages
array
List of verified languages with model info.
[
  {
    "public_owner_id": "owner123",
    "voice_id": "JBFqnCBsd6RMkjVDRZzb",
    "date_unix": 1700000000,
    "name": "George",
    "accent": "British",
    "gender": "male",
    "age": "middle_aged",
    "descriptive": "warm",
    "use_case": "narration",
    "category": "professional",
    "language": "en",
    "locale": null,
    "description": "A warm, professional British male voice.",
    "preview_url": "https://example.com/preview.mp3",
    "image_url": "https://example.com/avatar.jpg",
    "rate": 0.0,
    "free_users_allowed": true,
    "featured": false,
    "verified_languages": [
      {
        "language": "en",
        "model_id": "eleven_multilingual_v2",
        "accent": "British",
        "locale": null,
        "preview_url": "https://example.com/preview-en.mp3"
      }
    ]
  }
]