API

토큰 페이지에서 만든 토큰으로 tts-api.dangkhoabach.vn을 직접 호출하세요. 모든 요청에 Authorization 헤더가 필요합니다.

제한: 토큰당 분당 30개 요청, 그리고 사용량 페이지의 일일 할당량.

GET/v1/voices

음성 목록

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

빠른 합성 (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

고품질 작업 · ≤ 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}

상태를 확인하고 status가 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

오류는 {"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.