Tez boshlash

Ro‘yxatdan o‘tishdan birinchi natijagacha besh daqiqa.

1. Kabinetga kiring va loyiha yarating

console.gapi.uz ni oching, Google orqali kiring va loyiha yarating. Loyiha bu bitta mijoz yoki bitta integratsiyaning sozlamalari, tokenlari va yozuvlari.

2. Birinchi yozuvni kabinetda yuklang

Loyihaning bosh sahifasida mp3, wav, ogg/opus, m4a, flac yoki webm faylni sudrab tashlang. Tanib olish darhol boshlanadi, hech narsa bosish kerak emas. Ish davomida ikkita qadam ko‘rinadi: «Yuklash», jo‘natilgan fayl foizi bilan, va «Tanish», o‘qilgan audio soniyalari bilan. Natija shu sahifada ochiladi: replikalar bo‘yicha matn, so‘zlovchilar va bosilgan replikani aynan o‘ynatadigan pleer.

Opsiyalar yuklashdan oldin tanlanadi: «Tanish opsiyalari» ni oching va keyingi yozuvlar uchun biror narsani yoqing yoki o‘chiring. O‘sha yerda bu qo‘ng‘iroqmi, kiruvchi yoki chiquvchimi, shuni ayting: bu mijozni menejerdan ajratishga yordam beradi.

3. Token yarating

Eng qulayi loyiha sahifasidagi «API orqali ulanish» blokini ochish: token hali bo‘lmasa, u o‘zi yaratiladi va namunalar darhol shu token bilan chiqadi. Tokenni saqlab qo‘ying; kerak bo‘lsa, uni «API tokenlar» bo‘limidan istalgan vaqtda to‘liq nusxalash mumkin. Loyihaning barcha tokenlari «API tokenlar» bo‘limida, u yerda yangisini ham chiqarish mumkin. API ga har bir so‘rov quyidagi sarlavha bilan yuboriladi:

Authorization: Bearer <token>

4. Yozuvni API orqali yuboring

curl -X POST https://console.gapi.uz/v1/jobs \
  -H "Authorization: Bearer $TOKEN" \
  -F file=@call.mp3

Javob:

{"id": "41f79b78-…", "state": "queued", "class": "batch", "estimated_seconds": 283,
 "created_at": "2026-09-10T08:14:03Z", "result_url": "https://console.gapi.uz/v1/jobs/41f79b78-…/result"}

5. Natijani oling

state done bo‘lguncha vazifani har bir-ikki soniyada so‘rab turing va natijani oling:

curl https://console.gapi.uz/v1/jobs/41f79b78-… -H "Authorization: Bearer $TOKEN"
# {"id": "…", "state": "done", …}

curl https://console.gapi.uz/v1/jobs/41f79b78-…/result -H "Authorization: Bearer $TOKEN"

Natijada text (butun matn) va segments (vaqt va so‘zlovchi bilan replikalar) bor. Yana nimalar borligi: Javob formati.

So‘rab turish eng oddiy yo‘l, lekin eng yaxshisi emas. GET /v1/jobs/{id}/events replikalarni tayyor bo‘lgani sari yuboradi, shuning uchun matn oxirida emas, suhbat davomida ko‘rinadi. Agar kutib turadigan hech kim bo‘lmasa, webhook_url ni ko‘rsating — biz o‘zimiz xabar beramiz. Ikkalasi ham: API.

Lug‘at: tanilishi kerak bo‘lgan nomlar

Kompaniya nomi, mahsulotlar, brendlar, xodimlarning ismlari oddiy nutqda uchramaydi, shuning uchun model ular o‘rniga ovozi o‘xshash boshqa so‘zni eshitadi. Loyiha lug‘ati buni tuzatadi: ro‘yxatdagi atamalarni model yozuvlarda tez-tez taniy boshlaydi. Lug‘at tarifni o‘zgartirmaydi va loyihaning barcha keyingi yozuvlariga ta’sir qiladi.

Kabinetda ro‘yxat «Lug‘at» bo‘limida. API orqali:

curl -X PUT https://console.gapi.uz/v1/vocabulary \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"terms": ["MetaSell", "Bitrix24", "amoCRM", "Toshkent"]}'

1 tadan 20 tagacha atama, har birida ko‘pi bilan 4 so‘z. Ro‘yxat ataylab qisqa: u qanchalik qisqa bo‘lsa, model kerakli so‘zni shunchalik aniq topadi, shuning uchun butun katalogni emas, faqat suhbatlarda haqiqatan yangraydiganini kiriting.

Lug‘at loyihaga tegishli: vazifa yaratilganda faol versiyaning nusxasini oladi, shuning uchun tahrir allaqachon yuborilgan ishni qayta yozmaydi. Har bir saqlash yangi versiya va u kabinetda ko‘rinadi, shuning uchun noto‘g‘ri tahrir yo‘qotish emas, bir qadam orqaga.

Atamalar faqat bitta yozuv uchun kerak bo‘lsa, ularni fayl bilan birga yuboring — yuklashdagi vocabulary maydoni bilan. Bunday ro‘yxat faqat shu vazifaga ishlaydi: loyiha lug‘ati o‘zgarmaydi. Batafsil: API.

Qisqa yozuvlar bitta so‘rov bilan

5 daqiqagacha bo‘lgan yozuvlarni vazifasiz, sinxron tanish mumkin:

curl -X POST https://console.gapi.uz/v1/transcribe \
  -H "Authorization: Bearer $TOKEN" \
  -F file=@short.mp3

Javob darhol, natija ichida keladi.

Bitta so‘rov uchun sozlamalar

Loyiha sozlamalari barcha yozuvlarga qo‘llanadi. Bitta yozuv uchun ularni settings maydoni bilan o‘zgartirish mumkin:

curl -X POST https://console.gapi.uz/v1/jobs \
  -H "Authorization: Bearer $TOKEN" \
  -F file=@call.mp3 \
  -F 'settings={"speaker_roles":true,"call_direction":"inbound","pii":false}'

Barcha kalitlar Opsiyalar bo‘limida tasvirlangan, qo‘ng‘iroq, yig‘ilish va intervyu uchun tayyor to‘plamlar esa Ssenariylar da.