# Turn your text into Magical-sounding Audio

**Developer Portal :** <https://api.market/store/text-to-speech/text-to-speech>

<figure><img src="https://979396929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJpzXHBiEL3zWqYljGVxS%2Fuploads%2FsXLl3xsOGQFKhOJJcdNt%2Fimage.png?alt=media&#x26;token=f85e79ce-5f55-41ce-9c3a-5cfc90858f58" alt=""><figcaption></figcaption></figure>

The Text-to-Speech (TTS) API offers an easy-to-use solution for converting text into lifelike audio. Whether you need to add a human touch to your app, create engaging content, or build accessibility features, this API provides a seamless way to generate high-quality voice output. With a variety of voice models and languages, you can tailor the audio experience to your specific needs.

This API features straightforward endpoints to list available models and languages and to perform TTS conversions. Simply send a request with the desired text and parameters, and receive a realistic audio file in response. The flexibility and affordability of this API make it an ideal choice for developers looking to enhance their projects with natural-sounding speech.

### Endpoints&#x20;

`GET /models/list`  Retrieve list of available TTS models

`GET /languages/list`  Retrieve list of available languages

`POST /tts/run`  Run Text to Speech conversion

### Request and Response

`GET /models/list`

**Request**

```bash
curl -X 'GET' \
  'https://prod.api.market/api/v1/text-to-speech/text-to-speech/models/list' \
  -H 'accept: application/json' \
  -H 'x-api-market-key: API_KEY'
```

**Response**

```json
{
  "status": 0,
  "msg": "Success",
  "models": [
    {
      "id": 1,
      "speaker_name": "Joe",
      "gender": "male",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 2,
      "speaker_name": "Jane",
      "gender": "female",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 3,
      "speaker_name": "Philip",
      "gender": "male",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 4,
      "speaker_name": "Anthony",
      "gender": "male",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 5,
      "speaker_name": "Pam",
      "gender": "female",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 6,
      "speaker_name": "John",
      "gender": "male",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 7,
      "speaker_name": "Bryan",
      "gender": "male",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 8,
      "speaker_name": "Adrienne",
      "gender": "female",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 9,
      "speaker_name": "Ariele",
      "gender": "female",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 10,
      "speaker_name": "Brittany",
      "gender": "female",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 11,
      "speaker_name": "Jack",
      "gender": "male",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 12,
      "speaker_name": "Caroline",
      "gender": "female",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 13,
      "speaker_name": "Samantha",
      "gender": "female",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 14,
      "speaker_name": "Sara",
      "gender": "female",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 15,
      "speaker_name": "Quinn",
      "gender": "female",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 16,
      "speaker_name": "Victoria",
      "gender": "female",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 17,
      "speaker_name": "Tracy",
      "gender": "female",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 18,
      "speaker_name": "Georgia",
      "gender": "female",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 19,
      "speaker_name": "Henry",
      "gender": "male",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 20,
      "speaker_name": "Jerry",
      "gender": "male",
      "languages": [
        "en"
      ],
      "multilingual": false
    },
    {
      "id": 21,
      "speaker_name": "Generic-female-1",
      "gender": "female",
      "languages": [
        "en",
        "fr-fr",
        "pt-br"
      ],
      "multilingual": true
    },
    {
      "id": 22,
      "speaker_name": "Generic-female-2",
      "gender": "female",
      "languages": [
        "en",
        "fr-fr",
        "pt-br"
      ],
      "multilingual": true
    },
    {
      "id": 23,
      "speaker_name": "Generic-female-3",
      "gender": "female",
      "languages": [
        "en",
        "fr-fr",
        "pt-br"
      ],
      "multilingual": true
    },
    {
      "id": 24,
      "speaker_name": "Generic-male-1",
      "gender": "male",
      "languages": [
        "en",
        "fr-fr",
        "pt-br"
      ],
      "multilingual": true
    },
    {
      "id": 25,
      "speaker_name": "Generic-male-2",
      "gender": "male",
      "languages": [
        "en",
        "fr-fr",
        "pt-br"
      ],
      "multilingual": true
    },
    {
      "id": 26,
      "speaker_name": "Generic-male-3",
      "gender": "male",
      "languages": [
        "en",
        "fr-fr",
        "pt-br"
      ],
      "multilingual": true
    }
  ]
}
```

`GET /languages/list`

**Request**

```bash
curl -X 'GET' \
  'https://prod.api.market/api/v1/text-to-speech/text-to-speech/languages/list' \
  -H 'accept: application/json' \
  -H 'x-api-market-key: API_KEY'
```

**Response**

<pre class="language-json"><code class="lang-json"><strong>{
</strong>  "status": 0,
  "msg": "Success",
  "languages": [
    "en",
    "fr-fr",
    "pt-br"
  ]
}
</code></pre>

`POST /tts/run`

**Request**

```bash
curl -X 'POST' \
  'https://prod.api.market/api/v1/text-to-speech/text-to-speech/tts/run' \
  -H 'accept: audio/wav' \
  -H 'x-api-market-key: API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "speaker_id": 1,
  "lang": "en",
  "text_data": "Hi, this is the text that I want to transform into speech."
}'
```

Just paste the curl request in the Postman or terminal to receive the response result of the request.&#x20;

**Developer Portal :** <https://api.market/store/text-to-speech/text-to-speech>