Audio Preview

The Voice API enables the generation of voice previews based on text.

The Voice API will require sending:

1. The Draft ID - this will be the draft id with containing the chosen voice

2. Transcript - the text the voice will read, up to 500 characters

Create Audio Preview

post

create a voice preview based on a source draft

Authorizations

Header parameters

workspace-idstringoptional

team-idstringoptional

Body

transcriptstringrequired

source_draft_idstringrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.makereals.com/api/v1/voice-preview' \
  --header 'api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "transcript": "text",
    "source_draft_id": "text"
  }'

201

422

201

{
  "id": "text",
  "transcript": "text",
  "voice_id": "text",
  "req_id": "text",
  "status": "in_progress"
}

Successful Response

Get Voice Preview

get

Authorizations

Path parameters

task_idstringrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.makereals.com/api/v1/voice-preview/{task_id}' \
  --header 'api-key: YOUR_API_KEY'

200

422

200

{
  "id": "text",
  "req_id": "text",
  "status": "in_progress",
  "url": "text"
}

Successful Response