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

Bad Request
Invalid text or audio configuration
Too Many Requests
Rate limit exceeded
Internal Server Error
Unexpected error occurred

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.