Skip to navigation
ElevenAPISound Effects

Create sound effect

Turn text into sound effects for your videos, voice-overs or video games using the most advanced sound effects models in the world.

Headers

xi-api-keystringOptional

Query parameters

output_formatenumOptionalDefaults to mp3_44100_128

Output format of the generated audio. Formatted as codec_sample_rate_bitrate. So an mp3 with 22.05kHz sample rate at 32kbs is represented as mp3_22050_32. MP3 with 192kbps bitrate requires you to be subscribed to Creator tier or above. PCM and WAV formats with 44.1kHz sample rate requires you to be subscribed to Pro tier or above. Note that the μ-law format (sometimes written mu-law, often approximated as u-law) is commonly used for Twilio audio inputs.

enable_loggingbooleanOptionalDefaults to true

When enable_logging is set to false zero retention mode will be used for the request. Zero retention mode may only be used by enterprise customers.

Request

This endpoint expects an object.
textstringRequired
The text that will get converted into a sound effect.
loopbooleanOptionalDefaults to false
Whether to create a sound effect that loops smoothly.
duration_secondsdouble or nullOptional
The duration of the sound which will be generated in seconds. Must be at least 0.5 and at most 30. If set to None we will guess the optimal duration using the prompt. Defaults to None.
prompt_influencedouble or nullOptionalDefaults to 0.3
A higher prompt influence makes your generation follow the prompt more closely while also making generations less variable. Must be a value between 0 and 1. Defaults to 0.3.
model_idenumOptionalDefaults to eleven_text_to_sound_v2
The model ID to use for the sound generation.
Allowed values:

Response headers

character-coststringOptional
The number of characters used for billing

Response

The generated sound effect audio, encoded in the specified output_format.

Errors

422
Unprocessable Entity Error