API та інтеграції

Один ключ. Говорить звідусіль.

REST API, сумісний з OpenAI SDK. MCP-сервер для асистентів. Модулі для n8n, Make і Zapier. Потік у телефонію. Усе чотири — вже працює.

POST /v1/audio/speechstream: trueMCP · 4 toolswebhooks · 4 eventsSIP · WSS
REST API

Змініть baseURL — решта коду лишається.

Ендпоінти дзеркалять OpenAI: audio.speech.create працює без змін. Ключ hm_live_…, моделі homin-neo-1, homin-pro-1, homin-live-1.


    
Довідник ендпоінтів
https://api.homin.ua/v1

      
POST/audio/speech
текст → mp3 / wav / ogg · до 5 000 символів · stress marks U+0301

      
POST/audio/speech stream: true
chunked audio · перший чанк ≈ 300 мс

      
GET/voices
список голосів, мови, теги, ціна за 1 000

      
POST/stress/check
розставляє наголоси, повертає омографи для вибору

      
GET/usage
баланс, витрати за період, ліміти ключа

      
WSSlive.homin.ua/v1/live
двонаправлений потік для агентів · 16 кГц PCM / Opus

    
Помилки — у форматі OpenAI: 401 key_revoked, 402 quota_exceeded, 429 rate_limited, 503 provider_fallback.

  

  
Ліміти та гарантії
FreeProBusinessEnterprise

    
Запитів / хв на ключ—120600за договором

    
Символів / добу—500 0005 000 000без ліміту

    
Паралельних потоків Live1 (демо)—50500+

    
Відповідь API (p95)—< 150 мс< 150 мс< 100 мс

    
SLA——99,9 %99,95 %

  






  
MCP
Один рядок у конфігу — і асистент говорить українською.
Claude Desktop, Claude Code, Cursor, ChatGPT — будь-який клієнт MCP бачить інструменти HOMIN і викликає їх сам.

  

    

      
tts.speakтекст → аудіо
stress.checkнаголоси
voices.listголоси
usage.getбаланс

    
Як це виглядає в асистенті

      
Ви: «Озвуч цей абзац голосом Остапа і збережи mp3»
→ homin.stress.check({ input: "…" }) · 1 омограф
Claude: «У слові „замок” два наголоси. Це будівля чи на дверях?»
Ви: «Будівля»
→ homin.tts.speak({ voice: "ostap", input: "…за́мок…" })
▶abzats.mp3 · 0:42 · 14 кредитів
Claude: «Готово. Залишилось 12 466 кредитів.»

    
Асистент сам перевіряє наголоси перед озвученням — так працює stress.check у парі з tts.speak.

  






  
Автоматизації
n8n, Make, Zapier і вебхуки.
Готові модулі й шаблони: від таблиці до аудіо в каналі — за п'ять хвилин, без коду.

  

    
ШаблонGoogle Sheets → HOMIN → Telegram
Google Sheetsновий рядок
HOMINtts.speak · Соломія
Telegramголосове в канал
n8nMakeZapier

    
ШаблонRSS → дайджест новин голосом
RSSнові статті
HOMINNeo · Верес
Spotify / Driveепізод щоранку
n8nMake

    
ШаблонCRM → персональний голосовий дзвінок
HubSpotнова угода
HOMIN LiveБогдан
Twilioдзвінок клієнту
ZapierMake

    
ВебхукиЧотири події, підпис HMAC, повтор 3×
generation.completedgeneration.failedbudget.thresholdvoice.ready
POST https://your.app/hooks/homin
X-HOMIN-Signature: sha256=…
{ "event": "generation.completed",
  "id": "gen_8k2m4", "voice": "solomiia",
  "credits": 13, "url": "https://cdn.homin.ua/a/gen_8k2m4.mp3" }

  






  
Телефонія та агенти
Потік у дзвінок — без проміжних файлів.
HOMIN Live віддає аудіо потоком у Twilio, SIP/Asterisk, LiveKit і Pipecat. Перша фраза за ~300 мс.

  

    

    
Як працює Live

      
1
Клієнт говоритьASR стрімить текст, агент готує відповідь ще до кінця фрази

      
2
HOMIN відповідає потокомперший чанк аудіо ≈ 300 мс, далі — без пауз

      
3
Передача людиніза правилом або на запит — із коротким переказом розмови

      
~300 мсдо першої фрази
12кредитів / хв
50потоків у Business

    

  






  
Кабінет розробника

  
Ключ — за хвилину. Перше аудіо — за три.

  
Відкрити ключі й аналітикуЗареєструватися безкоштовноКлюч показується один раз · SHA-256 · бюджети й ліміти на кожен ключ

  
Відчуй звучання мови







  
  

    
HOMIN  гід