Код мови: uk
API для розпізнавання мовлення українською
KolWrite перетворює аудіо й відео українською мовою на текст одним викликом REST API. Передайте URL файлу разом із "language": "uk", і у відповіді отримаєте сегменти з часовими мітками слів та мітками мовців у форматі JSON, TXT або SRT. Моделі Oracle в межах того самого запиту можуть перекласти українське мовлення англійською або будь-якою зі 100 підтримуваних мов.
Транскрибація українською одним запитом
Задайте language зі значенням uk і запустіть завдання. Результат можна отримати через GET /transcribe/{jobId} або заздалегідь передати webhook_url.
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):
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, тому перед вибором перевірте модель на вибірці власних записів. Повне порівняння є на сторінці моделі та ціни (англійською).
Поширені запитання
Чи варто покладатися на автовизначення української?
Передавайте language: "uk". Українська й російська мають багато спільних звуків і слів, тому на коротких записах автовизначення може помилитися.
Чи можна перекласти українське аудіо англійською?
Так. Скористайтеся моделлю Oracle і вкажіть translate_to: "en".
Які символи використовуються в розшифровці?
Український кириличний алфавіт, зокрема і, ї, є та ґ.