> For a complete documentation index, fetch https://docs.voximplant.ai/llms.txt

# VoxTTS

## Classes

* [RealtimeTTSPlayer](/api-reference/voxengine/vox-tts/realtime-tts-player)

## Functions

### createRealtimeTTSPlayer

Creates a new [VoxTTS.RealtimeTTSPlayer](/api-reference/voxengine/vox-tts/realtime-tts-player) instance. You can attach media streams later via the `VoxTTS.RealtimeTTSPlayer.sendMediaTo` or `VoxEngine.sendMediaBetween` methods.

```ts
createRealtimeTTSPlayer(parameters: RealtimeTTSPlayerParameters): RealtimeTTSPlayer
```

**Parameters**

## Types

### RealtimeTTSPlayerParameters

[VoxTTS.RealtimeTTSPlayer](/api-reference/voxengine/vox-tts/realtime-tts-player) parameters. Can be passed as arguments to the `VoxTTS.createRealtimeTTSPlayer` method.

*optional*

Optional. VoxTTS API key. Use your VoxTTS API key if you have your own.

Object to provide parameters directly to the VoxTTS provider Create Context message.

*optional*

Optional. Whether to enable the tracing functionality.

If tracing is enabled, a URL to the trace file appears in the 'websocket.created' message. The file contains all sent and received WebSocket messages in the plain text format. The file is uploaded to the S3 storage.

Note: Enable this only for diagnostic purposes.

## Type aliases

### CreateContextParameters

Parameters for creating a VoxTTS provider context. Passed via `VoxTTS.RealtimeTTSPlayerParameters.createContextParameters`.

```ts
type CreateContextParameters = {
    /**
     * Optional. Parameters for creating the TTS context. When omitted or empty, [VoxTTS.VoiceList.Sergey] and [VoxTTS.ModelList.VoxTTS] are used.
     */
    create?: {
      /**
       * Optional. The model to use for synthesis. Defaults to [VoxTTS.ModelList.VoxTTS].
       */
      modelId?: VoxTTSModelList;
      /**
       * Optional. The voice to use for synthesis. Defaults to [VoxTTS.VoiceList.Sergey].
       */
      voiceId?: VoxTTSVoiceList;
      /**
       * Optional. Parameters for cloning the TTS context.
       */
      cloning?: Object;
    };
    /**
     * Optional. Identifier of the provider context. Use the same value in [VoxTTS.RealtimeTTSPlayer.send] requests.
     */
    contextId?: string;
  }
```

### VoxTTSSendParameters

Parameters for the `VoxTTS.RealtimeTTSPlayer.send` method.

```ts
type VoxTTSSendParameters = {
    /**
     * Send text message parameters.
     */
    send_text: {
      /**
       * Text to synthesize.
       */
      text: string;
      /**
       * Flush context parameters passed directly to the VoxTTS provider.
       */
      flush_context: Object;
    };
    /**
     * Optional. Identifier of the provider context.
     */
    contextId?: string;
  }
```