0 / 2000
Đọc văn bản tiếng Việt bằng 14 giọng Kokoro, chạy trực tiếp trên VPS.
Base URL: https://tts.nthquan.qzz.io
| Method | Path | Mô tả | Tham số |
|---|---|---|---|
| GET | /api/health | Trạng thái dịch vụ, độ sâu hàng đợi, số giọng | - |
| GET | /api/voices | Danh sách 14 giọng: id, label, note | - |
| GET | /api/jobs | Giám sát hàng đợi: đang chạy, đang chờ, gần đây | limit (mặc định 20) |
| POST | /api/tts | Tạo job đọc văn bản, trả về job_id | JSON body: text, voice, speed |
| POST | /api/jobs/{job_id}/rerun | Tạo lại job cũ (cùng text, giọng, tốc độ) | - |
| GET | /api/jobs/{job_id} | Trạng thái chi tiết 1 job | - |
| GET | /audio/{job_id}.wav | Tải file WAV khi job hoàn tất | - |
# Tạo job
curl -u tts:MẬT_KHẨU -X POST https://tts.nthquan.qzz.io/api/tts \
-H 'Content-Type: application/json' \
-d '{"text":"Xin chào","voice":"diem_trinh","speed":1.0}'
# -> {"job_id":"abc123def456"}
# Theo dõi job
curl -u tts:MẬT_KHẨU https://tts.nthquan.qzz.io/api/jobs/abc123def456
# -> {"status":"done","duration_s":1.8,...}
# Tải file WAV
curl -u tts:MẬT_KHẨU -o out.wav https://tts.nthquan.qzz.io/audio/abc123def456.wav
# Giám sát hàng đợi
curl -u tts:MẬT_KHẨU 'https://tts.nthquan.qzz.io/api/jobs?limit=10'Trạng thái job: queued → running → done hoặc error.
Giới hạn: text tối đa 2000 ký tự, speed 0.5-2.0, hàng đợi 10 job, xử lý tuần tự 1 worker.
File WAV 24kHz mono tự xóa sau 3 ngày, job vẫn giữ trong lịch sử để bấm Tạo lại.