API cơ bản

Tích hợp HEX Voice

Ba bước: tạo job → đợi hoàn tất → tải file WAV. Base URL: https://tts.hextech.vn

Tạo giọng nói

POST/v1/tts

Gửi văn bản + API key. Nhận về job_id. Mỗi ký tự = 1 tín dụng.

bash

curl -X POST "https://tts.hextech.vn/v1/tts" \
  -H "Authorization: Bearer hex_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Xin chào từ HEX Voice","language":"vi"}'

Response:

json

{
  "job_id": "a1b2c3d4-…",
  "status": "queued",
  "credits_charged": 24,
  "credit_balance": 76
}

Kiểm tra trạng thái

GET/v1/tts/{job_id}

Poll mỗi 1–2 giây đến khi status là succeeded hoặc failed.

bash

curl -sS "https://tts.hextech.vn/v1/tts/{job_id}"

Tải file audio

GET/v1/tts/{job_id}/audio

Trả về file WAV. Chỉ gọi khi job đã succeeded.

bash

curl -sS "https://tts.hextech.vn/v1/tts/{job_id}/audio" -o speech.wav

Xác thực

Mọi request tạo job cần header Authorization: Bearer hex_…. Tạo và quản lý key tại Studio → API.