> ## Documentation Index > Fetch the complete documentation index at: https://docs.reverieinc.com/llms.txt > Use this file to discover all available pages before exploring further. # Text-to-Speech API > Reverie's TTS (Text-to-Speech) is a solution that turns text into lifelike speech, allowing you to create applications that talk in multiple Indic languages and build comprehensive speech-enabled products. # How Does API Work? The process to generate an audio file for the text input is: * Post the request by: * Enter the valid `REV-APPNAME`, `REV-APP-ID`, and `REV-API-KEY`. * Enter the text for which you want to obtain the speech. * Select the output voice type (either male voice or the female voice) of the audio file. * Define the SSML Code, if required. * By default, the API will return the WAV audio file with a sampling rate of 22.05KHz. ## cURL for Integration ### Request : Synthesizing Audio for Single Sentence ```bash theme={null} curl --location --request POST 'https://revapi.reverieinc.com/' \ --header 'REV-API-KEY: ' \ --header 'REV-APP-ID: ' \ --header 'REV-APPNAME: tts' \ --header 'speaker: hi_female' \ --header 'Content-Type: application/json' \ --data-raw '{ "text": "किसान होंगे आत्मनिर्भर, समृद्ध भारत" }' ``` ### Request : Synthesizing Audio for Multiple Sentences ```bash theme={null} curl --location --request POST 'https://revapi.reverieinc.com/' \ --header 'REV-API-KEY: ' \ --header 'REV-APP-ID: ' \ --header 'REV-APPNAME: tts' \ --header 'speaker: hi_female' \ --header 'Content-Type: application/json' \ --data-raw '{ "text": ["भारत मेरा देश है।" , "मेरी कंपनी का नाम रेवेरी लैंग्वेज टेक्नोलॉजीज है।" ], "speed": 1, "pitch": 0, "format": "WAV" }' ``` ### Request : Synthesizing Audio for Multiple Sentences ```bash theme={null} curl --location --request POST 'https://revapi.reverieinc.com/' \ --header 'REV-API-KEY: ' \ --header 'REV-APP-ID: ' \ --header 'REV-APPNAME: tts' \ --header 'speaker: hi_female' \ --header 'Content-Type: application/json' \ --data-raw '{ "ssml": " Hello. ", "speed": 1, "pitch": 0, "format": "WAV" }' ``` ### Error Response ```json theme={null} { "success": false, "cause": "no `spkr` given" } ``` ## API References ### HTTP Request URL | URL Elements | Sample URL | | - | - | | https\://(hostname) | [https://revapi.reverieinc.com/](https://revapi.reverieinc.com/) | #### Headers **Content-Type** `string` *required* `application/JSON` **REV-API-KEY** `string` *required* A unique key/token provided by Reverie to identify the user using the TTS API. **REV-APP-ID** `string` *required* The unique account ID to identify the user and the default account settings. **REV-APPNAME** `string` *required* The parameter to identify the API. The value is `tts` **speaker** `string` *required* * The desired language and voice code for synthesizing the audio file \\ * Example: `hi_male` \\ * Specify the speaker’s code with respect to the language. Refer to [Supporting Speaker](https://docs.reverieinc.com/usage-guides/text-to-speech/supported-speakers.md) Code section for valid speaker code. #### Request **text or ssml** `string/array` *required* * The plain text or SSML input to synthesize an audio output. * If you want to follow W3 standards, the ssml field must be used and not the text field. * For SSML input Refer to the [SSML Tags](https://docs.reverieinc.com/usage-guides/text-to-speech/ssml-tags.md#core-ssml-tags) **speed** `float` * The speech rate of the audio file. Allows values: from 0.5 (slowest speed rate) up to 1.5 (fastest speed rate). * Note: By default, speed = 1 (normal speed). **pitch** `float ` * Speaking pitch, in the range Allows values: from -3 up tp 3. 3 indicates an increase of 3 semitones from the original pitch. -3 indicates a decrease of 3 semitones from the original pitch. * Note: By default, the pitch = 0 (zero) **sample\_rate** `integer` * The sampling rate (in hertz) to synthesize the audio output. Refer to [Supporting Sampling Rate](usage-guides/text-to-speech#supported-sampling-rate) section, to know the supporting audio sample rates. * Note: By default, the sample\_rate = 22050 Hz (22.05kHz) **format** `string` * The speech audio format to generate the audio file. Refer to [Supporting Audio Format](https://docs.reverieinc.com/usage-guides/text-to-speech/supported-audio-formats.md) section, to know the supporting audio formats. \\ * Note: By default, the format = WAV #### Handling Error The TTS API raises exceptions for many reasons, such as failed conversions, invalid parameters, authentication errors, and network unavailability. It will provide more specific machine-readable messages with an error response so that users can react to errors more effectively. Refer to [API Codes](https://docs.reverieinc.com/api-reference/text-to-speech.md#api-messages) to view the list of error messages and its description. ```json theme={null} { "success": false, "cause": "no `text` given" } ``` #### API Messages | Status Code | Error Message | Description | | - | - | - | | 403 | Invalid REV-API-KEY or REV-APP-ID | Entered Invalid credentials | | 403 | usage exhausted | The provided credits or the character limit is exhausted. | | 403 | API key expired | The API key provided to a user is expired. | | 403 | unauthorized to use this API | The REV-APPNAME entered is invalid, or the user is not authorized to use it. | | 403 | unauthorized to use this src/tgt language | The invalid speaker code is passed, or the user cannot use the defined speaker code. | | 400 | no spkr given | The speaker code is missing | | 400 | invalid speed value | The speed requested in the input is invalid or not supported by the API. | | 400 | invalid pitch value | The audio pitch defined in the input is invalid or not supported by the API. | | 400 | invalid format value | The requested audio format is invalid or not supported by the API. | | 400 | invalid sample\_rate value | The requested audio sample rate is invalid or not supported by the API. | | 400 | no text given | The input text is missing | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.