# Voices AI Live API > Local REST API of Voices AI Live, the real-time AI voice changer for Mac and Windows. Scripts, bots and apps on the same computer can start and stop the voice changer, switch voices, create custom voices, set quality and monitoring, and stream status changes. Base URL http://127.0.0.1:19470, Bearer API key, JSON plus Server-Sent Events. Describes Voices AI Live 2.11.0 and later. Things to know before writing code against it: - It only listens on 127.0.0.1 while the Voices AI Live desktop app is open. In the app, Settings > General > "Stream Deck and other apps" turns it on (on by default); Settings > Developer shows the endpoint and the API key. - Every request needs `Authorization: Bearer `. Read the key from an environment variable such as `VOICES_AI_API_KEY`; never hardcode it. - Voice IDs come from `GET /v1/voices` (or `GET /v1/custom-voices`). Select one with `POST /v1/voice` before `POST /v1/start`. - `GET /v1/events` is Server-Sent Events. Browsers must read it with streaming `fetch`, because `EventSource` cannot send the Authorization header. - Errors are JSON with an `error` message; see the Errors guide for status codes. ## Docs - [Overview](https://docs.getvoices.ai/index.md): What the API does, base URL, authentication and every endpoint - [Quickstart](https://docs.getvoices.ai/guides/quickstart.md): Turn on the local API, copy your key and switch voices from a script in a few minutes. - [Authentication](https://docs.getvoices.ai/guides/authentication.md): Every request carries your API key as a Bearer token. Where to find it, how to send it and how to rotate it. - [Errors](https://docs.getvoices.ai/guides/errors.md): Status codes the API returns, what each one means and how to recover. ## API reference - [Get voice changer status](https://docs.getvoices.ai/reference/get-status.md): `GET /v1/status` - Returns the current state of the voice changer, the selected voice and, while it runs, the voice changer's delay (`latencyMs`). - [Stream realtime events](https://docs.getvoices.ai/reference/stream-events.md): `GET /v1/events` - Opens a Server-Sent Events stream. - [Start the voice changer](https://docs.getvoices.ai/reference/start.md): `POST /v1/start` - Starts the voice changer using the currently configured audio devices and voice model. - [Stop the voice changer](https://docs.getvoices.ai/reference/stop.md): `POST /v1/stop` - Stops the voice changer. - [List available voices](https://docs.getvoices.ai/reference/list-voices.md): `GET /v1/voices` - Returns every voice in your voice library: the catalog (effects such as Clean Mic and Robot included), your custom voices and the Community voices you added to your voices. - [Select a voice](https://docs.getvoices.ai/reference/set-voice.md): `POST /v1/voice` - Sets the active voice by its ID. - [List custom voices](https://docs.getvoices.ai/reference/list-custom-voices.md): `GET /v1/custom-voices` - Returns the signed-in account's custom voices, so you can find a voice ID by name. - [Create a custom voice](https://docs.getvoices.ai/reference/create-custom-voice.md): `POST /v1/custom-voices` - Creates a custom voice from a local audio or video file, the same way as the in-app recorder: the app converts the file and keeps the clearest 5 to 15 seconds of speech. - [Delete a custom voice](https://docs.getvoices.ai/reference/delete-custom-voice.md): `DELETE /v1/custom-voices/{id}` - Permanently deletes one of your custom voices. - [List the sounds on your boards](https://docs.getvoices.ai/reference/list-sounds.md): `GET /v1/sounds` - Returns your boards from the Sounds page with the pads on them: names, pictures and pad IDs to play with `POST /v1/sounds/{padId}/play`. - [Play a sound](https://docs.getvoices.ai/reference/play-sound.md): `POST /v1/sounds/{padId}/play` - Plays a pad into the microphone, exactly like its shortcut in the app: a loop starts or stops, any other sound starts again from the beginning. - [Stop all sounds](https://docs.getvoices.ai/reference/stop-sounds.md): `POST /v1/sounds/stop` - Stop all sounds - [Set voice quality mode](https://docs.getvoices.ai/reference/set-quality.md): `PUT /v1/quality` - Sets the quality and latency profile used by the voice changer. - [Toggle audio monitoring](https://docs.getvoices.ai/reference/set-monitor.md): `PUT /v1/monitor` - Enables or disables audio monitoring (hear yourself) and saves the setting. ## Optional - [Full documentation](https://docs.getvoices.ai/llms-full.txt): Every page above in one file - [OpenAPI 3.1 spec](https://docs.getvoices.ai/api/voices-live-openapi.yml): Machine-readable spec of the current API - [OpenAPI spec for Voices AI Live 2.10.0 – 2.10.1](https://docs.getvoices.ai/api/live/2.10.0.yml): The API of older app versions - [OpenAPI spec for Voices AI Live 2.0.0 – 2.9.4](https://docs.getvoices.ai/api/live/2.0.0.yml): The API of older app versions - [OpenAPI spec for Voices AI Live 1.1.0 – 1.4.1](https://docs.getvoices.ai/api/live/1.1.0.yml): The API of older app versions