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.