API

Gọi trực tiếp tts-api.dangkhoabach.vn bằng token tạo ở trang Token. Mọi request đều cần header Authorization.

Giới hạn: 30 request mỗi phút cho mỗi token, hạn mức theo ngày như trang Sử dụng.

GET/v1/voices

Danh sách giọng

curl -H "Authorization: Bearer $TTS_TOKEN" https://tts-api.dangkhoabach.vn/v1/voices
POST/v1/speech

Tạo giọng nhanh (trả WAV) · ≤ 1.000

curl -H "Authorization: Bearer $TTS_TOKEN" -H "Content-Type: application/json" \
  -d '{"text": "Xin chào", "voice": "vi_VN-vais1000-medium"}' \
  -o speech.wav https://tts-api.dangkhoabach.vn/v1/speech
POST/v1/jobs

Job chất lượng cao · ≤ 20.000

curl -H "Authorization: Bearer $TTS_TOKEN" -H "Content-Type: application/json" \
  -d '{"text": "Đoạn văn dài…", "voice": "Thùy Dung"}' \
  https://tts-api.dangkhoabach.vn/v1/jobs
# → 202 {"id": "…", "status": "queued", …}
GET/v1/jobs/{id}

Xem trạng thái, rồi tải file khi status là done

curl -H "Authorization: Bearer $TTS_TOKEN" https://tts-api.dangkhoabach.vn/v1/jobs/<id>
curl -H "Authorization: Bearer $TTS_TOKEN" -o job.wav https://tts-api.dangkhoabach.vn/v1/jobs/<id>/audio

Lỗi trả về dạng {"error": "…", "message": "…"}: 400 invalid_text / invalid_voice, 401 unauthorized, 404 not_found, 409 not_ready, 429 rate_limited / quota_exceeded / queue_full, 502 synthesis_failed.