Bolo Voice Service

Documentation index & available routes

Documentation markdown

• CLI & Server Usage guide
• Generation Parameters reference
• Supported Languages reference
• Voice Design guide
• Evaluation reference
• Streaming & WebRTC Plan planning
• WebRTC Guide guide
• WebSocket API API

Reference Files repo docs

• AI Skill Definition agent
• Changelog history
• skills.txt plain text
• vapi-support.txt plain text

Interactive Demos browser UIs

• TTS Demo UI interactive
• WebRTC Demo UI interactive

Public Endpoints no auth

• GET/service status
• GET/health200 ok / 503 starting or failed
• GET/docsthis index page

Text-to-Speech auth: Bearer

• POST/v1/audio/speechOpenAI-compatible TTS (JSON or multipart, wav/mp3/pcm)
• POST/clonevoice cloning (requires ref_audio)
• POST/designvoice design (requires instruct)

Streaming auth: Bearer

• POST/v1/stream/speechstreamed TTS (audio or SSE)
• WS/v1/stream/wsstreaming TTS over WebSocket

Speech-to-Text & Audio auth: Bearer

• POST/v1/audio/transcriptionsOpenAI-compatible transcription (multipart)
• POST/v1/audio/denoiseDeepFilterNet noise suppression (multipart)

Vapi-compatible X-VAPI-SECRET or Bearer

• POST/v1/synthesizeVapi TTS webhook (returns raw PCM s16le)
• WS/v1/ws/transcribeVapi custom transcriber (streaming PCM)

WebRTC Signaling auth: Bearer

• POST/v1/webrtc/offerSDP offer / answer exchange
• POST/v1/webrtc/iceICE candidate trickle

Models & Voices auth: Bearer

• GET/v1/modelslist served models
• GET/v1/voiceslist all voices (built-in + custom)
• GET/v1/audio/voiceslist voices (OpenAI shape)
• GET/v1/voices/profileslist custom profiles

Voice Profiles CRUD auth: Bearer

• POST/v1/voices/profilescreate profile (multipart)
• POST/v1/voices/profiles/backfillauto-fill missing ref_text/language via ASR
• GET/v1/voices/profiles/{id}get profile
• PUT/v1/voices/profiles/{id}update name/description/ref_text/password
• DEL/v1/voices/profiles/{id}delete profile
• GET/v1/voices/profiles/{id}/audiodownload stored reference audio
• POST/v1/audio/voicescreate voice (OpenAI shape)
• GET/v1/audio/voices/{id}get voice (OpenAI shape)
• DEL/v1/audio/voices/{id}delete voice (OpenAI shape)
• GET/profileslist profiles (legacy)
• POST/profilescreate profile (legacy compat)
• GET/profiles/{id}get profile (legacy)
• DEL/profiles/{id}delete profile (legacy)

Routes with {id} are path templates — substitute the profile / voice id. POST/PUT/DELETE links are shown for reference; opening them in a browser will issue a GET and may return 405.