← Блог

Диктування з власним API-ключем: як працює режим BYOK у Hovor

Принесіть свій ключ OpenAI чи Anthropic — і Hovor звертається до провайдера напряму: без підписки на хмарні обчислення, без посередника-сервера, а сам ключ ніколи не покидає Keychain вашого пристрою.

Оновлено: 19 липня 2026

Що таке BYOK насправді

BYOK ("принеси свій ключ") означає, що ви вставляєте власний API-ключ від OpenAI, Anthropic, Deepgram чи ElevenLabs у Налаштування Hovor, і застосунок використовує саме цей ключ для прямого звернення до провайдера — замість того, щоб пересилати запит через сервер Hovor. Ви платите провайдеру за токени або хвилини аудіо; з боку Hovor BYOK входить до активної підписки Pro, або доступний за одноразову плату BYOK Unlock, якщо ви не хочете підписки.

Це відрізняється від хмарного режиму Hovor за замовчуванням, де транскрибація й форматування відбуваються на сервері Hovor через власний акаунт OpenAI компанії, оплачений підпискою Pro. BYOK змінює лише те, чий акаунт використовується і хто платить провайдеру — сама архітектура "продиктував у Hovor, отримав відформатований текст" лишається тою самою.

Де зберігається ключ і куди він не потрапляє

Кожен BYOK-ключ записується в Keychain iOS/macOS через KeychainStore (`HovorKit/Sources/HovorKit/Workflows/KeychainStore.swift`) під ідентифікатором сервісу app.hovor.byok, з прапорцем доступності kSecAttrAccessibleWhenUnlockedThisDeviceOnly. На практиці це означає три речі: ключ ніколи не синхронізується через iCloud Keychain на інші ваші пристрої, він недоступний, поки пристрій заблокований, і не переноситься при відновленні бекапу на інше обладнання. Це не декларація політики конфіденційності — це те, як налаштований сам виклик збереження.

З мережевого боку кожен BYOK-бекенд формує HTTPS-запит напряму до провайдера. OpenAISTTBackend надсилає POST на api.openai.com/v1/audio/transcriptions, DeepgramSTTBackend — на api.deepgram.com/v1/listen, ElevenLabsSTTBackend — на api.elevenlabs.io/v1/speech-to-text, а OpenAIToneBackend і AnthropicToneBackend — відповідно на api.openai.com/v1/chat/completions і api.anthropic.com/v1/messages. Кожен запит формується й надсилається власним URLSession у HovorKit, без жодного проміжного хоста, контрольованого Hovor.

Які провайдери й моделі насправді підтримує BYOK у Hovor

BYOK охоплює дві окремі ролі: розпізнавання мовлення (перетворення голосу на сирий текст) і форматування чи переклад (виправлення граматики, пунктуації, тону або переклад іншою мовою). Не кожен із п'яти вбудованих провайдерів підтримує обидві ролі одразу — таблиця нижче показує повний вбудований каталог моделей, без спрощень для маркетингу.

ПровайдерРольМоделі з власним ключемПотрібен ключ
OpenAIРозпізнавання мовленняGPT-4o mini Transcribe, GPT-4o Transcribe, Whisper API, GPT Realtime WhisperТак
OpenAIФорматування / перекладGPT-5 mini, GPT-5, GPT-4o, GPT-4o-miniТак
AnthropicФорматування / перекладClaude Sonnet 4.6, Claude Haiku 4.5Так
DeepgramРозпізнавання мовленняNova-3 (General), Nova-3 MultilingualТак
ElevenLabsРозпізнавання мовленняScribe v2Так
Кастомний ендпоінт, сумісний з OpenAIФорматування / перекладБудь-яка модель вашого ендпоінта (Ollama, LM Studio, vLLM тощо)Опційно

Anthropic у Hovor доступний лише через BYOK: хмарного варіанта Claude від Hovor немає, тож форматування через Claude завжди йде через ваш власний ключ. OpenAI, натомість, доступний і через хмару Hovor (оплата через Pro), і через BYOK (оплата через ваш акаунт OpenAI) — ви обираєте, який варіант активний, окремо для кожного workflow. Форматування через Google/Gemini наразі не підключене в жодному з варіантів.

Кастомні ендпоінти: локальна модель замість хмарного API

