API

トークンページで作成したトークンで tts-api.dangkhoabach.vn を直接呼び出します。すべてのリクエストに Authorization ヘッダーが必要です。

制限：トークンごとに毎分 30 リクエスト、および使用量ページの 1 日の上限。

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.