Skip to main content
POST
ElevenLabs Sound Effects v3
ElevenLabs sound effects. Turns a text description into a sound effect or ambience clip and returns an MP3 URL (44.1 kHz, 128 kbps). You set the exact length; set loop to true for ambience that repeats seamlessly. Pricing — billed per second of the duration you request: duration is required: 0.5 to 30 seconds, at most one decimal place (e.g. 2.5). Returns an img_uuid; poll GET /api/v1/jobs/detail (or use custom_callback_url) to get the generated audio. The result arrives as a json array item with type: "audio" and an mp3 URL in value.

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be elevenlabs-sound-effects-v3.

Available options:
elevenlabs-sound-effects-v3
prompt
string
required

Describe the sound you want, e.g. Heavy rain on a tin roof with distant rolling thunder or Glass shattering on a tile floor. Max 1000 characters.

Maximum string length: 1000
duration
number
required

Required. Length of the clip in seconds, 0.5 to 30, with at most one decimal place (e.g. 2.5). This is the billed length.

Required range: 0.5 <= x <= 30Must be a multiple of 0.1
loop
boolean
default:false

Optional. true makes the clip loop seamlessly, for ambience and background beds. Default false.

prompt_influence
number

Optional, 0 to 1. Higher values follow the prompt more closely with less variation; lower values give the model more creative freedom. Uses the model's default (0.3) when omitted.

Required range: 0 <= x <= 1
custom_callback_url
string<uri>

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required