Vbee TTS API được thiết kế như một HTTPS server nhận yêu cầu (request) cùng các tham số và trả về trả lời (response) tương ứng với yêu cầu và tham số đã gửi.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"12951168","collectionId":"072c9fc6-5cc0-4b9c-bb51-366ba72f8547","publishedId":"Uz5FHbSd","public":true,"customColor":{"top-bar":"FFD60A","right-sidebar":"303030","highlight":"1E164E"},"publishDate":"2023-10-20T03:26:22.000Z"},"item":[{"name":"List voices","id":"23ff2526-76bf-49c8-bd84-94152d3e9af3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"app-id","value":"{{app-id}}","type":"text"}],"url":"https://vbee.vn/api/public/v1/voices","description":"Lấy danh sách các giọng đọc được cung cấp bởi Vbee API.
\nKết quả trả về một đối tượng JSON với cấu trúc sau:
\nresult:
\npagination: Đối tượng chứa thông tin phân trang:
\nhas_next_page: Kiểu boolean, cho biết có trang tiếp theo hay không.
\nhas_prev_page: Kiểu boolean, cho biết có trang trước đó hay không.
\nnext_cursor: Chuỗi để lấy dữ liệu của trang tiếp theo.
\nprev_cursor: Chuỗi có thể rỗng (nullable) để lấy dữ liệu của trang trước đó.
\nvoices: Danh sách chi tiết các giọng đọc
\ncode: Mã giọng đọc.
\nname: Tên của giọng đọc.
\ngender: Giới tính của giọng đọc.
\nlanguage_code: Mã ngôn ngữ của giọng đọc.
\ndemo: Audio mẫu của giọng đọc.
\ncredit_factor: Hệ số tính \"điểm tiêu hao\" theo mỗi một ký tự văn bản.
\nstatus: Trạng thái yêu cầu. 1 là thành công. 0 là thất bại.
\nNgoà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:
Đơn vị sở hữu giọng đọc. Gồm các giá trị:
\nMã giọng đọc.
\n","type":"text/plain"},"key":"code","value":"hn_female_ngochuyen_full_48k-fhg"},{"disabled":true,"description":{"content":"Mã ngôn ngữ.
\n","type":"text/plain"},"key":"language_code","value":"vi-VN"},{"disabled":true,"description":{"content":"Giới tính. Gồm giá trị male (giới tính nam) và female (giới tính nữ)
\n","type":"text/plain"},"key":"gender","value":"male"},{"disabled":true,"description":{"content":"Số lượng giọng đọc muốn lấy về. Tối thiểu 1, tối đa 100, mặc định 20.
\n","type":"text/plain"},"key":"limit","value":"20"},{"disabled":true,"description":{"content":"Con trỏ dùng để lấy dữ liệu của các trang tiếp theo
\n","type":"text/plain"},"key":"cursor","value":"WyI2NmE4OTJiNmFhNTBlYmJhMGRjMmQyMmMiXQ=="}],"variable":[]}},"response":[{"id":"eed95033-12e7-412a-94df-aa10b0318caf","name":"Vbee voices","originalRequest":{"method":"GET","header":[{"key":"app-id","value":"{{app-id}}","type":"text"}],"url":{"raw":"https://vbee.vn/api/public/v1/voices?voiceOwnership=VBEE&languageCode=vi-VN","protocol":"https","host":["vbee","vn"],"path":["api","public","v1","voices"],"query":[{"key":"voiceOwnership","value":"VBEE"},{"key":"languageCode","value":"vi-VN"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Sat, 27 Sep 2025 08:56:02 GMT"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Encoding","value":"br"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"ETag","value":"W/\"1328-HWm8kEdhSXVnXodtzkflnSDS9Fk\""},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 bc330e83c319e99d19922ed79166586a.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"IAD61-P1"},{"key":"X-Amz-Cf-Id","value":"niQTG9lZ_YIX6Mt8l5GY0sC6UAJC0ebrzkBlDpnJ5ohAEMSQKkHOWA=="}],"cookie":[],"responseTime":null,"body":"{\n \"result\": {\n \"pagination\": {\n \"has_next_page\": true,\n \"has_prev_page\": false,\n \"next_cursor\": \"WyI2NmE4OTJiNmFhNTBlYmJhMGRjMmQyMmMiXQ==\",\n \"prev_cursor\": null\n },\n \"voices\": [\n {\n \"code\": \"hn_female_ngochuyen_full_48k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_female_ngochuyen_fast_news_48k-thg.mp3\",\n \"gender\": \"female\",\n \"language_code\": \"vi-VN\",\n \"name\": \"HN - Ngọc Huyền\"\n },\n {\n \"code\": \"hn_female_maiphuong_vdts_48k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_female_maiphuong_vdts_48k_cs-thg.mp3\",\n \"gender\": \"female\",\n \"language_code\": \"vi-VN\",\n \"name\": \"HN - Mai Phương\"\n },\n {\n \"code\": \"sg_female_lantrinh_vdts_48k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_female_lantrinh_fast_vdts_48k_cs-thg.mp3\",\n \"gender\": \"female\",\n \"language_code\": \"vi-VN\",\n \"name\": \"SG - Lan Trinh\"\n },\n {\n \"code\": \"hue_female_huonggiang_full_48k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hue_female_huonggiang_news_48k_cs-thg.mp3\",\n \"gender\": \"female\",\n \"language_code\": \"vi-VN\",\n \"name\": \"Huế - Hương Giang\"\n },\n {\n \"code\": \"sg_female_thaotrinh_full_48k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_female_thaotrinh_fast_news_48k_cs-thg.mp3\",\n \"gender\": \"female\",\n \"language_code\": \"vi-VN\",\n \"name\": \"SG - Thảo Trinh\"\n },\n {\n \"code\": \"sg_male_trungkien_vdts_48k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_male_trungkien_vdts_48k-fhg.mp3\",\n \"gender\": \"male\",\n \"language_code\": \"vi-VN\",\n \"name\": \"SG - Trung Kiên\"\n },\n {\n \"code\": \"hue_male_duyphuong_full_48k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_female_duyphuong_fast_news_48k_cs-thg.mp3\",\n \"gender\": \"male\",\n \"language_code\": \"vi-VN\",\n \"name\": \"Huế - Duy Phương\"\n },\n {\n \"code\": \"sg_male_minhhoang_full_48k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_male_minhhoang_fast_news_48k_cs-thg.mp3\",\n \"gender\": \"male\",\n \"language_code\": \"vi-VN\",\n \"name\": \"SG - Minh Hoàng\"\n },\n {\n \"code\": \"hn_male_manhdung_news_48k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_male_manhdung_news_48k_cs-thg.mp3\",\n \"gender\": \"male\",\n \"language_code\": \"vi-VN\",\n \"name\": \"HN - Mạnh Dũng\"\n },\n {\n \"code\": \"hn_male_thanhlong_talk_48k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_male_thanhlong_talk_48k-fhg.mp3\",\n \"gender\": \"male\",\n \"language_code\": \"vi-VN\",\n \"name\": \"HN - Thanh Long\"\n },\n {\n \"code\": \"hn_male_phuthang_news65dt_44k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_male_phuthang_news65dt_44k-fhg.mp3\",\n \"gender\": \"male\",\n \"language_code\": \"vi-VN\",\n \"name\": \"HN - Anh Khôi\"\n },\n {\n \"code\": \"sg_female_tuongvy_call_44k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_female_tuongvy_call_44k-fhg.mp3\",\n \"gender\": \"female\",\n \"language_code\": \"vi-VN\",\n \"name\": \"SG - Tường Vy\"\n },\n {\n \"code\": \"sg_female_thaotrinh_full_44k-phg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_female_thaotrinh_full_44k-phg.mp3\",\n \"gender\": \"female\",\n \"language_code\": \"vi-VN\",\n \"name\": \"SG - Thảo Trinh\"\n },\n {\n \"code\": \"hn_male_manhdung_news_48k-phg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_male_manhdung_news_48k-phg.mp3\",\n \"gender\": \"male\",\n \"language_code\": \"vi-VN\",\n \"name\": \"HN - Mạnh Dũng\"\n },\n {\n \"code\": \"hn_male_phuthang_stor80dt_48k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_male_phuthang_stor80dt_48k-fhg.mp3\",\n \"gender\": \"male\",\n \"language_code\": \"vi-VN\",\n \"name\": \"HN - Anh Khôi\"\n },\n {\n \"code\": \"hn_female_hermer_stor_48k-fhg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_female_hermer_stor_48k-fhg.mp3\",\n \"gender\": \"female\",\n \"language_code\": \"vi-VN\",\n \"name\": \"HN - Ngọc Lan\"\n },\n {\n \"code\": \"hn_female_lenka_stor_48k-phg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_female_lenka_stor_48k-phg.wav\",\n \"gender\": \"female\",\n \"language_code\": \"vi-VN\",\n \"name\": \"HN - Nguyệt Dương\"\n },\n {\n \"code\": \"sg_male_chidat_ebook_48k-phg\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/sg_male_chidat_ebook_48k-phg.wav\",\n \"gender\": \"male\",\n \"language_code\": \"vi-VN\",\n \"name\": \"SG - Chí Đạt\"\n },\n {\n \"code\": \"hn_female_hachi_book_22k-vc\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_female_hachi_book_22k-vc.mp3\",\n \"gender\": \"female\",\n \"language_code\": \"vi-VN\",\n \"name\": \"HN - Hà Chi\"\n },\n {\n \"code\": \"hn_male_vietbach_child_22k-vc\",\n \"credit_factor\": 1,\n \"demo\": \"https://vbee.s3.ap-southeast-1.amazonaws.com/audios/demo/vbee/hn_male_vietbach_child_22k-vc.mp3\",\n \"gender\": \"male\",\n \"language_code\": \"vi-VN\",\n \"name\": \"HN - Việt Bách\"\n }\n ]\n },\n \"status\": 1\n}"}],"_postman_id":"23ff2526-76bf-49c8-bd84-94152d3e9af3"},{"name":"Text to speech","id":"f366880e-68ba-4400-a0fd-58aa1558b4ad","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"app_id\": \"{{app_id}}\",\n \"response_type\": \"indirect\",\n \"callback_url\": \"https://mydomain/callback\",\n \"input_text\": \"Xin 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.\",\n \"voice_code\": \"hn_female_ngochuyen_full_48k-fhg\",\n \"audio_type\":\"mp3\",\n \"bitrate\": 128,\n \"speed_rate\": \"1.0\"\n}","options":{"raw":{"language":"json"}}},"url":"https://vbee.vn/api/v1/tts","description":"Cấu trúc TTS API gửi request lên server như sau:
\nURL: https://vbee.vn/api/v1/tts
\nMethod: POST
\nContent Type: application/json
\nResponse Type: text/json
\nTham số Header
\nCá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.
\nstatus: trạng thái của API (1: thành công, 0: thất bại)
\nerror_code: mã lỗi
\nerror_message: chi tiết lỗi
\nresult: dữ liệu trả về khi gọi API thành công
\napp_id
\nrequest_id: mã request
\ncharacters: số ký tự của đoạn văn bản convert
\nvoice_code
\naudio_type
\nspeed_rate
\nsample_rate
\nbitrate
\ncreate_at
\nstatus: trạng thái của request (IN_PROGRESS)
\nKhi request thành công, hệ thống VBEE TTS sẽ gửi đến Callback URL một HTTP POST như sau
\nURL: callback url truyền lên khi gọi API
\nMethod: POST
\nContent Type: application/json
\nBody:
\n","urlObject":{"protocol":"https","path":["api","v1","tts"],"host":["vbee","vn"],"query":[],"variable":[]}},"response":[{"id":"5b4a2ff3-6fac-4e72-9918-9f6aad6a918a","name":"Text to speech","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"app_id\": \"55e0053d-f86f-4c2b-b791-b1ba6d59a868\",\n \"response_type\": \"indirect\",\n \"callback_url\": \"https://mydomain/callback\",\n \"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.\",\n \"voice_code\": \"hn_female_ngochuyen_full_48k-fhg\",\n \"audio_type\":\"mp3\",\n \"bitrate\": 128,\n \"speed_rate\": \"1.0\"\n}","options":{"raw":{"language":"json"}}},"url":"https://vbee.vn/api/v1/tts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 24 Jun 2022 03:36:31 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"263"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"ETag","value":"W/\"107-6CcKkKbwc3UCFqW4xesnG3zOlAs\""},{"key":"Vary","value":"Accept-Encoding"}],"cookie":[],"responseTime":null,"body":"{\n \"result\": {\n \"app_id\": \"55e0053d-f86f-4c2b-b791-b1ba6d59a868\",\n \"audio_type\": \"mp3\",\n \"bitrate\": 128,\n \"characters\": 297,\n \"request_id\": \"5509d1e6-8906-4291-899b-c25643a624af\",\n \"speed_rate\": \"1.0\",\n \"status\": \"IN_PROGRESS\",\n \"voice_code\": \"hn_female_ngochuyen_full_48k-fhg\"\n },\n \"status\": 1\n}"}],"_postman_id":"f366880e-68ba-4400-a0fd-58aa1558b4ad"},{"name":"Get Request","id":"179fabf1-a5e8-4013-ac52-b9b64a0ab3d5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"https://vbee.vn/api/v1/tts/{{request_id}}","description":"Lấy thông tin của request bằng cách gọi API
\nURL: https://vbee.vn/api/v1/tts/{request_id}
\nMethod: GET
\nContent Type: application/json
\nResponse Type: text/json
\nTham số Header
\nLấy thông tin kết quả gọi callback của request (chỉ áp dụng với request dạng callback)
\nURL: https://vbee.vn/api/v1/tts/{request_id}/callback-result
\nMethod: GET
\nContent Type: application/json
\nResponse Type: text/json
\nTham số Header
\n