Skip to main content
POST
Voice Cloned TTS Stream

Overview

1

Step 1 — Generate a voice embedding

Upload a reference audio clip to get a speaker_embedding. See Voice Clone Embeddings.
2

Step 2 — Synthesize with your cloned voice — this page

Pass the speaker_embedding from Step 1 to this endpoint to stream cloned voice audio progressively.
Stream cloned voice audio as it’s generated using Server-Sent Events. Pass the speaker_embedding from Voice Clone Embeddings to use your cloned voice. Reduces latency compared to Voice Cloned TTS REST. For the lowest latency, see Voice Cloned TTS Realtime.

Endpoint

Authentication

Request Body

string
required
The text to synthesize into speech
string
Voice cloning model. Use vachana-vc-v1. Automatically set when speaker_embedding is provided — you may omit this field.
object
required
Audio output configuration
object
required
Voice clone embedding obtained from the Voice Clone Embeddings endpoint

Response

The server streams audio data via Server-Sent Events (SSE). Each event contains a chunk of audio data encoded in base64.

Event Types

event
Sent when synthesis begins.
event
Contains base64-encoded audio in the audio field.
event
Signals the end of the audio stream.

Example Request

Error Responses

Text-to-Speech and Voice Cloning (REST and SSE) return errors in a flat body, not the error.type envelope used by Speech-to-Text:
Authentication and rate-limit errors use the shape shown below. Some validation failures on the embeddings endpoint can also return 422 with a {"detail": [...]} body. Authentication and rate-limit errors do not use the success / error envelope. They look like this:
The same shapes are returned by REST, Batch, Text-to-Speech, Voice Cloning and the Realtime handshake (as an HTTP response before the WebSocket opens). See Error Reference for all Speech API errors.

Authorizations

X-API-Key-ID
string
header
required

Headers

X-API-Key-ID
string
required

Body

application/json

Request body for voice cloned TTS inference.

text
string
required

The text to synthesize into speech.

speaker_embedding
SpeakerEmbedding · object
required

Voice clone embedding from the Voice Clone Embeddings endpoint.

audio_config
AudioConfig · object
required

Audio output configuration.

model
enum<string>

Voice cloning model. Automatically set to vachana-vc-v1 when speaker_embedding is provided.

Available options:
vachana-vc-v1

Response

Successful Server-Sent Events stream

The response is of type string.