Settings

Configure the service URLs you use. Advanced payloads, folders, and keys are tucked away below.

Local stack

Core connections

These are the endpoints you change most often. NVIDIA TTS and STT are grouped separately.

TTS — Text to Speech Qwen3 engines: clone, design, custom, streaming · Kokoro FastAPI

Voice Clone / Base URL (WAV voices) Uploaded/cloned WAV voices. Expected: POST /v1/audio/speech.

Voice Design URL (instruction voices) Prompt-designed voices and vd_... virtual voices.

CustomVoice URL Style over configured speakers such as Ryan, Vivian, Serena.

Streaming URL Progressive low-latency WAV playback.

Kokoro FastAPI URL (82M · CPU-friendly) OpenAI-compatible TTS. Built-in voices: af_bella, bf_emma, am_adam… ~300 MB RAM.

NVIDIA speech stack router, Magpie TTS, Parakeet ASR, clone NIM

NVIDIA router URL (TTS + STT) OpenAI-compatible base URL for the NVIDIA speech router.

NVIDIA Magpie TTS URL Direct Magpie endpoint. Fixed speakers, not WAV cloning.

NVIDIA Parakeet ASR URL Direct Parakeet endpoint for transcription.

NVIDIA Zeroshot NIM URL Magpie Zeroshot clone endpoint with audio_prompt.

NVIDIA Flow NIM URL Magpie Flow clone endpoint with audio_prompt and transcript.

STT — Speech to Text Whisper, faster-whisper, whisper.cpp, Groq, Parakeet, NVIDIA router

Active STT URL Default recognition endpoint. Expected: POST /v1/audio/transcriptions.

faster-whisper-server URL (CTranslate2 GPU) GPU-accelerated Whisper via CTranslate2. ~70× RT · 1.5 GB VRAM.

whisper.cpp URL (CPU/CUDA) Lightweight C++ Whisper server. ~8–15× RT CPU · ~1 GB RAM.

Groq API key (Groq Whisper & LLM)

Used for Groq Whisper STT and LLM. Free: 2 000 req/day. Fastest cloud transcription.

Playback behavior

TTS preview playback Buffered keeps Save WAV available. Streaming starts sooner.

OpenAI-compatible request style Controls payload shape for the normal TTS API URL.

Advanced request payloads JSON extras sent to each backend

Voice Clone / Base params Extra fields for the 8020 WAV voice clone/base model.

Streaming params Extra fields for the 8023 streaming model.

CustomVoice params Extra fields for the CustomVoice backend.

Voice Design params Extra fields for Voice Design and virtual vd_... voices.

NVIDIA Magpie params Usually empty. Magpie accepts fixed speakers: sofia, aria, jason, leo, john.

NVIDIA Zeroshot params Optional multipart fields. The app supplies text, language, audio_prompt.

NVIDIA Flow params Optional multipart fields. The app also sends the saved reference transcript.

Kokoro FastAPI params Extra JSON fields for Kokoro. Usually empty — voice is selected from the dropdown.

Voice folders container paths and Portainer volume mounts

Voice scan directory Contains active_voices, hidden_voices, sounds, and metadata.

Active voices directory New cloned/exported voices are saved here.

API keys usually empty for local containers

TTS API key (optional)

Voice Design API key (optional)

Whisper API key (optional)

Backup & restore

Export all voices and settings as a ZIP for backup or migration. Import to restore. API keys are excluded from exports.

Export voices Import voices