apogee-ai-voice¶
STT, TTS, VAD, barge-in and hot-word detection for voice agents.
Esta página está sendo ampliada
As tabelas abaixo são geradas do código-fonte do pacote, portanto estão corretas. Guias narrativos e exemplos comentados estão sendo escritos módulo a módulo.
API pública¶
Tudo abaixo é exportado pela raiz do pacote, então from apogee_ai_voice import X funciona para cada nome.
| Camada | Símbolos |
|---|---|
| Application · DTOs | GenerateImageDTO, GenerateVideoDTO, ListVoicesDTO, PipelineTurnDTO, SynthesizeDTO, TranscribeDTO |
| Application · Use cases | GenerateImageUseCase, GenerateVideoUseCase, ListVoicesUseCase, RunVoicePipelineUseCase, SynthesizeUseCase, TranscribeUseCase |
| Domain | AudioChunk, AudioFormat, AudioFormatSpec, ImageAsset, ImageGenUnavailable, ImageRequest, ImageResult, ImageStyle, LanguageCode, LatencyBudget, Modality, RealtimeEvent, RealtimeSession, SynthesisRequest, SynthesisResult, Transcript, TranscriptSegment, VadDecision, VadEvent, VideoGenUnavailable, VideoModel, VideoRequest, VideoResult, Voice, VoiceProfile |
| Domain · Enums | RealtimeEventKind |
| Domain · Exceptions | LanguageNotSupportedException, RealtimeError, STTUnavailableException, TTSUnavailableException, TransportError, VoiceError |
| Domain · Protocols (ports) | IImageGen, IRealtimeVoice, ISTT, ITTS, ITransport, IVideoGen, IVoiceActivityDetector |
| Infrastructure | AssemblyAISTT, CartesiaTTS, DeepgramSTT, DeepgramTTS, EchoImageGen, EchoSTT, EchoTTS, EchoVideoGen, ElevenLabsTTS, EnergyVAD, FluxGen, ImagenGen, LiveKitTransport, LocalAudioTransport, OpenAIImageGen, OpenAIRealtimeAdapter, OpenAITTS, PipecatRunStats, PipecatStyleRuntime, RunwayVideoGen, SoraVideoGen, StableDiffusionGen, VeoVideoGen, VoiceRegistry, WhisperSTT |
Instalação¶
A instalação base não tem dependência externa obrigatória. Cada extra habilita um adapter.
| Extra | Traz |
|---|---|
elevenlabs |
elevenlabs>=1.5 |
cartesia |
cartesia>=1.0 |
openai |
openai>=1.30 |
deepgram |
deepgram-sdk>=3.7 |
assemblyai |
assemblyai>=0.30 |
livekit |
livekit>=0.18, livekit-agents>=0.10 |
runway |
runwayml>=2.0 |
all |
elevenlabs>=1.5, cartesia>=1.0, openai>=1.30, deepgram-sdk>=3.7, assemblyai>=0.30, livekit>=0.18, livekit-agents>=0.10, runwayml>=2.0 |
CLI¶
Instalado como console script e registrado como plugin do apogee, então os mesmos subcomandos funcionam sob o binário global.
Leia a seguir¶
- Instalação
- Referência — todo símbolo público, gerado do código-fonte
- Apogee Framework — como os pacotes se encaixam