Як влаштований мультимодальний ввід
Ми часто бачимо, як замовники хочуть додати в додаток голосовий ввід з AI-відповіддю, але стикаються з неочевидними технічними обмеженнями. Наприклад, типова проблема — користувач диктує повідомлення, але модель не розуміє контекст, тому що аудіо обрізане або частота дискретизації непідходяща. Розповімо, як ми вирішуємо такі завдання на iOS та Android, використовуючи Whisper API та мультимодальні моделі (GPT-4o Audio, Gemini 1.5 Pro). Наш досвід показує, що правильний вибір стеку скорочує час розробки на 30%. Замовте консультацію — ми допоможемо обрати оптимальний шлях.
Два архітектурних шляхи
Шлях 1: STT + LLM. Whisper API або аналоги перетворюють аудіо в текст, текст йде в messages[]. Працює з будь-якою LLM, дешево, передбачувано. Проблема — подвійна затримка: спочатку чекаємо транскрипцію (1–3 с для 30-секундного фрагмента), потім відповідь моделі. Користувач дивиться в екран 5–10 секунд.
Шлях 2: нативний аудіо-ввід. GPT-4o Audio Preview, Gemini 1.5 Pro приймають input_audio прямо в content[]. Затримка менша, модель «чує» інтонацію, паузи, акцент. Обмеження — формат: OpenAI вимагає PCM16 або MP3, Gemini — FLAC, MP3, WAV, OGG. На пристрої потрібна конвертація.
Нативний аудіо-ввід швидший за STT+LLM у 2-3 рази за часом відгуку для живого діалогу.
| Критерій | STT + LLM | Нативний аудіо-ввід |
|---|---|---|
| Затримка | 5-10 сек (транскрипція + відповідь) | 2-4 сек (потокова обробка) |
| Інтонації | Губляться | Зберігаються |
| Підтримка API | Будь-яка LLM | GPT-4o Audio, Gemini 1.5 Pro |
| Розмір даних | Малий (текст) | Великий (аудіофайли до 25 МБ) |
| Підходить для | Транскрипції зустрічей | Голосових асистентів |
Як вибрати між STT+LLM та нативним аудіо-вводом?
Якщо додатку потрібен швидкий голосовий асистент з інтонаціями — вибирайте нативний аудіо-ввід. Для транскрипції довгих записів або коли модель ще не підтримує аудіо — STT+LLM. Ми допомагаємо визначитися на етапі аудиту.
Як записати аудіо без багів?
На Android
Захоплення через MediaRecorder просте, але AudioRecord потрібен, коли вимагається PCM в реальному часі (стрімінг до Whisper через WebSocket). MediaRecorder зберігає у файл — зручно для коротких голосових, незручно для живого потоку. Типовий краш: IllegalStateException: start called in invalid state — це виклик start() до prepare() або повторний start() без reset(). Не забувайте звільняти в onPause(), інакше інші додатки втратять мікрофон.
На iOS
AVAudioEngine для PCM-стрімінгу, AVAudioRecorder для файлів. Проблема, яку всі зустрічають — AVAudioSession конфігурація. Згідно з Apple Developer Documentation, якщо не виставити .record категорію до старту, запис або тихий, або йде через динамік замість мікрофона. А з iOS 17 потрібен NSMicrophoneUsageDescription навіть для симулятора. Формат за замовчуванням у AVAudioRecorder — CAF. Whisper його не приймає. Потрібно або конвертувати через AVAssetExportSession (асинхронно, додає затримку), або одразу налаштувати AVAudioRecorder на M4A/FLAC.
Реалізація стримінгового STT
Для живої розшифровки (користувач говорить — текст з'являється на екрані) використовуємо WebSocket до Whisper Streaming або Deepgram. На Android:
val audioRecord = AudioRecord(
MediaRecorder.AudioSource.MIC,
16000, // 16kHz — оптимум для Whisper
AudioFormat.CHANNEL_IN_MONO,
AudioFormat.ENCODING_PCM_16BIT,
bufferSize
)
// чанки по 100мс → WebSocket → partial transcripts
Частота дискретизації 16 кГц достатня для мовлення і вдвічі менше даних, ніж 44.1 кГц. На iOS аналог — AVAudioEngine з installTap(onBus:).
Важно: WebSocket потрібно перевідкривати при втраті мережі. OkHttp WebSocket на Android має колбек onFailure — реалізуйте exponential backoff з максимум 3 спробами, інакше користувач не зрозуміє, що з'єднання обірвалося.
Як передати аудіо-файл у мультимодальну модель?
// iOS — відправка аудіо в GPT-4o Audio
let audioData = try Data(contentsOf: recordingURL)
let b64 = audioData.base64EncodedString()
let payload: [String: Any] = [
"model": "gpt-4o-audio-preview",
"messages": [[
"role": "user",
"content": [
["type": "text", "text": userText],
["type": "input_audio", "input_audio": [
"data": b64,
"format": "mp3"
]]
]
]]
]
Ліміт на розмір аудіо у OpenAI — 25 МБ. 30-хвилинний запис у MP3 128kbps займає ~28 МБ — не влізає. Для довгого контенту потрібна нарізка на чанки по 10–15 хвилин або попередній Whisper для транскрипції. Деталі — в OpenAI Audio API.
Що входить в роботу з інтеграції?
- Аудит поточного стеку та цільових платформ
- Вибір архітектурного шляху (STT+LLM або нативний аудіо-ввід)
- Розробка захоплення аудіо з урахуванням платформенних особливостей
- Інтеграція STT або мультимодального API з обробкою помилок
- UI для часткових транскрипцій та стану запису
- Документація та інструкції з доопрацювання
- Тестування на реальних пристроях з різними мікрофонами
Покрокова інструкція для MVP
- Виберіть архітектурний шлях (STT+LLM або нативний аудіо-ввід) під сценарій.
- Реалізуйте захоплення аудіо з урахуванням платформенних особливостей (категорії сесії, формат, стримінг).
- Інтегруйте STT або мультимодальний API з обробкою помилок та перевідкриттям з'єднання.
- Додайте UI для відображення часткових транскрипцій та стану запису.
- Протестуйте на реальних пристроях з різними мікрофонами та рівнями шуму.
Етапи та терміни
| Етап | Опис |
|---|---|
| Аудит | Аналіз поточного стеку, цільових платформ та сценаріїв використання |
| Архітектура | Вибір шляху (STT+LLM або нативний аудіо-ввід) та провайдера |
| Захоплення аудіо | Реалізація запису з урахуванням форматів та стримінгу |
| Інтеграція | Підключення STT/мультимодального API з обробкою помилок |
| UI | Відображення часткових транскрипцій та стану запису |
| Тестування | Перевірка на реальних пристроях (різні мікрофони, шум, навушники) |
| Документація | Опис архітектури, інструкції з доопрацювання |
Орієнтовні терміни: MVP з записом та Whisper — від 1 до 2 тижнів. Повна реалізація зі стримінгом, нативним аудіо-вводом та обробкою довгих записів — від 3 до 5 тижнів.
Чому варто довірити це нам?
Більше 5 років розробляємо мобільні додатки з AI-функціями. Виконали понад 50 проектів з голосовими та мультимодальними рішеннями. Маємо досвід інтеграції Whisper, Deepgram, GPT-4o Audio. Гарантуємо дотримання App Store Review Guidelines та Google Play Політик. Надаємо сертифікат відповідності (якщо потрібно).
Зв'яжіться з нами для консультації — ми проаналізуємо ваш додаток і запропонуємо оптимальне рішення. Замовте оцінку проекту, щоб отримати детальний план робіт та терміни.







