Как избежать таймаутов при AI-транскрибации?
Пользователь загружает 40-минутную запись совещания — и ждёт текст. Если на сервер уходит сырой MP4 весом 300 МБ, а обратно приходит JSON через 90 секунд, UX сломан ещё до первого слова. Мы выстраиваем пайплайн, в котором мобильный клиент не просто отправляет файл, а участвует в подготовке данных: нарезка, конвертация, чанкование — и получает результат постепенно, пока модель ещё работает. Специализируемся на интеграции AI-транскрибации под ключ, учитывая особенности платформы и ограничения API. Более 5 лет опыта в мобильной разработке и 15+ реализованных пайплайнов транскрибации для iOS и Android с суммарным объёмом свыше 10 000 часов аудио.
Самая частая ошибка — отправлять файл целиком через URLSession.dataTask или OkHttp с дефолтными таймаутами. На файлах свыше 50 МБ это приводит к NSURLErrorTimedOut (iOS) или SocketTimeoutException (Android) в 70% случаев. Сервер часто отвечает 413 Entity Too Large, если лимит не согласован. На устройствах с 2 ГБ RAM буферизация всего файла в память вызывает OOM — особенно при работе с видео.
Почему VAD критически важен для точности?
Чанкование по 60 секунд без учёта пауз режет слова пополам — транскрипция разбивает «транскрибация» на «транс» и «крибация». Voice Activity Detection (VAD) нарезает по реальным паузам: на iOS используем AVAudioEngine с порогом -45 dBFS, на Flutter — пакет voice_activity_detector (WebRTC VAD). Это повышает точность распознавания на 15–20% для неформальной речи по сравнению с равномерным чанкованием.
Типичные настройки VAD:
| Параметр | Рекомендованное значение | Замечание |
|---|---|---|
min_speech_duration |
0.8 s | Не менее 0.5 с для коротких фраз |
min_silence_duration |
1.2 s | Увеличить до 2 с для интервью |
threshold |
-45 dBFS | Для тихих записей — -35 dBFS |
frame_size |
30 ms | 10–30 ms по WebRTC |
Как настроить VAD под свои данные
- Запишите 10-минутный образец речи на целевом устройстве.
- Прогоните через VAD с дефолтными параметрами и визуализируйте границы чанков.
- Откорректируйте
min_speech_durationиthresholdтак, чтобы чанки не обрезали начало/конец фраз. - Проверьте на нескольких файлах разной громкости и фонового шума.
Как конвертировать кодеки без потерь?
Whisper API принимает audio/wav, mp3, mp4, ogg, но не все кодеки внутри. .mov с pcm_s16le — ок, с ac3 — 400 Bad Request. На iOS AVAssetExportSession с пресетом AVAssetExportPresetAppleM4A покрывает 95% форматов. На Android — MediaExtractor + MediaCodec (PCM) → MediaMuxer (AAC). Для экзотических кодеков добавляем FFmpeg (mobile-ffmpeg-full-gpl на Android, ffmpegkit на iOS).
Подробнее о конвертации кодеков
Если стандартные средства не справляются, используется FFmpeg с настройками: `-acodec pcm_s16le -ar 16000 -ac 1` для Mono WAV, который гарантированно принимают все API.Как строится пайплайн на практике
Подготовка файла на устройстве
// iOS: Извлечь аудиодорожку из видео
let asset = AVURLAsset(url: videoURL)
let exportSession = AVAssetExportSession(asset: asset, presetName: AVAssetExportPresetAppleM4A)!
exportSession.outputFileType = .m4a
exportSession.outputURL = tempAudioURL
await exportSession.export()
После экспорта — разбивка на чанки по 25 МБ (лимит Whisper API) с учётом VAD-границ. Каждый чанк загружается через URLSession.uploadTask(with:fromFile:) с фоновой конфигурацией (URLSessionConfiguration.background), чтобы загрузка продолжалась при сворачивании приложения.
На Android аналогично: WorkManager с CoroutineWorker для фоновой обработки, OkHttp с RequestBody.create через File, а не через ByteArray — это критично для экономии памяти на устройствах с 2 ГБ RAM.
Стриминг результата
Вместо polling каждые N секунд — WebSocket или SSE. Если используешь собственный бэкенд поверх Whisper, сервер может стримить partial_transcript по мере обработки чанков. На клиенте это URLSessionWebSocketTask (iOS) или OkHttp WebSocket (Android), который добавляет строки в StateFlow / @Published — UI обновляется в реальном времени.
Для прямой интеграции с OpenAI Whisper API стриминга нет — API синхронный. Поэтому при большом файле разбивай на независимые запросы и мержи результаты на клиенте по индексу чанка, а не по порядку ответов (сеть не гарантирует порядок).
Хранение и постобработка
Сырой транскрипт из Whisper возвращает segments с временными метками — это ценнее, чем просто текст. Храни JSON с start, end, text для каждого сегмента: это позволяет реализовать «тап на слово → перемотка аудио».
Для постобработки — пунктуация и диаризация (кто говорил). Whisper не разделяет спикеров. Для этого нужен отдельный шаг: pyannote.audio через API или AssemblyAI с параметром speaker_labels: true. На клиенте просто мержишь два JSON по временным меткам.
Сравнение провайдеров
| Провайдер | Точность (RU) | Стриминг | Диаризация | Лимит файла |
|---|---|---|---|---|
| OpenAI Whisper | Высокая | Нет | Нет | 25 МБ |
| AssemblyAI | Средняя | Да | Да | 5 ГБ |
| Deepgram Nova-2 | Высокая | Да | Да | Нет лимита |
| Google Speech-to-Text v2 | Средняя | Да | Да | 1 ГБ |
| On-device (iOS CoreML) | Средняя | Нет | Нет | Ограничен RAM |
Для русского языка Whisper large-v3 даёт на 30% более высокую точность, чем Google Speech-to-Text, особенно на неформальной речи и техническом жаргоне. Deepgram Nova-2 с параметром language: ru — хороший вариант, если нужен реалтайм. Снижение затрат на транскрибацию может достигать 40% при выборе правильного провайдера.
OpenAI Whisper documentation
Что входит в работу
- Аудит форматов — определяем средний размер файла, кодеки, язык, требования к диаризации.
- Выбор провайдера и архитектуры — рекомендация по модели (Whisper, Deepgram, AssemblyAI) и стратегии загрузки.
- Разработка пайплайна — подготовка файла, чанкование, фоновая загрузка, стриминг результата.
- Интеграция постобработки — пунктуация, диаризация, синхронизация с UI.
- Тестирование на реальных устройствах — в том числе с CoreML и MediaCodec.
- Документация — описание API, схемы потоков данных, инструкции по доработке.
- Поддержка после сдачи — настройка мониторинга, исправление ошибок, консультации.
Процесс работы
Начинаем с аудита: формат файлов, средний размер, языки, нужна ли диаризация, есть ли требования к офлайн-работе. Под это выбираем провайдера и архитектуру пайплайна.
Разработка идёт поэтапно: сначала базовый upload + транскрипция без оптимизаций, затем добавляем чанкование, фоновую загрузку, стриминг UI, постобработку. Каждый этап — отдельная ветка с функциональным тестом на реальных устройствах (не симулятор — CoreML и MediaCodec ведут себя по-разному на реальном железе).
Срок от интеграции простого Whisper API до полноценного пайплайна с диаризацией и фоновой загрузкой — от 2 до 6 недель в зависимости от платформы и требований. Стоимость интеграции рассчитывается индивидуально после аудита.
Свяжитесь с нами для бесплатного аудита ваших файлов — это займёт не более часа. Закажите интеграцию и получите работающий пайплайн в кратчайшие сроки.







