← Bosh sahifa

Dasturchilar uchun: Notiq TTS API

Matn yuborasiz — ovoz qaytadi. Roʻyxatdan oʻtish va kalit talab qilinmaydi: bu sinov uchun ochilgan xizmat.

Bir daqiqada sinab koʻring

Quyidagi buyruqni terminalda bajaring. Natijada nutq.wav fayli paydo boʻladi.

curl
curl -X POST https://tts.wcag.uz/api/v1/tts \
  -H "Content-Type: application/json" \
  -d '{"text": "Assalomu alaykum!", "voice": 1}' \
  --output nutq.wav

Manzillar

Asosiy manzil: https://tts.wcag.uz/api/v1. Soʻrov va javoblar UTF-8 kodlashida; soʻrov tanasi JSON koʻrinishida yuboriladi.

POST/tts — toʻliq fayl

Matnni ovozlashtiradi va tayyor WAV faylini qaytaradi (24 kHz, 16 bit, bitta kanal). Qisqa matnlar uchun eng qulay yoʻl.

POST/stream — boʻlaklab uzatish

Ovozni tayyor boʻlgani sari, boʻlaklab yuboradi: birinchi boʻlak odatda 0,2 soniya ichida keladi. Javob — sarlavhasiz xom tovush oqimi (PCM, 24 kHz, 16 bit, little-endian, bitta kanal). Uzun matnlarda va ovozni kutmasdan ijro etish kerak boʻlganda foydalaning.

GET/voices — ovozlar roʻyxati

Mavjud ovozlar, tovush chastotasi va cheklovlarni JSON koʻrinishida qaytaradi.

Soʻrov parametrlari

text
Majburiy. Ovozlashtiriladigan matn, 600 ta belgigacha. Sonlar, sanalar va qisqartmalarni raqam bilan yozish mumkin — tizim ularni oʻzi oʻqiydi. Tartib sonlar chiziqcha bilan yoziladi: 5-may, 3-qavat.
voice
Ixtiyoriy, odatda 1. Ovoz raqami: 1, 2, 5 — ayol ovozlari, 3, 4 — erkak ovozlari.
speed
Ixtiyoriy, odatda 1.0. Nutq tezligi, 0.5 dan 2.0 gacha: 2.0 — ikki barobar tez.

Javob kodlari

200
Muvaffaqiyatli. Javob tanasida tovush.
400
Soʻrov notoʻgʻri: matn boʻsh yoki juda uzun, ovoz raqami yoki tezlik chegaradan tashqarida. Sababi error maydonida yoziladi.
429
Soʻrovlar juda koʻp. Bir daqiqadan soʻng qayta urinib koʻring.
500
Xizmatdagi nosozlik.

Cheklovlar

Misollar

Python — toʻliq fayl
import requests

javob = requests.post(
    "https://tts.wcag.uz/api/v1/tts",
    json={"text": "Assalomu alaykum!", "voice": 1, "speed": 1.0},
    timeout=60,
)
javob.raise_for_status()
with open("nutq.wav", "wb") as fayl:
    fayl.write(javob.content)
Python — boʻlaklab qabul qilish
import requests, wave

with requests.post(
    "https://tts.wcag.uz/api/v1/stream",
    json={"text": "Uzun matn shu yerga yoziladi.", "voice": 4},
    stream=True, timeout=60,
) as javob, wave.open("nutq.wav", "wb") as fayl:
    javob.raise_for_status()
    fayl.setnchannels(1); fayl.setsampwidth(2); fayl.setframerate(24000)
    for bolak in javob.iter_content(chunk_size=4096):
        fayl.writeframes(bolak)      # har bir bo'lak kelishi bilan ishlatish mumkin
JavaScript — brauzerda ijro etish
const javob = await fetch("https://tts.wcag.uz/api/v1/tts", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ text: "Assalomu alaykum!", voice: 2 }),
});
if (!javob.ok) throw new Error((await javob.json()).error);
const audio = new Audio(URL.createObjectURL(await javob.blob()));
audio.play();

Shu yerning oʻzida sinab koʻring