[POST] Tạo Text To Speech
API dùng để chuyển văn bản thành giọng nói (Text-to-Speech) bằng dịch vụ TTS của LarVoice. Kết quả trả về là một JSON chứa thông tin.
🔐 Authentication
-
API Key: Gửi qua header
Header cần có
apikey: 92d80a807743fa1bfa337777212ce6d4📤 Request
Method
POST
Content-Type
multipart/form-data
Parameters
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
text |
string | ✅ Yes | — | Nội dung văn bản cần chuyển thành giọng nói |
voice_id |
string | ✅ Yes | — | ID giọng đọc |
voice_guest_id |
string | ✅ Yes | = voice_id | ID khách sử dụng giọng |
language_id |
string | ✅ Yes | 1 |
Ngôn ngữ sử dụng (1 = Vietnamese) |
model_id |
string | ✅ Yes | 1 |
ID mô hình phát âm |
speed |
string | ❌ No | 1 |
Tốc độ đọc |
volume |
string | ❌ No | 0.8 |
Âm lượng giọng nói |
pitch |
string | ❌ No | 0 |
Độ cao của giọng nói |
background_volume |
string | ❌ No | 0.2 |
Âm lượng nhạc nền |
background_music |
string | ❌ No | 0 |
Loại nhạc nền |
bass |
string | ❌ No | 4 |
Điều chỉnh bass |
treble |
string | ❌ No | 5 |
Điều chỉnh treble |
silence |
string | ❌ No | 0 |
Khoảng lặng đầu/cuối |
📥 Example
curl --location 'https://larvoice.com/api/tts' \--header 'apikey:92d80a807743fa1bfa337777212ce6d4' \--form 'text="Có một người rất nghèo và khổ cực. Một người nhà giàu nhìn thấy đáng thương liền muốn giúp đỡ. Người giàu có đưa cho anh ta một con bò, chúc anh khai hoang tốt, đợi mùa xuân đến gieo hạt giống, mùa thu là có thể thoát nghèo rồi."' \--form 'voice_id="836"' \--form 'voice_guest_id="836"' \--form 'language_id="1"' \--form 'model_id="1"' \--form 'speed="1"' \--form 'volume="0.8"' \--form 'pitch="0"' \--form 'background_volume="0.2"' \--form 'background_music="0"' \--form 'bass="4"' \--form 'treble="5"' \--form 'silence="0"'📤 Response
Success Response (200 OK)
{"id": 11729,"uuid": "0bb07ee4-cd72-4a56-bf3a-583028bae886","result_url": "https://larvoice.com/api/tts/11729","status": "pending"}Error Response (400, 500)
{ "error": "Missing required fields: text and voice_id"}