Get list voices

Lấy thông tin của request bằng cách gọi API

URL: https://vbee.vn/api/public/v1/voices

Method: GET

Content Type: application/json

Response Type: text/json

Tham số Header

Tham số	Giá trị	Tính bắt buộc	Mô tả
Authorization	Bearer {{token}}	Bắt buộc	Token đại diện cho App gọi API, được sinh ra dưới dạng JWT có thời hạn do lúc khởi tạo App người dùng chọn
App-Id	{{app-id}}	Bắt buộc

PARAMS

voice_ownership	VBEE Đơn vị sở hữu giọng đọc. Gồm các giá trị: VBEE: giọng đọc của Vbee COMMUNITY: giọng cộng đồng PERSONAL: giọng của cá nhân người dùng sở hữu
code	hn_female_ngochuyen_full_48k-fhg Mã giọng đọc.
language_code	vi-VN Mã ngôn ngữ.
gender	male Giới tính. Gồm giá trị male (giới tính nam) và female (giới tính nữ)
limit	20 Số lượng giọng đọc muốn lấy về. Tối thiểu 1, tối đa 100, mặc định 20.
cursor	WyI2NmE4OTJiNmFhNTBlYmJhMGRjMmQyMmMiXQ== Con trỏ dùng để lấy dữ liệu của các trang tiếp theo

Kết quả trả về một đối tượng JSON với cấu trúc sau:

• result:

  • pagination: Đối tượng chứa thông tin phân trang:

    • has_next_page: Kiểu boolean, cho biết có trang tiếp theo hay không.

    • has_prev_page: Kiểu boolean, cho biết có trang trước đó hay không.

    • next_cursor: Chuỗi để lấy dữ liệu của trang tiếp theo.

    • prev_cursor: Chuỗi có thể rỗng (nullable) để lấy dữ liệu của trang trước đó.

  • voices: Danh sách chi tiết các giọng đọc

    • code: Mã giọng đọc.

    • name: Tên của giọng đọc.

    • gender: Giới tính của giọng đọc.

    • language_code: Mã ngôn ngữ của giọng đọc.

    • demo: Audio mẫu của giọng đọc.

    • credit_factor: Hệ số tính "điểm tiêu hao" theo mỗi một ký tự văn bản.

• status: Trạng thái yêu cầu. 1 là thành công. 0 là thất bại.

Ngoài ra, bạn cũng có thể tham khảo giọng đọc trực quan trên giao diện AIVoice Studio và lấy mã giọng đọc. Chi tiết xem tại Hướng dẫn lấy giọng đọc

Danh sách mã ngôn ngữ: I'll convert the CSV file to a markdown table for you.Here's the markdown table:

code	name
el-GR	Hy Lạp
kn-IN	Ấn Độ (Kannada)
pa-IN	Ấn Độ (Punjabi)
ro-RO	Rô Man
en-ZA	Tiếng Anh Nam Phi
es-US	Tây Ban Nha (Mỹ)
nl-NL	Hà Lan
en-NZ	Tiếng Anh New Zealand
gu-IN	Ấn Độ (Gujarati)
ar-XA	Ả Rập Xê Út
en-GB	Tiếng Anh (Anh)
it-IT	Ý
de-DE	Đức
fr-FR	Pháp
cmn-CN	Trung Quốc (Phổn thể)
pt-BR	Bồ Đào Nha (Brazil)
fr-CA	Pháp (Canada)
en-AU	Tiếng Anh (Úc)
fil-PH	Philippines
ru-RU	Nga
sr-RS	Cộng hòa Serbia
tr-TR	Thổ Nhĩ Kỳ
nl-BE	Hà Lan (Bỉ)
ko-KR	Hàn Quốc
bn-IN	Tây Bengal
sv-SE	Thụy Điển
yue-HK	Hồng Kông
cs-CZ	Cộng hòa Séc
pt-PT	Bồ Đào Nha
lv-LV	Cộng hòa Latvia
ca-ES	Tây Ban Nha (Catalan)
ja-JP	Nhật bản
ms-MY	Malaysia
pl-PL	Ba Lan
af-ZA	Cộng hòa Nam Phi
en-IN	Tiếng Anh (Ấn)
nb-NO	Na-Uy
bg-BG	Cộng hòa Bulgaria
te-IN	Ấn Độ (Telugu)
sk-SK	Cộng hòa Slovakia
da-DK	Đan Mạch
vi-VN	Việt Nam
en-US	Tiếng Anh (Mỹ)
fi-FI	Phần Lan
ml-IN	Ấn Độ (Malayalam)
is-IS	Iceland
hu-HU	Hungary
id-ID	Indonesia
ta-IN	Ấn Độ (Tamil)
es-ES	Tây Ban Nha
hi-IN	Ấn Độ (Hindi)
th-TH	Thái Lan
uk-UA	Ukraina

// Example request
curl --location 'https://vbee.vn/api/public/v1/voices?voiceOwnership=VBEE&languageCode=vi-VN' \
--header 'app-id: {{app-id}}'