CustomEndpointToneBackend у Hovor звертається до будь-якого сумісного з OpenAI chat-completions ендпоінта, на який ви вкажете — власний сервер Ollama чи LM Studio у локальній мережі або хмарний OpenAI-сумісний провайдер. Поле API-ключа опційне за задумом: багато локальних серверів моделей працюють без автентифікації, і ProviderCapability позначає такий провайдер як requiresKey: false, щоб ендпоінт без ключа не перенаправлявся непомітно у хмару Hovor.

Приймаються лише HTTPS-ендпоінти з дійсним хостом: CustomEndpointURL.validateHTTPS відхиляє URL з http://, тож API-ключ ніколи не піде у відкритому вигляді.

Перевірка ключа перед тим, як покластися на нього

Hovor перевіряє щойно введений ключ на реальному провайдері, перш ніж ви почнете покладатися на нього в робочому процесі. BYOKConnectionTester надсилає мінімальний, навмисно некоректний запит на справжній ендпоінт провайдера — для OpenAI це multipart POST на ендпоінт транскрибації аудіо без прикріпленого файлу — і розбирає помилку від провайдера, щоб відрізнити дійсний ключ із некоректним запитом від недійсного ключа чи браку дозволу.

Цей самий шлях коду — доказ, незалежний від тверджень самого Hovor, що BYOK звертається до провайдера напряму: перевірка спрацьовує лише тому, що запит справді доходить до OpenAI, Anthropic, Deepgram чи ElevenLabs.

Що відбувається при збої ключа або запиту

Обробка збою залежить від вашого тарифу, а не лише від типу помилки. ByokFallbackToneBackend обгортає ваш BYOK-бекенд опційним непомітним фолбеком на хмарне форматування Hovor — але фолбек спрацьовує лише якщо на момент виклику ви активний підписник Pro, перевіряється в реальному часі, а не кешується при старті. Користувачі на Free, Local-only й BYOK-only його не отримують — вони одразу бачать помилку.

Цей запобіжник існує саме для того, щоб користувачі, які обрали BYOK аби уникнути підписки, ніколи не були непомітно оплачені через акаунт самого Hovor, оскільки не платили за ці серверні обчислення.

Скільки коштує BYOK: включено в Pro або окремий unlock

Використання власного ключа входить до активної підписки Pro. Якщо підписка не потрібна, BYOK Unlock — одноразова покупка з підтримкою Family Sharing за $24.99 / 999 грн, що продається через App Store на iOS і macOS та через Monobank на вебсайті, — відкриває BYOK назавжди без неї. Оплата одноразова, не місячна й не річна, і додається до інших покупок Hovor, а не замінює їх.

ПокупкаЦінаЩо розблоковує
Підписка Pro$11.99/міс або $89.99/рікНеобмежені слова в хмарі Hovor, 5 пристроїв
Local Unlock$49.99 / 1999 грн (одноразово)Необмежена локальна транскрибація, необмежені заміни/сніпети/workflow
BYOK Unlock$24.99 / 999 грн (одноразово)Власний ключ OpenAI/Anthropic/Deepgram/ElevenLabs/кастомного ендпоінта, назавжди, без підписки (вже включено в Pro)
Bundle Local + BYOK$69.99 / 2799 грн (одноразово)Обидва пункти вище, приблизно на $5 дешевше, ніж окремо

Безкоштовний тариф (2000 слів/тиждень у хмарі Hovor) не вимагає жодної з цих покупок і працює без ключа. Підписники Pro вже мають BYOK; BYOK Unlock — для тих, хто хоче маршрутизувати конкретного провайдера/модель через власний ключ без додавання регулярної підписки.

Доступність за платформами: поки що лише iOS і macOS

BYOK реалізований усередині HovorKit — Swift-пакета, спільного для iOS- і macOS-клієнтів Hovor, тож сьогодні він працює однаково на обох платформах: той самий KeychainStore, ті самі бекенди провайдерів, той самий тестер з'єднання. Наразі він недоступний у Windows-клієнті, який ще розробляється на Tauri. Якщо BYOK потрібен вам зараз, єдиний підтримуваний шлях — iPhone або Mac.

Часті запитання

Що означає BYOK у застосунку для диктування?

