APIText to Speech

Danh sách giọng đọc

Trả về danh sách các giọng đọc hiện có, dùng cho tham số voiceId khi gọi endpoint tạo giọng nói. Nếu kho giọng đọc tạm thời gặp sự cố, endpoint trả về mảng rỗng thay vì báo lỗi.

Headers

X-Api-KeystringRequired

Query parameters

voiceTypeenumRequired

Chọn kho giọng đọc — SYSTEM (kho chung của OMICX) hoặc PERSONALIZED (giọng đọc riêng do chính tenant sở hữu API key tự huấn luyện).

Allowed values:
languagestringOptional
pageintegerOptional>=1Defaults to 1
sizeintegerOptional1-100Defaults to 100

Response

Thành công.

voiceIdstringOptional

Mã giọng đọc, dùng cho tham số voiceId.

namestringOptional

Tên hiển thị của giọng đọc.

genderstring or nullOptional
languagestring or nullOptional

Mã ngôn ngữ.

countrystring or nullOptional
regionstring or nullOptional

Vùng miền giọng đọc.

avatarUrlstring or nullOptional<=2048 characters

URL ảnh đại diện giọng đọc — có thể null nếu không có.

previewUrlstring or nullOptional<=2048 characters

URL file audio nghe thử. Với giọng SYSTEM là link cố định; với giọng PERSONALIZED là presigned URL có thời hạn.

modelIdslist of stringsOptional

Danh sách model hỗ trợ giọng đọc này.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error