Text-to-Speech Streaming

Generate a text-to-speech audio using a voice of your choice and returns audio stream.(❗❗❗File-related interfaces are not supported, please use interface tools for requests.)

Header

accessKey · string · required

You can copy your api-key on https://www.myvocal.ai/profile after you have subscribed to Pro or Business Plan.

Body

voiceId · string

Your voiceId

title · string

Please do not exceed 32 characters in length. If this parameter is null, it will all default to “Untitled_TTS”

text · string

The maximum number of characters you can input at once depends on the benefits of your subscription plan.

language · string

Please select form:

voiceSettings · object

For some advanced settings, it is generally recommended to use the suggested parameters.

Show Toggle object

stability · number

a decimal between 0 and 1, in increments of 0.1, with a recommended default value of 0.7.

When your parameters are set lower, the emotional variation of the TTS audio will be more abundant. Even for the same text, the effects generated multiple times will be different. You can choose the most suitable one by generating the same text’s TTS audio multiple times.

When your parameters are set higher, the emotion of the TTS audio will tend to be consistent.

Response

Header

Content-Type · string

If the request is successful, this value in the callback is audio/mpeg.

This response is stream.

Example Request

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/tts/stream' \
--header 'accessKey: xxx' \
--header 'Content-Type: application/json' \
--data '{
	"voiceId": "7813",
	"title": "female",
	"text": "Generate a text-to-speech audio using a voice of your choice and returns audio stream.",
	"language": "original_english",
	"voiceSettings":{
        "stability":0.7
    }
}'

200（success）

This response is stream.