# Create speech **URL**: **Method**: POST **Content Type**: application/json **Response Type**: text/json **Tham số Header**
Tham sốGiá trịTính bắt buộcMô tả
AuthorizationBearer {{token}}Bắt buộcToken đạ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
**Cấu trúc body của request** | **Tham số** | **Kiểu dữ liệu** | **Tính bắt buộc** | **Mô tả** | | ------------------- | ---------------- | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | app\_id | String | Bắt buộc | ID của ứng dụng, được sinh ra khi khởi tạo App | | response\_type | String | Có | Giá trị: indirect | | callback\_url | String | Bắt buộc | Webhook để nhận kết quả của request | | input\_text | String | Tùy chọn (Bắt buộc khi không có sentences) | Văn bản đầu vào cần tổng hợp | | voice\_code | String | Tùy (Bắt buộc khi có input\_text) | Mã giọng đọc cần tổng hợp | | audio\_type | String | Tùy chọn |

Định dạng loại file audio đầu ra

\* Giá trị mặc định: mp3

\* Giá trị audio\_type cho phép truyền vào là: mp3, wav

| | bitrate | Number |


|

Dùng để chuyển đầu ra về bit rate (bps) mong muốn

\* Giá trị mặc định: 128

\* Giá trị bit\_rate cho phép truyền vào là: 8, 16, 32, 64, 128.

\* Lưu ý: giá trị tham số bit\_rate chỉ có ý nghĩa khi audio\_type=mp3

| | speed\_rate | Number | Tùy chọn |

Dùng để điều chỉnh tốc độ của giọng đọc

\* Giá trị mặc định: 1.0

\* Giá trị của tham số speed\_rate có thể chạy từ 0.1 đến 1.9 và chấp nhận 1 chứ số sau dấu thập phân

| | sample\_rate | Number | Tùy chọn |

Dùng để điều chỉnh sample rate mong muốn

\* Giá trị của tham số sample\_rate phụ thuộc vào từng giọng

| | emphasis\_intensity | Number | Tùy chọn |

Dùng để điều chỉnh mức độ nhấn nhá.

Giá trị của tham số từ 0 - 100 và phải là bội số của 10.

Lưu ý: Tham số này chỉ áp dụng với giọng có hỗ trợ chức năng nhấn nhá. Giọng nhấn nhá là giọng đọc có field "has\_emphasis" trong kết quả trả về của API lấy danh sách giọng.

| **Chú ý:** ***Các audio link trả về chỉ có thời hạn trong vòng 3 phút, sau 3 phút audio link sẽ hết hạn và không thể sử dụng. Audio vẫn sẽ được lưu trữ trên hệ thống trong vòng 3 ngày kể từ thời điểm chuyển văn bản thành công. Muốn lấy link mới, bạn gọi api Get Request (bên dưới) để lấy lại audio link mới.*** **Kết quả trả về** * **status**: trạng thái của API (1: thành công, 0: thất bại) * **error\_code**: mã lỗi * **error\_message**: chi tiết lỗi * **result**: dữ liệu trả về khi gọi API thành công * app\_id * request\_id: mã request * characters: số ký tự của đoạn văn bản convert * voice\_code * audio\_type * speed\_rate * sample\_rate * bitrate * create\_at * status: trạng thái của request (IN\_PROGRESS) ``` // Example request curl --location 'https://vbee.vn/api/v1/tts' \ --data '{ "app_id": "55e0053d-f86f-4c2b-b791-b1ba6d59a868", "response_type": "indirect", "callback_url": "https://mydomain/callback", "input_text": "Chào mừng đén với website của chúng tôi! Đây là trang web cung cấp một giải pháp văn bản thành giọng nói, trên cơ sở, nó hỗ trợ các doanh nghiệp xây dựng các hệ thống trung tâm cuộc gọi tự động, hệ thống thông báo công khai, trợ lý ảo, tin tức âm thanh, podcast, sách âm thanh và tường thuật phim.", "voice_code": "hn_female_ngochuyen_full_48k-fhg", "audio_type":"mp3", "bitrate": 128, "speed_rate": "1.0" }' ``` ``` // Example response { "result": { "app_id": "55e0053d-f86f-4c2b-b791-b1ba6d59a868", "audio_type": "mp3", "bitrate": 128, "characters": 297, "request_id": "5509d1e6-8906-4291-899b-c25643a624af", "speed_rate": "1.0", "status": "IN_PROGRESS", "voice_code": "hn_female_ngochuyen_full_48k-fhg" }, "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/text-to-speech-lagacy/create-speech.md?ask= ``` 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.