Chuyển đến nội dung chính
GET
/
v1
/
labs
/
voices
Lấy danh sách giọng nói
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": "Giọng nam chuyên nghiệp, ấm áp.",
    "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"
      }
    ]
  }
]
Giới hạn: 60 request/phút

​
Query Parameters

​
page_size
integer
mặc định:"30"
Số lượng giọng nói trả về. Tối đa 100.
​
page
integer
mặc định:"0"
Số trang cho phân trang (bắt đầu từ 0).
​
search
string
Tìm kiếm theo tên hoặc mô tả. Nếu truyền voice ID (20 ký tự), sẽ tìm thêm trong danh sách default voices.
​
gender
string
Lọc theo giới tính (ví dụ: male, female).
​
age
string
Lọc theo nhóm tuổi (ví dụ: young, middle_aged, old).
​
accent
string
Lọc theo giọng (ví dụ: american, british, australian).
​
language
string
Lọc theo ngôn ngữ (ví dụ: en, vi, ja).
​
locale
string
Lọc theo locale.
​
category
string
Lọc theo danh mục. Giá trị: professional, famous, high_quality.
​
use_cases
string
Lọc theo mục đích sử dụng (ví dụ: narration, conversational).
​
descriptives
string
Lọc theo tag mô tả.
​
featured
boolean
mặc định:"false"
Chỉ hiển thị giọng nổi bật.
​
sort
string
Tiêu chí sắp xếp kết quả.

​
Response

Trả về mảng các đối tượng giọng nói.
​
voice_id
string
ID giọng nói.
​
name
string
Tên giọng nói.
​
gender
string
Giới tính.
​
age
string
Nhóm tuổi.
​
accent
string
Giọng/accent.
​
language
string
Ngôn ngữ chính.
​
locale
string
Locale (có thể null).
​
description
string
Mô tả giọng nói.
​
descriptive
string
Tag mô tả.
​
use_case
string
Mục đích sử dụng.
​
category
string
Danh mục (generated, cloned, premade, professional, famous, high_quality).
​
preview_url
string
URL nghe thử.
​
image_url
string
URL ảnh đại diện giọng nói.
​
rate
number
Tỷ lệ sử dụng.
​
verified_languages
array
Danh sách ngôn ngữ đã xác minh.
[
  {
    "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": "Giọng nam chuyên nghiệp, ấm áp.",
    "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"
      }
    ]
  }
]