# ElevenLabs Sound Effects v3 (`eleven_sound_effects_v3`)

> ElevenLabs SFX v3. Sound effects from a text prompt (up to 450 characters), 0.5-30 s or a length the model picks, with optional seamless looping.

- Capability: Music (tool `music`) — Text to audio
- Price: $0.002 per second on the cheapest route; the total depends on the request (1 credit = $0.01). Exact price for a request: POST https://api.varg.ai/v2/estimate
- Typical time: ~15 s
- JSON Schema: https://api.varg.ai/v2/tools/music?model=eleven_sound_effects_v3 (public, no key)
- Try it: https://varg.ai/dashboard/tools/playground?model=eleven_sound_effects_v3

## Call it

REST: `POST https://api.varg.ai/v2/tools/music/call` with `Authorization: Bearer $VARG_API_KEY` (create a key at https://varg.ai/dashboard/api).
It answers `202` with a job right away. Poll `GET /v2/jobs/{id}` until `status` is `completed`, then read `output.outputs[0].url` — or pass `options.webhook_url` and get the finished job POSTed to you.

```bash
curl -X POST https://api.varg.ai/v2/tools/music/call \
  -H "Authorization: Bearer $VARG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "eleven_sound_effects_v3",
  "duration": 5
}'
```

MCP: the varg server `https://mcp.varg.ai/mcp` (OAuth sign-in, no key) runs it with `call_tool`:

```json
{
  "tool": "music",
  "input": {
    "model": "eleven_sound_effects_v3",
    "duration": 5
  },
  "wait": true
}
```

## Inputs

| field | type | required | default | allowed | description |
|---|---|---|---|---|---|
| `model` | string | yes | — | `eleven_sound_effects_v3` or a route key below | Which model runs the job. |
| `prompt` | string | yes | — | — | — |
| `duration` | integer | no | — | 1–600 | — |

Media inputs are URLs. Upload a local file first with `POST /v2/files` and pass the returned URL.

## Provider options

Optional, per provider, under `provider_options.<provider>`. Only the options of the provider that runs the job apply — pin a route to choose it.

### provider_options.fal

| field | type | required | default | allowed | description |
|---|---|---|---|---|---|
| `text` | string | no | — | — | The text describing the sound effect to generate |
| `loop` | boolean | no | — | — | Whether to create a sound effect that loops smoothly. |
| `output_format` | string | no | — | mp3_22050_32 \| mp3_44100_32 \| mp3_44100_64 \| mp3_44100_96 \| mp3_44100_128 \| mp3_44100_192 \| pcm_8000 \| pcm_16000 \| pcm_22050 \| pcm_24000 \| pcm_44100 \| pcm_48000 \| ulaw_8000 \| alaw_8000 \| opus_48000_32 \| opus_48000_64 \| opus_48000_96 \| opus_48000_128 \| opus_48000_192 | — |
| `duration_seconds` | integer | no | — | 0.5–30 | — |
| `prompt_influence` | number | no | — | 0–1 | How closely to follow the prompt (0-1). Higher values mean less variation. |

## Routes

`"model": "eleven_sound_effects_v3"` picks a route automatically (priority order, then the inputs you send). To pin one, pass its key as `model`.

| model key | provider | modality | price from | typical time |
|---|---|---|---|---|
| `fal:elevenlabs/sound-effects/v3` | fal | text-to-audio | $0.002/s | ~15 s |

---

Catalog version 2026-11-11T12:59:09.901887+00:00. All models: https://varg.ai/models/llms.txt
