API

Chame tts-api.dangkhoabach.vn diretamente com um token da página Tokens. Toda requisição precisa do cabeçalho Authorization.

Limites: 30 requisições por minuto por token, e a cota diária da página Uso.

GET/v1/voices

Listar vozes

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

Fala rápida (retorna 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

Tarefa de alta qualidade · ≤ 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}

Consulte o status e baixe quando for 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

Os erros vêm como {"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.