# POST /voice/tts

**POST /voice/tts**

## Synthesizes speech synchronously 
***
Receives text and data configs and synthesize speech in different voices and format using state-of-the-art deep neural networks. This service synthesizes speech synchronously and the results will be available after all text input has been processed. 
***
Using *config* object you can can specify audio configs such as *audioEncoding* and *sampleRateHertz*. We will support different languages so you can choose the *languageCode*. using *voiceSelectionParams* you can choose between the supported voices with specifying voiceId. Voices differ in gender, tone and style. 



## Servers


## Authentication methods
- Bearer auth


## Parameters



### Body:  (object)
Receives a json including input text, voice parameteres and audio config.

- **synthesisInput** (object)
  The Synthesizer requires either plain text or SSML as input. Only provide text OR ssml. Providing both will result in a bad request response.
- **voiceConfig** (object)
  The desired voice of the synthesized audio.
- **audioConfig** (object)
  The configuration of the synthesized audio.


## Responses
### 405
The request method is known by the server but has been disabled and cannot be used.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 201
OK. Speech Synthesized.

#### Body:  (object)
- **audioContent** (string(byte))
  The audio data bytes encoded as specified in the request, including the header (For LINEAR16 audio, we include the WAV header).
  A base64-encoded string.

### 400
This response means that server could not understand the request due to invalid syntax.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 401
Authentication is needed to get requested response. This is similar to 403, but in this case, authentication is possible.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 403
Client does not have access rights to the content so server is rejecting to give proper response.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 415
The media format of the requested data is not supported by the server, so the server is rejecting the request.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 429
The user has sent too many requests in a given amount of time ("rate limiting").


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 500
The server has encountered a situation it doesn't know how to handle.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 501
The request method is not supported by the server and cannot be handled.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.


[Powered by Bump.sh](https://bump.sh)