Skip to main content
Version: 1.0.0

Create a new clip (stream)

Creates a new clip and returns the audio data (wav format) in a stream. Streaming attempts to be the fastest way to playback synthesized content.

note

The streaming API is not available to all users. Please reach out to team@resemble.ai to inquire more.

HTTP Request

POST <YOUR_STREAMING_ENDPOINT>

danger

Notice that the request is sent to our synthesis servers directly instead of app.resemble.ai. Contact team@resemble.ai for more information!

JSON Body ParameterDescription
dataSSML or text to be synthesized.
project_uuidThe uuid of the project to save clips to after the stream is complete
voice_uuidThe uuid of the voice to use for creating streamable clips
quality(optional) One of the following values x-high, high (default), medium, or low.

HTTP Response

A successful response contains bytes which make up a 1-channel PCM_32 wav file. It can be decoded and played back on the fly.

Examples

Remember

Make sure you replace YOUR_API_TOKEN and YOUR_STREAMING_ENDPOINT with your own!

cURL

curl --request POST "YOUR_STREAMING_ENDPOINT" \
-H "x-access-token: YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
--data '{ \
"data": "Streaming helps deliver synthesized audio before it is entirely ready!", \
"project_uuid": "<PROJECT_UUID>", \
"voice_uuid": "<VOICE_UUID>" \
}'