BYOK ("bring your own key" — принеси свій ключ) означає, що ви вводите власний API-ключ провайдера, наприклад OpenAI чи Anthropic, і застосунок звертається до цього провайдера напряму цим ключем, а не через сервер і білінг розробника застосунку. У Hovor ключі BYOK вводяться в Налаштуваннях, зберігаються в Keychain пристрою і використовуються для прямих запитів до API провайдера з вашого Mac чи iPhone. Ви платите провайдеру за використання, а не Hovor за підписку на хмарні обчислення.

Чи бачить Hovor мій API-ключ або текст диктовки, чи проходить це через сервер Hovor?

Ні. BYOK-бекенди Hovor — OpenAISTTBackend, OpenAIToneBackend, AnthropicToneBackend, DeepgramSTTBackend, ElevenLabsSTTBackend та CustomEndpointToneBackend — формують HTTPS-запит безпосередньо до ендпоінта провайдера (наприклад, api.openai.com/v1/audio/transcriptions або api.anthropic.com/v1/messages) прямо в HovorKit і надсилають його через URLSession. Сервер Hovor у цьому запиті взагалі не бере участі. Сам ключ записується в Keychain пристрою під ідентифікатором сервісу app.hovor.byok з атрибутом kSecAttrAccessibleWhenUnlockedThisDeviceOnly, тож він також ніколи не синхронізується через iCloud Keychain і не переноситься при відновленні бекапу на інший пристрій.

Які провайдери й моделі можна використовувати з власним ключем у Hovor?

Для розпізнавання мовлення (BYOK): OpenAI (gpt-4o-mini-transcribe, gpt-4o-transcribe, whisper-1, gpt-realtime-whisper), Deepgram (Nova-3, Nova-3 Multilingual) та ElevenLabs (Scribe v2). Для форматування тексту й перекладу (BYOK): OpenAI (GPT-5 mini, GPT-5, GPT-4o, GPT-4o-mini) та Anthropic (Claude Sonnet 4.6, Claude Haiku 4.5). Також можна вказати будь-який сумісний з OpenAI кастомний ендпоінт — включно з локальним сервером на кшталт Ollama чи LM Studio — з опційним API-ключем, оскільки багато локальних ендпоінтів працюють без автентифікації в межах локальної мережі.

Чи потрібен BYOK Unlock для власного ключа і скільки він коштує?

Не обов'язково. BYOK входить до активної підписки Pro. Якщо ви не хочете підписки, окремий одноразовий BYOK Unlock ($24.99 / 999 грн, з підтримкою Family Sharing, продається через App Store на iOS і macOS та через Monobank на вебсайті) відкриває доступ назавжди без неї. BYOK Unlock — окрема покупка від Local Unlock ($49.99 / 1999 грн, для локальних моделей); придбання обох разом як Bundle коштує $69.99 (2799 грн) — приблизно на $5 дешевше, ніж купувати окремо.

Що відбувається, якщо власний API-ключ дає збій під час диктування?

Це залежить від вашого тарифу та налаштування auto-fallback у workflow. ByokFallbackToneBackend у Hovor автоматично й непомітно перемикається на хмарне форматування Hovor лише для активних підписників Pro; користувачі на Free, Local-only чи BYOK-only ніколи не отримують непомітного фолбеку на Hovor Cloud, оскільки не оплачували ці серверні обчислення. У будь-якому разі Hovor показує помилку явно, а не підміняє результат застарілим чи неправильним.

Чи доступний BYOK на Windows?

Поки що ні. BYOK реалізований у HovorKit — спільному Swift-пакеті застосунків Hovor для iOS і macOS, тож сьогодні він доступний саме на цих двох платформах. Windows-клієнт Hovor, який будується на Rust і React (Tauri), ще активно розробляється. BYOK там — не просто перемикач, який лишається ввімкнути: поточна реалізація зберігає ключі в Keychain від Apple, якого немає поза iOS і macOS, тож для Windows потрібен окремий дизайн безпечного зберігання ключів, перш ніж BYOK зможе з'явитися.

Диктуйте власним ключем — без підписки

BYOK входить до Pro, або додайте BYOK Unlock один раз ($24.99 / 999 грн) без підписки — і диктуйте через власний ключ OpenAI, Anthropic, Deepgram чи ElevenLabs: ваш ключ завжди залишається в Keychain пристрою.

Отримати Hovor