// Example response
{
  "result": {
    "pagination": {
      "has_next_page": true,
      "has_prev_page": false,
      "next_cursor": "WyI2NmE4OTJiNmFhNTBlYmJhMGRjMmQyMmMiXQ==",
      "prev_cursor": null
    },
    "voices": [
      {
        "code": "hn_female_ngochuyen_full_48k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_female_ngochuyen_fast_news_48k-thg.mp3",
        "gender": "female",
        "language_code": "vi-VN",
        "name": "HN - Ngọc Huyền"
      },
      {
        "code": "hn_female_maiphuong_vdts_48k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_female_maiphuong_vdts_48k_cs-thg.mp3",
        "gender": "female",
        "language_code": "vi-VN",
        "name": "HN - Mai Phương"
      },
      {
        "code": "sg_female_lantrinh_vdts_48k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_female_lantrinh_fast_vdts_48k_cs-thg.mp3",
        "gender": "female",
        "language_code": "vi-VN",
        "name": "SG - Lan Trinh"
      },
      {
        "code": "hue_female_huonggiang_full_48k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hue_female_huonggiang_news_48k_cs-thg.mp3",
        "gender": "female",
        "language_code": "vi-VN",
        "name": "Huế - Hương Giang"
      },
      {
        "code": "sg_female_thaotrinh_full_48k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_female_thaotrinh_fast_news_48k_cs-thg.mp3",
        "gender": "female",
        "language_code": "vi-VN",
        "name": "SG - Thảo Trinh"
      },
      {
        "code": "sg_male_trungkien_vdts_48k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_male_trungkien_vdts_48k-fhg.mp3",
        "gender": "male",
        "language_code": "vi-VN",
        "name": "SG - Trung Kiên"
      },
      {
        "code": "hue_male_duyphuong_full_48k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_female_duyphuong_fast_news_48k_cs-thg.mp3",
        "gender": "male",
        "language_code": "vi-VN",
        "name": "Huế - Duy Phương"
      },
      {
        "code": "sg_male_minhhoang_full_48k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_male_minhhoang_fast_news_48k_cs-thg.mp3",
        "gender": "male",
        "language_code": "vi-VN",
        "name": "SG - Minh Hoàng"
      },
      {
        "code": "hn_male_manhdung_news_48k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_male_manhdung_news_48k_cs-thg.mp3",
        "gender": "male",
        "language_code": "vi-VN",
        "name": "HN - Mạnh Dũng"
      },
      {
        "code": "hn_male_thanhlong_talk_48k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_male_thanhlong_talk_48k-fhg.mp3",
        "gender": "male",
        "language_code": "vi-VN",
        "name": "HN - Thanh Long"
      },
      {
        "code": "hn_male_phuthang_news65dt_44k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_male_phuthang_news65dt_44k-fhg.mp3",
        "gender": "male",
        "language_code": "vi-VN",
        "name": "HN - Anh Khôi"
      },
      {
        "code": "sg_female_tuongvy_call_44k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_female_tuongvy_call_44k-fhg.mp3",
        "gender": "female",
        "language_code": "vi-VN",
        "name": "SG - Tường Vy"
      },
      {
        "code": "sg_female_thaotrinh_full_44k-phg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_female_thaotrinh_full_44k-phg.mp3",
        "gender": "female",
        "language_code": "vi-VN",
        "name": "SG - Thảo Trinh"
      },
      {
        "code": "hn_male_manhdung_news_48k-phg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_male_manhdung_news_48k-phg.mp3",
        "gender": "male",
        "language_code": "vi-VN",
        "name": "HN - Mạnh Dũng"
      },
      {
        "code": "hn_male_phuthang_stor80dt_48k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_male_phuthang_stor80dt_48k-fhg.mp3",
        "gender": "male",
        "language_code": "vi-VN",
        "name": "HN - Anh Khôi"
      },
      {
        "code": "hn_female_hermer_stor_48k-fhg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_female_hermer_stor_48k-fhg.mp3",
        "gender": "female",
        "language_code": "vi-VN",
        "name": "HN - Ngọc Lan"
      },
      {
        "code": "hn_female_lenka_stor_48k-phg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_female_lenka_stor_48k-phg.wav",
        "gender": "female",
        "language_code": "vi-VN",
        "name": "HN - Nguyệt Dương"
      },
      {
        "code": "sg_male_chidat_ebook_48k-phg",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_male_chidat_ebook_48k-phg.wav",
        "gender": "male",
        "language_code": "vi-VN",
        "name": "SG - Chí Đạt"
      },
      {
        "code": "hn_female_hachi_book_22k-vc",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_female_hachi_book_22k-vc.mp3",
        "gender": "female",
        "language_code": "vi-VN",
        "name": "HN - Hà Chi"
      },
      {
        "code": "hn_male_vietbach_child_22k-vc",
        "credit_factor": 1,
        "demo": "https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_male_vietbach_child_22k-vc.mp3",
        "gender": "male",
        "language_code": "vi-VN",
        "name": "HN - Việt Bách"
      }
    ]
  },
  "status": 1
}