Source: https://ailoot.ai/docs/uz/api/audio/
Canonical: https://ailoot.ai/docs/uz/api/audio/
Language: uz

[API](https://ailoot.ai/docs/uz/) 

# Audio

[Markdown](https://ailoot.ai/docs/uz/api/audio/index.md)

OpenAI Audio formatida matnni ovozlashtirish (TTS) va nutqni tanish (STT).

POST`https://api.ailoot.ai/v1/audio/speech`

Audio

```bash
# Ovozlashtirish
curl https://api.ailoot.ai/v1/audio/speech \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "qwen-audio-3.0-tts-plus", "input": "Assalomu alaykum! Bu ovozlashtirish misoli.", "voice": "longanlingxin"}' \
  --output speech.mp3

# Nutqni tanish
curl https://api.ailoot.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -F model=qwen-asr \
  -F file=@meeting.wav
```

```python
# Nutqni tanish
with open("meeting.wav", "rb") as f:
    tr = client.audio.transcriptions.create(model="qwen-asr", file=f)
print(tr.text)
```

200 OK · nutqni tanish

```json
{
  "text": "Assalomu alaykum, hamkasblar. Hafta yakunlaridan boshlaymiz…"
}
```

## Avtorizatsiya

| Parametr | Tur | Majburiy | Tavsif |
| --- | --- | --- | --- |
| `Authorization` | header | majburiy | Kalit quyidagi ko‘rinishda: `Bearer sk-…`. Quyidagi sarlavhalar ham mos keladi: `x-api-key` yoki `x-goog-api-key`. |

## Ovozlashtirish: so‘rov tanasi

| Parametr | Tur | Majburiy | Tavsif |
| --- | --- | --- | --- |
| `model` | string | majburiy | Ovozlashtirish modeli: `gemini-3.8-flash-tts`, `qwen-audio-3.0-tts-plus`, `speech-2.8-turbo`, `gemini-3.8-flash-lite-tts`, `speech-2.8-hd`, `gemini-3.1-flash-tts-preview`, `speech-2.6-turbo`, `speech-2.6-hd`, `speech-02-turbo`, `speech-02-hd`. |
| `input` | string | majburiy | Ovozlashtiriladigan matn. MiniMax modellarida — 10 000 ta belgidan kam, `qwen-audio-3.0-tts-plus` modelida esa — 600 tagacha. |
| `voice` | string |  | Ovoz. **MiniMax modellari uchun majburiy** (`speech-2.8-hd` va boshqa `speech-…`): MiniMax ovoz identifikatori (lotin harflari, raqamlar, `_` va `-`, 128 ta belgigacha). `qwen-audio-3.0-tts-plus` uchun standart qiymat `longanlingxin`, Gemini TTS modellarida esa — `Kore`. |
| `response_format` | string | ixtiyoriy | MiniMax uchun — faqat `mp3`; `qwen-audio-3.0-tts-plus` — `mp3`, `wav` yoki `pcm`; Gemini TTS uchun — `wav` yoki `json` (faylga havola). |

Javob — audiofayl (MiniMax uchun — `audio/mpeg`). To‘lov — katalogda ko‘rsatilganidek, matn belgilari yoki tokenlar uchun.

## Nutqni tanish

POST`https://api.ailoot.ai/v1/audio/transcriptions`

| Parametr | Tur | Majburiy | Tavsif |
| --- | --- | --- | --- |
| `file` | file | majburiy | WAV audiofayli quyidagi formatda: `multipart/form-data`. `qwen-asr`, `qwen-asr-latest` va `qwen-audio-3.0-asr-flash`: davomiyligi 5 daqiqagacha bo‘lgan butun, siqilmagan PCM WAV; fayl hajmi taxminan 7,5 MB gacha (base64 shaklida — 10 MB gacha). `asr-1.0`: davomiyligi 500 soniyagacha va hajmi 50 MB gacha bo‘lgan PCM WAV. `gemini-3.5-transcribe`: hajmi 64 MB gacha bo‘lgan WAV. |
| `model` | string | majburiy | Nutqni tanish modeli: `gemini-3.5-transcribe`, `qwen-audio-3.0-asr-flash`, `asr-1.0`. |
| `response_format` | string | ixtiyoriy | Faqat `json` (yoki ko‘rsatmaslik mumkin). |

Maydon: `language` bu modellar tomonidan ishlatilmaydi. Javob: `{"text": "…"}`. To‘lov — yozuv davomiyligi uchun (soniya, daqiqa yoki soat — har bir modelning o‘z birligi bor).

## Real vaqtdagi ovoz

Quyidagi model uchun: `qwen-audio-3.0-realtime-plus` WebSocket oching: `wss://api.ailoot.ai/v1/realtime?model=qwen-audio-3.0-realtime-plus` Quyidagi sarlavha bilan: `Authorization: Bearer <API_KEY>`. Kalitni server tomonidan uzating: URL so‘rov satri orqali berilgan kalit qabul qilinmaydi. Quyidagi hodisani kuting: `session.created` tanlangan model bilan; keyin sozlamalar, xabar va quyidagi hodisani yuboring: `response.create`. Quyida audioseansda matnli javob uchun ketma-ket keladigan uchta JSON matn freymi keltirilgan:

```json
{"type":"session.update","session":{"modalities":["text"],"turn_detection":null,"max_history_turns":20,"instructions":"Qisqa javob bering."}}
```

```json
{"type":"conversation.item.create","item":{"type":"message","role":"user","content":[{"type":"input_text","text":"Ha deng."}]}}
```

```json
{"type":"response.create"}
```

Javob hodisalarini quyidagi hodisagacha o‘qing: `response.done` va uning yakuniy usage qiymatini oling; xatolar quyidagi hodisa orqali keladi: `error`. To‘lov — har bir tasdiqlangan javobning matn va audio tokenlari uchun. Audio kirishi: quyidagi hodisa: `input_audio_buffer.append` quyidagiga ega: `audio` — base64 PCM16 mono 16 kHz; keyin `input_audio_buffer.commit` va `response.create`. Audio chiqishi — PCM16 mono 24 kHz. Bu seansda ikkilik freymlar qabul qilinmaydi.

Qo‘llab-quvvatlanadigan mijoz hodisalari: `session.update`, `input_audio_buffer.append/commit/clear`, `response.create/cancel`, `conversation.item.create/retrieve/delete`. Suhbat elementlari — faqat xabarlar/matn; funksiya vositalari, veb qidiruv va voiceprint qo‘llab-quvvatlanmaydi. Seans limitlari: 600 soniya, 20 javob, tarixdagi 20 ta muloqot navbati, instructions uchun 2000 bayt va mijoz matni uchun 8000 bayt. Faoliyatsizlikdagi kutish muddati konfiguratsiyaga bog‘liq (standart qiymat — 60 soniya).

Bu yerda quyidagi modelning ovozli rejimi tasvirlangan: `qwen-audio-3.0-realtime-plus`; boshqa real vaqtdagi modellarning o‘z qoidalari bor. Quyidagi yo‘l: `/v1/realtime/sessions` va vaqtinchalik tokenlar (ephemeral tokens) qo‘llab-quvvatlanmaydi.

Savollaringiz qoldimi? Request ID va tavsifni yuboring — tushunishga yordam beramiz.[Yordam xizmatiga yozish](mailto:support@ailoot.ai)

## Ailoot · Kompaniya va uning loyihalar portfeli





Ailoot to‘plangan faoliyat tajribasi, keng mijozlar bazasi, barqaror xizmat va doimiy KPI nazoratiga tayanadi.





Kompaniya va uning loyihalar portfeli: millionlab mijozlar; oylik sotuvlar hajmi milliardlarda.





Ailoot bu faoliyat tajribasini mijozlar mahsulotlari, agentlar, ilovalar va avtomatlashtirishlarda AI imkoniyatlariga API orqali kirishni ta’minlashda qo‘llaydi.