Код мови: uk

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

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

Отримати ключ API Швидкий старт Підтримувані мови

Останнє оновлення: · Markdown

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

Задайте 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"}'

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

ПараметрДеталі
Код в APIuk
Самоназваукраїнська
Напрям письмаЗліва направо
Автовизначення мовиТак: не вказуйте 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".

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

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