Bir daqiqada sinab koʻring
Quyidagi buyruqni terminalda bajaring. Natijada nutq.wav fayli paydo boʻladi.
curl -X POST https://tts.wcag.uz/api/v1/tts \
-H "Content-Type: application/json" \
-d '{"text": "Assalomu alaykum!", "voice": 1}' \
--output nutq.wavManzillar
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.5dan2.0gacha: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
errormaydonida yoziladi. 429- Soʻrovlar juda koʻp. Bir daqiqadan soʻng qayta urinib koʻring.
500- Xizmatdagi nosozlik.
Cheklovlar
- Bitta soʻrovda 600 ta belgigacha matn.
- Bitta manzildan daqiqasiga 60 tagacha soʻrov.
- Xizmat sinov rejimida ishlaydi: uzluksiz ishlashi kafolatlanmaydi, manzillar va parametrlar oʻzgarishi mumkin.
- Brauzerdan toʻgʻridan toʻgʻri murojaat qilish mumkin (CORS ochiq).
Misollar
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)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 mumkinconst 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();