API Reference

X-API-Key: ick_your_api_key_here

curl -X POST https://iclever-tts.yez.vn/api/v1/auth/register \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","password":"mật-khẩu-từ-6-ký-tự","name":"Tên của bạn"}'

# Login: POST /api/v1/auth/login với email và password.
# Refresh: POST /api/v1/auth/refresh, header Authorization: Bearer <refresh_token>.
# Current user/quota: GET /api/v1/auth/me, header Authorization: Bearer <access_token>.

{
  "job_id":      "a1b2c3d4e5f6",
  "audio_url":   "/outputs/a1b2c3d4e5f6.wav",
  "format":      "wav",
  "model":       "edge",
  "voice_id":    "en-US-JennyNeural",
  "characters":  42,
  "duration_ms": 1843
}

{
  "model":    "vieneu",
  "language": "vi",
  "count":    13,
  "voices": [
    {
      "id":           "Ngọc Lan",
      "name":         "Ngọc Lan",
      "gender":       "female",
      "region":       "south",
      "region_label": "Miền Nam",
      "provider":     "vieneu"
    },
    {
      "id":           "vi-VN-HoaiMyNeural",
      "name":         "Hoài My",
      "gender":       "female",
      "region":       "north",
      "region_label": "Miền Bắc",
      "provider":     "edge"
    }
  ]
}

{
  "model":    "edge",
  "language": "en",
  "count":    14,
  "voices": [
    {
      "id":       "en-US-JennyNeural",
      "name":     "Jenny",
      "gender":   "female",
      "accent":   "en-US",
      "provider": "edge",
      "language": "en"
    },
    {
      "id":          "xtts_en_female",
      "name":        "Female (English)",
      "gender":      "female",
      "provider":    "xtts",
      "clone_voice": true
    }
  ]
}

{
  "languages": [
    { "code": "vi", "name": "Tiếng Việt", "flag": "🇻🇳", "models": ["vieneu", "edge", "vbee"] },
    { "code": "en", "name": "English",    "flag": "🇬🇧", "models": ["edge", "xtts"] },
    { "code": "zh", "name": "中文",        "flag": "🇨🇳", "models": ["edge", "xtts"] },
    // … 11 more languages
  ]
}

{
  "active_model": "edge",
  "models": [
    { "id": "vieneu",    "status": "active",      "is_active": false },
    { "id": "edge",      "status": "active",      "is_active": true  },
    { "id": "xtts",      "status": "active",      "is_active": false },
    { "id": "cosyvoice2", "status": "coming_soon", "is_active": false }
  ]
}

{
  "status":       "ok",
  "active_model": "edge",
  "vieneu_ready": true,
  "timestamp":    "2026-06-20T10:30:00"
}

curl -X POST https://iclever-tts.yez.vn/api/v1/asr/transcribe \
  -H 'X-API-Key: YOUR_API_KEY' \
  -F '[email protected]' -F 'language=vi'

# Status/model: GET /api/v1/asr/status

{
  "active_model": "edge"   // vieneu | edge | xtts | vbee
}

{
  "vbee_config": {
    "app_id": "app_xxxx",
    "token": "eyJhbGci..."
  }
}

import requests

API_BASE = "https://iclever-tts.yez.vn"
API_KEY  = "ick_your_key"
HEADERS  = {"X-API-Key": API_KEY, "Content-Type": "application/json"}

def synthesize(text, language="vi", voice_id=None, model=None):
    payload = {
        "text":     text,
        "language": language,   # "vi" | "en" | "zh" | "ja" | …
        "voice_id": voice_id,
        "model":    model,       # None = use active model
        "format":   "wav",
    }
    r = requests.post(f"{API_BASE}/api/v1/synthesize", json=payload, headers=HEADERS)
    r.raise_for_status()
    data = r.json()
    audio = requests.get(f"{API_BASE}{data['audio_url']}")
    with open("output.wav", "wb") as f:
        f.write(audio.content)
    return data

# Tiếng Việt — giọng Miền Bắc (Microsoft Neural)
synthesize("Xin chào, đây là iClever TTS.", language="vi", voice_id="vi-VN-HoaiMyNeural", model="edge")

# English — Jenny (American)
synthesize("Hello, this is iClever TTS.", language="en", voice_id="en-US-JennyNeural")

# Tiếng Trung — Phổ thông
synthesize("你好，这是 iClever TTS。", language="zh", voice_id="zh-CN-XiaoxiaoNeural")

# Lấy danh sách giọng cho tiếng Anh
r = requests.get(f"{API_BASE}/api/v1/voices", params={"lang": "en"}, headers=HEADERS)
voices = r.json()["voices"]

const API_BASE = 'https://iclever-tts.yez.vn';
const API_KEY  = 'ick_your_key';
const headers  = { 'Content-Type': 'application/json', 'X-API-Key': API_KEY };

async function synthesize({ text, language = 'vi', voiceId = null, model = null }) {
  const res = await fetch(`${API_BASE}/api/v1/synthesize`, {
    method: 'POST', headers,
    body: JSON.stringify({
      text,
      language,            // 'vi' | 'en' | 'zh' | 'ja' | 'ko' | …
      voice_id: voiceId,
      model,
      format: 'wav',
    }),
  });
  const data = await res.json();
  new Audio(`${API_BASE}${data.audio_url}`).play();
  return data;
}

// Tiếng Việt — giọng Nam Minh (Miền Bắc)
await synthesize({ text: 'Xin chào!', language: 'vi', voiceId: 'vi-VN-NamMinhNeural' });

// English — British male
await synthesize({ text: 'Hello from London.', language: 'en', voiceId: 'en-GB-RyanNeural' });

// 日本語
await synthesize({ text: 'こんにちは！', language: 'ja', voiceId: 'ja-JP-NanamiNeural' });

// Fetch English voices
const { voices } = await fetch(`${API_BASE}/api/v1/voices?lang=en`, { headers }).then(r => r.json());

curl -X POST https://iclever-tts.yez.vn/api/v1/synthesize \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ick_your_key" \
  -d '{
    "text":     "Xin chào, đây là iClever TTS.",
    "language": "vi",
    "voice_id": "vi-VN-HoaiMyNeural",
    "model":    "edge",
    "format":   "wav"
  }'

curl -X POST https://iclever-tts.yez.vn/api/v1/synthesize \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ick_your_key" \
  -d '{
    "text":     "Hello, this is iClever TTS.",
    "language": "en",
    "voice_id": "en-US-JennyNeural",
    "model":    "edge"
  }'

curl "https://iclever-tts.yez.vn/api/v1/voices?lang=zh" \
  -H "X-API-Key: ick_your_key"

curl -X POST https://iclever-tts.yez.vn/api/v1/clone \
  -H "X-API-Key: ick_your_key" \
  -F "text=This voice is cloned from a 6-second sample." \
  -F "language=en" \
  -F "model=xtts" \
  -F "ref_audio=@/path/to/sample.wav"