Text-to-Speech Streaming

Create text-to-speech audio and return streaming audio response.

POST /sound_clone/api/v1/tts/stream

Default model path

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/tts/stream' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
  "voiceId": "<voice_id>",
  "title": "tts-stream-default",
  "text": "Hello from MyVocal streaming endpoint.",
  "language": "en",
  "voiceSettings": {
    "stability": 0.7
  }
}' \
--output output-default.mp3

200 Success

audio/mpeg stream (binary)

Header

accessKey · string · required

API key for authentication.

Body

voiceId · string · required

Voice ID returned by GET /sound_clone/api/v1/voices.

title · string

Optional title for the generated record.

text · string · required

Text to synthesize.

language · string

Language selector.

modelId · string

Optional explicit model selector.

voiceSettings · object

For advanced settings, use suggested values unless you have strong tuning needs.

Show Toggle object

stability · number · default: "0.7"

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.

For myvocal_v3, the currently publicly documented stability values are:

Prompt Control (myvocal_v3)

Reference capability source: v3.myvocal.ai. Use [tag] in text to guide style and delivery.

Basic syntax:

[tag] Your text content

Examples:

[happy] Hello everyone, welcome to MyVocal.
[laughter] That was funny.

Representative categories:

• Emotion control: happy, excited, sad, angry, surprised
• Non-speech sounds: laughter, throat clearing, yawning, shushing, screaming
• Sound-related effects: breathing, sighing, gasping, crying, murmuring

Response

Content-Type · string

Success usually returns audio/mpeg.

Body · stream

Binary audio stream payload.

Default model path

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/tts/stream' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
  "voiceId": "<voice_id>",
  "title": "tts-stream-default",
  "text": "Hello from MyVocal streaming endpoint.",
  "language": "en",
  "voiceSettings": {
    "stability": 0.7
  }
}' \
--output output-default.mp3

200 Success

audio/mpeg stream (binary)

Common errors

• Invalid language option.: non-V3/default path is missing or using an unsupported language value.
• VOICE_NOT_FOUND: voiceId is invalid or not available under this API key.
• code = -1: upstream or backend failed to complete generation.