# API для розпізнавання мовлення українською

> KolWrite перетворює аудіо й відео українською мовою на текст одним викликом REST API. Передайте URL файлу разом із "language": "uk", і у відповіді отримаєте сегменти з часовими мітками слів та мітками мовців у форматі JSON, TXT або SRT. Моделі Oracle в межах того самого запиту можуть перекласти українське мовлення англійською або будь-якою зі 100 підтримуваних мов.

Останнє оновлення: 2026-11-21 · HTML: https://console.kolwrite.com/uk/speech-to-text/ukrainian

## Транскрибація українською одним запитом

Задайте `language` зі значенням `uk` і запустіть завдання. Результат можна отримати через `GET /transcribe/{jobId}` або заздалегідь передати `webhook_url`.

```bash
curl https://app.kolwrite.com/transcribe \
  -H "x-api-key: $KOLWRITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio_url": "https://example.com/interview-uk.m4a", "model": "oracle", "language": "uk", "include_diarization": true, "output_format": "json"}'
```

Щоб у тому самому завданні перекласти українське аудіо англійською (лише моделі Oracle):

```bash
curl https://app.kolwrite.com/transcribe \
  -H "x-api-key: $KOLWRITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio_url": "https://example.com/interview-uk.m4a", "model": "oracle_mini", "language": "uk", "translate_to": "en", "word_timestamps": false, "output_format": "srt"}'
```

## Підтримка української мови: основні параметри

| Параметр | Деталі |
| --- | --- |
| Код в API | `uk` |
| Самоназва | українська |
| Напрям письма | Зліва направо |
| Автовизначення мови | Так: не вказуйте `language` або передайте `"auto"` |
| Переклад з української | На будь-яку зі 100 підтримуваних мов (у моделях Oracle) |
| Переклад з інших мов українською | Так: `translate_to: "uk"` у моделях Oracle |
| Результат | JSON (сегменти, часові мітки слів, мовці), TXT, SRT |
| Ціна | Від 0,48 USD (Base) до 3,60 USD (Oracle Max) за годину аудіо; 1,44 USD для Oracle |

## Особливості транскрибації українською

- В українській є літери, яких немає в російській: і, ї, є, ґ. Завжди передавайте `uk` явно, бо автовизначення на коротких записах може сплутати українську з російською.
- У записах часто трапляється змішування української й російської мов (суржик), але завдання приймає лише один код мови. Передавайте код тієї мови, яка переважає в аудіо.
- Апостроф в українській записують по-різному: ', ’ або ʼ. Перед порівнянням і пошуком нормалізуйте їх до одного символу, але не прибирайте апостроф зі слів на кшталт м’ясо: він є частиною правопису.
- Іменники й прізвища відмінюються (Київ, у Києві). Перед пошуком іменованих сутностей зводьте слова до початкової форми (лематизація).
- Відкривайте файли SRT у кодуванні UTF-8, щоб літери і, ї, є, ґ коректно відображалися в програвачі чи редакторі.

## Де команди використовують транскрибацію українською

- Інтерв’ю для журналістських і документальних проєктів із перекладом англійською через `translate_to: "en"`.
- Субтитри для українських медіа та суспільних мовників.
- Сервіси для українців, які живуть за кордоном.

## Вибір моделі

Для українського аудіо в продакшені почніть із моделі `oracle` (1,44 USD за годину). Якщо у вас багато чистих записів з одним мовцем, достатньо `base` (0,48 USD). Найдешевший переклад дає `oracle_mini` (0,96 USD), а для шумних і складних записів підходять `oracle_pro` та `oracle_max`. KolWrite не публікує показник точності для української в цьому API, тому перед вибором перевірте модель на вибірці власних записів. Повне порівняння є на сторінці [моделі та ціни](https://console.kolwrite.com/models) (англійською).

## Поширені запитання

### Чи варто покладатися на автовизначення української?

Передавайте `language: "uk"`. Українська й російська мають багато спільних звуків і слів, тому на коротких записах автовизначення може помилитися.

### Чи можна перекласти українське аудіо англійською?

Так. Скористайтеся моделлю Oracle і вкажіть `translate_to: "en"`.

### Які символи використовуються в розшифровці?

Український кириличний алфавіт, зокрема і, ї, є та ґ.

## Пов’язані сторінки

- [API для розпізнавання мовлення польською](https://console.kolwrite.com/pl/speech-to-text/polish)
- [API для розпізнавання мовлення російською](https://console.kolwrite.com/ru/speech-to-text/russian)
- [Сценарії для досліджень (англійською)](https://console.kolwrite.com/use-cases/researchers)
- [Сценарії для медіа, подкастів і субтитрів (англійською)](https://console.kolwrite.com/use-cases/media)
- [Список підтримуваних мов (англійською)](https://console.kolwrite.com/languages/)

---
Отримати ключ API: https://console.kolwrite.com/auth · Документація API: https://console.kolwrite.com/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt
