# Get list voices

**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 | <p>VBEE</p><p>Đơn vị sở hữu giọng đọc. Gồm các giá trị:</p><ul><li>VBEE: giọng đọc của Vbee</li><li>COMMUNITY: giọng cộng đồng</li><li>PERSONAL: giọng của cá nhân người dùng sở hữu</li></ul> |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code             | <p>hn\_female\_ngochuyen\_full\_48k-fhg</p><p>Mã giọng đọc.</p>                                                                                                                                |
| language\_code   | <p>vi-VN</p><p>Mã ngôn ngữ.</p>                                                                                                                                                                |
| gender           | <p>male</p><p>Giới tính. Gồm giá trị male (giới tính nam) và female (giới tính nữ)</p>                                                                                                         |
| limit            | <p>20</p><p>Số lượng giọng đọc muốn lấy về. Tối thiểu 1, tối đa 100, mặc định 20.</p>                                                                                                          |
| cursor           | <p>WyI2NmE4OTJiNmFhNTBlYmJhMGRjMmQyMmMiXQ==</p><p>Con trỏ dùng để lấy dữ liệu của các trang tiếp theo<br></p>                                                                                  |

**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](https://help.vbee.vn/huong-dan-su-dung/chuyen-van-ban/giao-dien-may-tinh/chon-giong-doc)

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
}
```