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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-docs.vbee.vn/vbee-api/voices/get-list-voices.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
