GET /api/speak/v2/{ :id }

An API for reading status about synthesis voice.

Request

Headers

Parameters

  • None

Example with cURL
curl \
  --request GET \
  --url https://typecast.ai/api/speak/{your-speak-id} \
  --header "Authorization: Bearer $API_TOKEN"

Response

Status Code

status code

value

401

Authorization Error

200

JSON Object that has result.

result consists of followings

key

description

audio_download_url

an url for audio file that will be expired after 24 hours later.

status

status of synthesizing voice.

done - downloadable audio file is ready.

progress - you have to wait few seconds.

failed - your request is failed.

started - Synthesizing is ready to proceed.

text_count

length of the text that you requested.

duration

how much time it took. (sec)

Example
{
  "result": {
      "_id": "64a25c4fe671d3676a7a6332",
      "audio_download_url": "https://cdn.typecast.ai/blah_the_audio_file_url_blah",
      "text_count": 7,
      "duration": 1.436734693877551,
      "status": "done"
  }
}