For working example code in all languages see Endpoints

POST

Creates a text to speech job (currently only English language is supported) , which returns ID of the request and ETA (estimated time to completion, in seconds).

Example request body

{
    "text": "Hello, how are you"
}

Example response

{
    "id":"8c011493-d577-4c01-8eb5-6e5951f04d66"
    "status":"processing"
    "eta":3
    "text":"Hello, how are you"
}

GET

Returns the status of the request based on the ID.
If the job is successful it returns URL of the audio file for download. This URL is valid for 24 hours.

Example request

query parameter id (authentication headers are required, see Endpoints for working example code)

https://large-text-to-speech.p.rapidapi.com/tts?id=56fce01a-6590-4b2c-b9a0-fe9d6b702121

Example response - status processing

{
    "id":"f5762bf2-238a-4980-aae9-ac1bb40e2564"
    "status":"processing"
    "eta":93
}

Example response - status success

{
    "id":"f5762bf2-238a-4980-aae9-ac1bb40e2564"
    "status":"success"
    "url":"https://s3.eu-central-1.amazonaws.com/tts-download/3f6b2c173b94c8e21a296924f3c64b0d.wav?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZ3CYNLHHVKA7D7Z4%2F20220212%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20220212T174600Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=7aeacc40bc0659931336eae2e7d96835f4a6d23891b26d78cd9fae9e064577b0"
    "job_time":104
}

Example response - status fail

{
    "id": "56fce01a-6590-4b2c-b9a0-fe9d6b702121",
    "status": "fail",
    "error": "processing failed"
}