Tích hợp giọng nói AI vào ứng dụng của bạn 🚀

API TTS/ASR tiếng Việt chuẩn production — clone giọng 1 lần dùng mãi, streaming realtime, lồng tiếng video, đọc sách dài. Thanh toán trả trước, bảo mật C2PA chống deepfake.

🚀 Đăng ký miễn phí 🎧 Dùng thử Playground 👨‍👩‍👧 Hướng dẫn người dùng 📊 Hướng dẫn Dashboard 🤖 Agent thông minh 📊 Báo cáo doanh thu 📱 Tải App Android (APK)

⚡ Quickstart

1. Lấy API key (sk-vs-*) từ Dashboard → API Keys

2. Gọi TTS:

curl -X POST https://studio.skynet.ai.vn/v1/audio/speech \
  -H "Authorization: Bearer sk-vs-XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Xin chào, tôi là giọng nói AI.",
    "voice": "🎤 Nữ trẻ - Nhẹ nhàng",
    "response_format": "wav"
  }' --output speech.wav

3. Nhận dạng giọng nói (ASR):

curl -X POST https://studio.skynet.ai.vn/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-vs-XXXX" \
  -F "file=@speech.wav" \
  -F "language=🌐 Tự động phát hiện"

📌 Quy ước chung

Base URL: https://studio.skynet.ai.vn
Auth: Authorization: Bearer sk-vs-... (API key) hoặc JWT (web)
Quota: 1.000đ = 1.000 ký tự TTS + 100 giây ASR
Rate limit: theo gói (Free 5 rpm, Pro 60+, Enterprise tùy chỉnh)
Format: JSON trả lỗi chuẩn {"detail": "..."}
Bảo mật: mọi audio xuất ra đều nhúng C2PA — truy xuất nguồn gốc, chống deepfake

📦 SDK

🐍 Python

pip install staraivoice

from staraivoice import StarAIVoice
client = StarAIVoice(api_key="sk-vs-XXX",
  base_url="https://studio.skynet.ai.vn")

# TTS đồng bộ
audio = client.tts("Xin chào!", voice="🎤 Nữ trẻ - Nhẹ nhàng")

# Streaming từng câu
for chunk in client.stream("Câu một. Câu hai."):
    player.write(chunk)

# TTS bất đồng bộ
job = client.tts_async("Văn bản dài...")
result = client.wait_job(job["job_id"])

🌐 JavaScript

npm install staraivoice

import { StarAIVoice } from 'staraivoice';
const client = new StarAIVoice({ apiKey: 'sk-vs-XXX' });

const audio = await client.tts({
  input: 'Xin chào!',
  voice: '🎤 Nữ trẻ - Nhẹ nhàng',
});
audio.play();

// Streaming WebSocket
const ws = new WebSocket(
  'wss://studio.skynet.ai.vn/v1/audio/stream?token=sk-vs-XXX');
ws.send(JSON.stringify({ type:'start', input:'Chào bạn!' }));

🔌 Endpoints (195+ — đầy đủ tại Swagger)

📖 Xem toàn bộ 195 paths (103 API /v1, 70 admin, trợ lý, usage...) tại Swagger UI /docs — tự động cập nhật theo code. Dưới đây là các endpoint CHÍNH + mới nhất:

🎤 TTS & ASR

GET/v1/voices

Danh sách giọng — ưu tiên giọng Việt Nam 🎤 lên đầu (10 giọng Việt Lõi TTS 1 + 30 giọng quốc tế). Kèm sample_url nghe thử.

GET/v1/usage

Mức dùng của bạn — số token, chi phí, credit còn lại, theo ngày/endpoint.

GET/v1/assistant/guest-sso

Guest mode — dùng Trợ lý chat thử không cần đăng nhập (không gọi API trả phí).

GET/v1/assistant/config

Cấu hình giọng nói Trợ lý (voice/rate/volume) — admin có thể chỉnh.

GET/admin/tts-engine/config

[Admin] Lõi TTS — chọn Lõi TTS 1 / Lõi TTS 2 / Auto (đổi lúc chạy, có test + rollback).

GET/admin/project-brief

[Admin] Hồ sơ dự án — nhân sự/công cụ/model/hạ tầng. Chỉ super_admin hoặc admin được gắn quyền project_brief.

POST/v1/audio/speech

TTS đồng bộ — trả file audio (wav). Hỗ trợ giọng thường + giọng clone (voice_id clone_<id>). Thêm "streaming": true → trả NDJSON từng câu, phát ngay khi nhận (TTFB ~1.6s).

POST/v1/audio/speech/async

TTS bất đồng bộ — trả job_id, poll /v1/jobs/{id} hoặc webhook.

POST/v1/audio/transcriptions

ASR — nhận dạng giọng nói → text (30+ ngôn ngữ, auto-detect).

POST/v1/tts/long-form

Long-form — text dài tới 200K ký tự → audiobook/podcast (wav/mp3).

POST/v1/voice-changer

Voice Changer — đổi giọng audio (giữ nguyên timing), hỗ trợ giọng clone.

POST/v1/dubbing

Dubbing — lồng tiếng video bằng AI (mp4/mov/mkv, tối đa 200MB).

POST/v1/demo/tts

Demo công khai — 5 lần/phút/IP, không cần key (dùng cho Playground).

🎙️ Voice Library (clone giọng)

POST/v1/voices

Upload giọng mẫu (3-30s) → lưu → nhận voice_id dùng mãi mãi.

GET/v1/voices/mine

Danh sách giọng đã lưu của tài khoản.

DELETE/v1/voices/{voice_id}

Xóa giọng đã lưu.

POST/v1/audio/clone

Clone ngay lập tức (không lưu) — trả audio.

🔌 Streaming & Jobs

WS/v1/audio/stream?token=

Streaming TTS — phát từng câu ngay khi model đọc xong (WebSocket).

GET/v1/jobs · /v1/jobs/{id} · /v1/jobs/{id}/download

Quản lý job async: danh sách, trạng thái, tải kết quả.

POST/v1/webhooks

Đăng ký webhook — nhận thông báo khi job hoàn tất.

💳 Billing & Auth

POST/v1/auth/register · /v1/auth/login · /v1/auth/me

Tài khoản — đăng ký, đăng nhập (JWT), thông tin hiện tại.

POST/v1/billing/topup

Nạp tiền — VNPay / MoMo / VietQR (chọn Vietcombank hoặc MB Bank).

GET/v1/billing/banks · /v1/billing/invoices

Danh sách ngân hàng VietQR · lịch sử hóa đơn.

GET/v1/keys · /v1/models · /v1/usage

API keys · danh sách model/giọng · thống kê sử dụng.

💎 Bảng giá

Free

0đ

5.000 ký tự TTS
600 giây ASR
5 rpm

Starter

99K/tháng

100K ký tự TTS
10K giây ASR
Clone 3 giọng
60 rpm

Pro

499K/tháng

1M ký tự TTS
100K giây ASR
Clone không giới hạn
Dubbing + Long-form
120 rpm

Enterprise

Liên hệ

Không giới hạn
SLAs + hỗ trợ 24/7
Triển khai riêng

Star AI Voice · HNM VIETNAM DEVELOPMENT INVESTMENT., JSC

📍 74 Hoàng Diệu 2, Phường Thủ Đức, TP. HCM · 🏷️ MST 0318778458