# Turn your text into Magical-sounding Audio

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

<figure><img src="/files/DJaNE7ktcCByQzvu5yiD" 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.api.market/api-product-docs/text-to-speech/turn-your-text-into-magical-sounding-audio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.