Introduction
Describe what is heard, where it happens and in what order. ElevenLabs Sound Effects V3 returns one audio clip at the length you request.
| Field | Value |
|---|---|
| Input | Text |
| Output | Audio |
| Publisher | ElevenLabs |
| Release date | October 29, 2026 |
| Modality | Audio |
| Task | Text to Sound Effects |
| Required input | Nonempty text prompt describing sounds, environment and event order |
| Requested duration | 0.5 to 30 seconds; default 5 seconds |
| Loop control | Boolean; off by default |
| Prompt influence | 0 to 1; default 0.3 |
| Example clips | Two 5-second MP3 files, with looping off and on respectively |
| Billing basis | Per started second of requested length; one-second minimum; failed requests are not charged |
Key features & highlights
A harbor cue with looping off
The harbor request describes gull calls over small waves at a quiet dock. It returned a 5-second MP3 using the default influence of 0.3 and looping off. Listen to the clip alongside your waterside scene to judge the balance you want between birds and water.
Rain on a named surface
The rain request pairs a short description of a resonating surface with looping on. It returned a 5-second MP3. Use the same approach for a sustained background texture, then listen across the repeat join to check how it fits the scene.
Revise the cue without losing track
Length, repetition and prompt adherence address different decisions. Keep the description unchanged when comparing a control, and save the settings with the returned clip so you can identify which version belongs in the edit.
Request parameters
| Parameter | Required | Description |
|---|---|---|
prompt | Yes | The sound, its environment and the order of events. at least 1 characters |
duration_seconds | No | Length from 0.5 to 30 seconds. Default 5. |
loop | No | Requests a clip designed to repeat smoothly. Off by default. Default: |
prompt_influence | No | From 0 to 1. Higher values follow the prompt more closely. |
Pricing
$0.0024 / second
ElevenLabs Sound Effects V3 is billed per started second of requested length, with a one-second minimum. Failed requests are not charged.
Use cases
Harbor atmosphere for a location edit
Use the harbor prompt as a starting direction for a waterside scene. It combines gull calls, small waves and a dock in one description; our request returned a 5-second MP3 with looping off.
Rain texture beneath an interior scene
The tin-roof example gives a concrete surface to a weather cue. Our request returned a 5-second MP3 with looping on. Try that combination of a sustained sound and a named material when preparing background audio for repeated playback.
Material cues for product footage
For a product edit, describe a latch, sliding drawer or metal panel by its action and material. Include the surrounding space and any trailing rattle or decay so the direction captures how the object should sound in the scene.
Event sequences for game prototypes
Describe a workshop door opening followed by a cart rolling across the floor, then choose a length that leaves room for both events. The endpoint accepts ordered sound descriptions; compare the generated cue with gameplay timing before using it.
Prompt guide & pro tips
Describe an audible event
Name what makes the sound, the material involved and the space around it. For a sequence, describe the events in the order you want to hear them.
Choose a useful clip length
Set a duration from 0.5 to 30 seconds, with 5 seconds as the default. Leave enough room for the action and its decay, and check the price shown for the requested length.
Set repetition and adherence
Turn on looping for a repeating atmosphere or texture. Begin at the default influence of 0.3 and change it when comparing how closely the result follows your direction.
Listen in the intended context
Compare the returned clip with the written cue and the scene it accompanies. For looping playback, listen across the end-to-start join before placing it throughout a longer edit.
Build a sound cue from a written direction
Turn a description of an audible event into a short effect for an edit, a game scene or an audio production. Name the source, place it in an environment and describe what happens over time. Choose a clip length from 0.5 to 30 seconds, request looping when the sound needs to repeat, and adjust prompt influence to explore adherence to the direction.
ElevenLabs says SFX V3 follows instructions involving several sounds more closely than V2. For a sequence, write the events in the order you want to hear them and allow room for the final sound to decay.
Choose the request settings
A nonempty prompt is required. Duration, looping and influence have defaults, so you can begin with a written cue and change the controls as the scene develops.
| Parameter | Type | Accepted value | Default | Purpose |
|---|---|---|---|---|
prompt | String | Nonempty text | Required | Describe the sound, environment and event order. |
duration_seconds | Number | 0.5 to 30 | 5 | Set the requested clip length in seconds. |
loop | Boolean | true or false | false | Request a clip designed to repeat smoothly. |
prompt_influence | Number | 0 to 1 | 0.3 | Control how closely the result follows the description. |
Match length to the action
A latch closing and rain continuing across a roof call for different pacing. Choose enough time for the action and its ending, then check the result against the space available in your edit. Keep a short cue focused on a small set of sounds rather than compressing an entire scene into it. The duration defaults to 5 seconds and can be set between 0.5 and 30 seconds.
Separate looping from duration
Enable loop for a texture intended to repeat, such as steady rain or a ventilation hum. The setting requests repeating playback within the length you select. Listen to several repeats in your editor, paying attention to the end-to-start transition and any distracting change in level. Keep looping off when developing a cue with a distinct beginning and ending.
Compare adherence without rewriting the cue
The influence range is 0 to 1, with 0.3 as the default. Higher values ask for closer adherence to the prompt. When exploring this setting, keep the description, length and loop setting unchanged so you can focus your listening on the change you requested. Save the chosen settings alongside the clip for later revisions.
Write directions you can evaluate by ear
Start with what makes the sound and what it does: a steel latch clicks shut, a cart rolls over concrete, or rain strikes a tin roof. Add the environment when it affects the intended character. A quiet workshop gives a mechanical cue a different context from an open harbor. Keep descriptive details tied to what the listener should hear.
Make the order easy to follow
Connect actions with words such as “then” and describe how the sequence ends. For example, a workshop door opens, a cart rolls across the floor, then the cart stops. This gives you a concrete order to check against the returned clip. If the sequence feels crowded, simplify the direction or choose a longer duration within the supported range.
ElevenLabs says exact repetition counts may be missed. When a cue depends on a precise count, listen to the returned sound and adjust its placement in your editing workflow.
Give ambience a clear source
For a repeating background, identify a sustained sound and the material or space that gives it character. “Steady rain on a tin roof.” keeps attention on a single weather texture and surface. A fan humming in a repair shop similarly gives the direction a stable source. Set looping through the control, then review the repeated clip beneath the scene where it will be used.
Hear the harbor and rain examples
Our November 18, 2026 requests returned two 5-second MP3 files. Both used a prompt influence of 0.3, with different loop settings for the two directions.
Gulls and waves at a dock
“Seagulls call over a quiet harbor as small waves lap against the dock.” returned a 5-second MP3 with looping off. The prompt places two sound sources in the same environment. Use it as a starting direction for a waterside cue, then listen alongside your scene to decide how the birds and water should sit in the edit.
Rain against a tin roof
“Steady rain on a tin roof.” returned a 5-second MP3 with looping on. The short direction names both the ongoing event and its surface. Play the clip on repeat when preparing a longer background and review the join in the context of the surrounding audio.
Budget by requested length
Refer to the price displayed on this page when planning a request. Billing counts each started second of requested length, with a one-second minimum. Failed requests are not charged. Choose the duration before submitting and keep it consistent when comparing prompt revisions, so each candidate addresses the same space in your edit.
Explore related audio families
Consider foley/v1 for a Foley-focused project, seed-audio/1.0 when exploring another audio family, or elevenlabs/music-v2.5 for a music project. Review each family's supported inputs and examples against your task. For this endpoint, prepare a written sound description and use duration, looping and influence to shape the request.
API quick start
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "elevenlabs/sound-effects-v3/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif",
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
See the API reference for authentication, the complete schema, polling, and error handling.






