Documentation

Documentation

  • Conversation
  • Reader
  • Speech
  • Console
  • AI Agents
  • Languages iconTiếng Việt
    • English
    • Janpanese

›API

Tổng quan

  • Chuyển văn bản thành giọng nói
  • Chuyển giọng nói thành văn bản

API

  • Chuyển văn bản thành giọng nói
  • Chuyển giọng nói thành văn bản

Hướng dẫn

  • Chuyển văn bản thành giọng nói
  • Chuyển giọng nói thành văn bản

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"
}
← Chuyển giọng nói thành văn bảnChuyển giọng nói thành văn bản →
  • Request
    • Request Url
    • Request Headers
    • Request Body
    • Sample Request
  • Response
    • JSON
    • Sample Response: Success
Conversation
DocumentationAPI ReferenceTutorials (Video)
Reader
DocumentationAPI ReferenceTutorials
Speech
DocumentationAPI ReferenceTutorials
Copyright © 2025 FPT Corporation