Tài liệu API VietVoice

Đấu nối giọng đọc AI vào app/website của bạn. Base URL: https://vietvoice.click

1. Lấy API key

Đăng ký tài khoản tại vietvoice.click và nạp credits.
Vào Tài khoản → API Key → Tạo key mới. Key chỉ hiện 1 lần — lưu ngay.

2. Xác thực

Gửi key trong header của mọi request:

# Header bắt buộc
Authorization: Bearer vv_xxxxxxxxxxxxxxxx

3. Tạo giọng đọc

POST /api/v1/speech

Tham số	Kiểu	Mô tả
`input`	string *	Văn bản cần đọc (tối đa 20.000 credits)
`voice`	string	Tên giọng (mặc định: Hải Đăng). Xem `/api/v1/voices`
`response_format`	string	Luôn trả `wav`

curl https://vietvoice.click/api/v1/speech \
  -H "Authorization: Bearer vv_..." \
  -H "Content-Type: application/json" \
  -d '{"input": "Xin chào các bạn!", "voice": "Hải Đăng"}' \
  --output audio.wav

import requests
r = requests.post("https://vietvoice.click/api/v1/speech",
    headers={"Authorization": "Bearer vv_..."},
    json={"input": "Xin chào!", "voice": "Hải Đăng"})
open("audio.wav", "wb").write(r.content)

✅ Thành công: HTTP 200, body là file WAV (48kHz).
💰 Trừ 1 credits / 1 credits văn bản — giống tạo trên web.

4. Danh sách giọng

GET /api/v1/voices

curl https://vietvoice.click/api/v1/voices \
  -H "Authorization: Bearer vv_..."

5. Kiểm tra số dư

GET /api/auth/me

Trả về balance (số credits còn lại) và thông tin tài khoản.

6. Mã lỗi

Mã	Ý nghĩa
`401`	Thiếu/sai API key
`402`	Hết credits — nạp thêm trong Studio
`429`	Engine đang bận — thử lại sau vài giây

7. Lưu ý

Giữ API key bí mật, không để lộ trong code frontend công khai.
Thu hồi key bị lộ ngay trong trang Tài khoản.
Nghiêm cấm dùng API để giả mạo giọng người khác, lừa đảo.

VietVoice API Documentation

Integrate AI voices into your app/website. Base URL: https://vietvoice.click

1. Get an API key

Sign up at vietvoice.click and top up characters.
Go to Account → API Keys → Create new key. The key is shown once — save it.

2. Authentication

Send the key in the header of every request:

# Required header
Authorization: Bearer vv_xxxxxxxxxxxxxxxx

3. Generate speech

POST /api/v1/speech

Parameter	Type	Description
`input`	string *	Text to speak (max 20,000 chars)
`voice`	string	Voice name (default: Hải Đăng). See `/api/v1/voices`
`response_format`	string	Always returns `wav`

curl https://vietvoice.click/api/v1/speech \
  -H "Authorization: Bearer vv_..." \
  -H "Content-Type: application/json" \
  -d '{"input": "Hello!", "voice": "Hải Đăng"}' \
  --output audio.wav

✅ Success: HTTP 200, body is a WAV file (48kHz).
💰 Deducts 1 char / 1 text character — same as web generation.

4. List voices

GET /api/v1/voices

5. Check balance

GET /api/auth/me

Returns balance (remaining characters) and account info.

6. Error codes

Code	Meaning
`401`	Missing/invalid API key
`402`	Out of characters — top up in Studio
`429`	Engine busy — retry in a few seconds

7. Notes

Keep your API key secret; never expose it in public frontend code.
Revoke leaked keys immediately in your Account page.
Using the API to impersonate others or commit fraud is prohibited.

← Về trang chủ