Funziona con lo stack vocale che già usate
Plugin ufficiali per LiveKit e Pipecat, endpoint integrati per Vapi e Cognigy e un server MCP per Claude e Cursor.
LiveKit Agents
Pipecat- Vapi
- Cognigy
- Server MCP
from kugelaudio.livekit import STT as KugelAudioSTTfrom kugelaudio.livekit import TTS as KugelAudioTTStts = KugelAudioTTS(model="kugel-3.5", voice_id=1071, language="en")tts.prewarm()session = AgentSession( stt=KugelAudioSTT(language="en"), turn_handling={"turn_detection": "stt"}, llm=openai.LLM(model="gpt-4o-mini"), tts=tts, vad=silero.VAD.load(),)Scegliete la vostra piattaforma
Plugin ufficialeLiveKit Agents
Passatelo ad AgentSession come provider tts.
PythonTypeScript
Guida alla configurazione
Plugin ufficialePipecat
KugelAudioTTSService va al posto del vostro stadio TTS.
Python
Guida alla configurazione- Endpoint integrato
Vapi
Puntate una voce personalizzata al nostro endpoint. Nessun proxy.
Guida alla configurazione - Fornitore personalizzato
Cognigy
Registratelo una volta come fornitore vocale, poi sceglietelo in ogni flusso.
Guida alla configurazione - Server MCP
Server MCP
Claude e Cursor generano voce dalla chat dopo un solo accesso.
Guida alla configurazione Manca la vostra piattaforma?
Diteci cosa usate.
Contattateci
Da ElevenLabs? Tenete il vostro SDK.
Puntatelo al nostro URL di base, usate gli ID voce di KugelAudio e scegliete un formato di uscita.
# Beforeclient = ElevenLabs(api_key="your-elevenlabs-key")# Afterclient = ElevenLabs( api_key="your-kugelaudio-key", base_url="https://api.kugelaudio.com/11labs",)Oppure costruite direttamente sull'API
SDK ufficiali per Python, TypeScript e Java, oppure HTTP e WebSocket diretti.
Python
Docs: Pythonpip install kugelaudioTypeScript
Docs: TypeScriptnpm install kugelaudioJava
Docs: Javaimplementation 'com.kugelaudio:kugelaudio:3.1.0'
Domande sulle integrazioni
Quale integrazione devo usare?
Usate il plugin del framework su cui gira già il vostro agente (LiveKit Agents o Pipecat), oppure l'endpoint integrato se le chiamate girano su Vapi o Cognigy. Per Claude o Cursor collegate il server MCP; senza framework, usate un SDK.
Come passo da ElevenLabs?
Puntate l'SDK di ElevenLabs a https://api.kugelaudio.com/11labs e usate gli ID voce di KugelAudio e un formato di uscita PCM. In streaming non fate flush dopo ogni blocco: su KugelAudio ogni flush chiude il turno.
Posso usare KugelAudio nella mia pipeline?
Sì: gli SDK e i plugin per LiveKit e Pipecat chiamano tutti la stessa API. Senza SDK, chiamate POST /v1/tts/generate oppure trasmettete il testo dell'LLM sul WebSocket /ws/tts/stream.
La voce resta nella UE con Vapi o LiveKit?
Le richieste a KugelAudio possono restarci: impostate region "eu" o il prefisso di chiave eu- in plugin e SDK, oppure registrate un URL su api.eu.kugelaudio.com in Vapi e Cognigy. Questo riguarda le richieste vocali, non il resto del vostro stack.
Serve una chiave API per ogni integrazione?
I plugin, gli SDK, Vapi e Cognigy usano una chiave API dalla dashboard. Con il server MCP effettuate invece l'accesso, e le sue chiamate vengono fatturate come qualsiasi altra richiesta API.
In che formato arriva l'audio?
KugelAudio genera PCM a 16 bit a 24 kHz e ricampiona sul server per frequenze più basse. L'API compatibile con ElevenLabs restituisce anche MP3 e G.711 a 8 kHz per la telefonia.
Date al vostro agente una voce KugelAudio
Create un account, copiate una chiave API dalla dashboard e scegliete una voce. Tutte le integrazioni di questa pagina usano la stessa API.