API

FPT.AI Speech - Chuyển văn bản thành giọng nói

Request

Request Url

POST https://api.fpt.ai/hmi/tts/v5

Request Headers

Tham số	Yêu cầu	Mặc định	Mô tả
api_key	Có		api_key của bạn ( lấy từ console.fpt.ai )
voice	Không	nữ	Xác định giọng nói banmai (nữ miền bắc) lannhi (nữ miền nam) leminh (nam miền bắc) myan (nữ miền trung) thuminh (nữ miền bắc) giahuy (nam miền trung) linhsan (nữ miền nam)
speed	No	0	Điều chỉnh tốc độ của giọng nói: +3 tốc độ nhanh nhất +2 +1 0 tốc độ bình thường -1 -2 -3 tốc độ chậm nhất
format	Không	mp3	Xác định dạng file âm thanh đầu ra mp3 wav
callback_url	No		URL cung cấp bởi người dùng để nhận thông báo khi file âm thanh đã tạo thành công và có thể tải về Mô tả: Request method: POST Content-Type: application/json Body: - Success: { "message": << async_link >>, "success": "true" } - Failed: { "message": << error_message >>, "success": "false" }

Request Body

Chứa phần nội dung văn bản cần tổng hợp

Lưu ý:

• Giới hạn ký tự mỗi yêu cầu: 5.000 ký tự
• Mỗi yêu cầu cần chứa tối thiểu 3 ký tự

Sample Request

curl -X POST \
-H "api_key: xxxxxxxxxxxxx" \
-H "voice: banmai" \
-H "callback_url: your_callback_url" \
-H "Cache-Control: no-cache" \
-d 'Bạn thấy dịch vụ TTS của FPT có tốt không?' \
"https://api.fpt.ai/hmi/tts/v5"

Response

Kết quả trả về: tệp tin JSON chứa đường dẫn của file âm thanh đã được chuyển đổi.

Lưu ý:

• Do hệ thống cần nhiều thời gian để xử lý một văn bản nên file này có thể chưa tồn tại ngay ở thời điểm response. Cần chờ trong một khoảng thời gian, liên tục thử download file cho đến khi thành công. Thời gian chờ đợi từ 5 giây đến 2 phút, phụ thuộc vào độ dài văn bản.
• Có thể sử dụng tham số "callback_url" để nhận kết quả lúc tập tin đã được chuyển đổi xong.

JSON

Tên trường	Mô tả
error	Mã lỗi, giá trị bằng 0 là thành công, giá trị khác 0 là thất bại (có lỗi xảy ra)
async	Link đến file mp3 tổng hợp nếu mã lỗi error = 0.
request_id	Id của request
message	Thông báo chi tiết

Sample Response: Success

{
  "async": "https://s3-ap-southeast-1.amazonaws.com/text2speech-v4/male.0.pro.4b5b15285847e83acbb3beb945434453.mp3",
  "error": 0,
  "message": "The content will be returned after a few seconds under the async link.",
  "request_id": "4b5b15285847e83acbb3beb945434453"
}