> ## Documentation Index > Fetch the complete documentation index at: https://docs.goenhance.ai/llms.txt > Use this file to discover all available pages before exploring further. # ElevenLabs Sound Effects v3 > Turn a text description into a sound effect or ambience clip: footsteps, explosions, UI sounds, weather, crowds, background beds. - The clip is exactly `duration` seconds long (0.5 to 30, at most one decimal place). `duration` is the billed length. - Set `loop` to `true` for ambience or background audio that should repeat seamlessly. - Describe the sound itself rather than music; for songs or instrumentals use the music models. **Pricing**: 0.13 tokens ($0.0026) per second of `duration`. | Option | Tokens | USD | |---|---|---| | Per second of audio | 0.13 | $0.0026 | | 5-second clip | 0.65 | $0.013 | | 30-second clip (maximum) | 3.9 | $0.078 | **Result**: one `json` item `{ "type": "audio", "value": "https://...mp3" }`, MP3 44.1 kHz 128 kbps. Result links expire (see `link_expired_at`). 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: | Length | Tokens | USD | | - | - | - | | per second | 0.13 | \$0.0026 | | 5 seconds | 0.65 | \$0.013 | | 30 seconds (maximum) | 3.9 | \$0.078 | `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`. ## OpenAPI ````yaml api-reference/audio-generations/openapi-elevenlabs-sound-effects-v3.json POST /api/v1/audio/generations openapi: 3.1.0 info: title: GoEnhance API - ElevenLabs Sound Effects v3 description: Generate a sound effect or ambience clip from a text description. version: 1.0.0 servers: - url: https://api.goenhance.ai security: [] paths: /api/v1/audio/generations: post: tags: - AudioGenerations summary: ElevenLabs Sound Effects v3 description: >- Turn a text description into a sound effect or ambience clip: footsteps, explosions, UI sounds, weather, crowds, background beds. - The clip is exactly `duration` seconds long (0.5 to 30, at most one decimal place). `duration` is the billed length. - Set `loop` to `true` for ambience or background audio that should repeat seamlessly. - Describe the sound itself rather than music; for songs or instrumentals use the music models. **Pricing**: 0.13 tokens ($0.0026) per second of `duration`. | Option | Tokens | USD | |---|---|---| | Per second of audio | 0.13 | $0.0026 | | 5-second clip | 0.65 | $0.013 | | 30-second clip (maximum) | 3.9 | $0.078 | **Result**: one `json` item `{ "type": "audio", "value": "https://...mp3" }`, MP3 44.1 kHz 128 kbps. Result links expire (see `link_expired_at`). parameters: - name: Authorization in: header description: '' required: false example: '{{Authorization}}' schema: type: string requestBody: content: application/json: schema: type: object properties: model: type: string enum: - elevenlabs-sound-effects-v3 description: Model name. Must be `elevenlabs-sound-effects-v3`. prompt: type: string maxLength: 1000 description: >- 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. duration: type: number minimum: 0.5 maximum: 30 multipleOf: 0.1 description: >- 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. loop: type: boolean default: false description: >- Optional. `true` makes the clip loop seamlessly, for ambience and background beds. Default `false`. prompt_influence: type: number minimum: 0 maximum: 1 description: >- 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. custom_callback_url: type: string format: uri description: >- 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 required: - model - prompt - duration example: model: elevenlabs-sound-effects-v3 prompt: Heavy rain on a tin roof with distant rolling thunder duration: 10 loop: true responses: '200': description: '' content: application/json: schema: type: object properties: code: type: integer msg: type: string data: type: object properties: img_uuid: type: string cost: type: number description: >- Tokens deducted for this request. This is the amount actually charged, so it already reflects any discount active on your account and can be lower than the listed price. Tokens are deducted when the task is accepted, and refunded automatically if the generation ends in failure. example: 1.3 required: - img_uuid - cost required: - code - msg - data examples: '1': summary: Success value: code: 0 msg: Success data: img_uuid: c12b656c-747a-44fd-9c80-add79b0c52d5 cost: 1.3 '2': summary: Insufficient tokens value: code: 100 msg: tokens is not enough quota: summary: API key quota exceeded value: code: 101 msg: 'API key quota exceeded: 4990 of 5000 tokens used (monthly)' bad: summary: Invalid parameters value: code: -1 msg: >- duration is required: the length in seconds (0.5-30), which is also the billed length headers: {} '401': description: '' content: application/json: schema: type: object properties: code: type: integer msg: type: string headers: {} deprecated: false ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.