Sota Voice
Tài liệu

Bắt đầu nhanh

Ba bước để có file audio đầu tiên - tạo khóa, nạp credit, chạy code.

Xem dạng Markdown

1. Tạo khóa API

Đăng nhập, vào Khóa API trong dashboard và bấm Tạo khóa. Khóa có dạng sk_live_... và chỉ hiện một lần lúc tạo: hãy lưu ngay vào trình quản lý bí mật. Sau đó dashboard chỉ còn hiện phần đầu (prefix) của khóa.

Đặt khóa vào biến môi trường để các ví dụ dưới đây dùng được:

export SOTA_API_KEY="sk_live_..."

Không bao giờ đưa khóa vào code chạy trên trình duyệt. Xem Xác thực.

2. Nạp credit

Vào Credit trong dashboard, chọn gói và chuyển khoản theo mã VietQR. Credit được cộng khi giao dịch về, không hết hạn. Kiểm tra số dư bằng API:

curl https://voice-be.sotalabs.io/v1/credits \
  -H "Authorization: Bearer $SOTA_API_KEY"
{"object":"credit_balance","available":482300,"unit":"character"}

3. Chạy code

Dùng SDK của OpenAI, chỉ đổi base_url sang gateway Sota Voice và model sang sota-voice-v1.

curl https://voice-be.sotalabs.io/v1/audio/speech \
  -H "Authorization: Bearer $SOTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"sota-voice-v1","voice":"default","input":"Xin chào, đây là Sota Voice.","response_format":"mp3"}' \
  --output speech.mp3

Mở speech.mp3 để nghe. Bạn bị trừ đúng số ký tự của input (ở đây là 28).

Danh sách giọng có sẵn và giọng bạn đã nhân bản: GET /v1/audio/voices. Tham số voice nhận tên giọng có sẵn (ví dụ default, zh_1, en_a) hoặc name của giọng bạn đã nhân bản.

Tiếp theo