> ## Documentation Index
> Fetch the complete documentation index at: https://docs.artificialstudio.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ElevenLabs Sound Effects

> Generate sound effects from text descriptions using ElevenLabs.

| | |
| - | - |
| **Credits** | 1 credit per second |
| **Tool** | `sound-effects` |

### Headers

| Name | Type | Required | Description |
| - | - | - | - |
| `Authorization` | string | Yes | Your API key |
| `Content-Type` | string | Yes | `application/json` |

### Body

| Parameter | Type | Required | Description |
| - | - | - | - |
| `tool` | string | Yes | `sound-effects` |
| `input.model` | string | Yes | `elevenlabs-sound-effects` |
| `input.prompt` | string | Yes | Description of the sound effect |
| `input.duration` | string | No | Options: `auto`, `1`, `2`, `3`, `5`, `10`, `15`, `20`, `30` (default: `auto`) |
| `input.prompt_influence` | number | No | Prompt influence strength. Options: `0.1`, `0.3`, `0.5`, `0.7`, `0.9` (default: `0.3`) |

```bash bash theme={null}
curl -X POST https://api.artificialstudio.ai/api/run \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_KEY" \
  -d '{
    "tool": "sound-effects",
    "input": {
      "model": "elevenlabs-sound-effects",
      "prompt": "Thunder rumbling in the distance",
      "duration": 5
    }
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://api.artificialstudio.ai/api/run', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    tool: 'sound-effects',
    input: {
      model: 'elevenlabs-sound-effects',
      prompt: 'Thunder rumbling in the distance',
      duration: 5
    }
  })
});

const data = await response.json();
```

```python Python theme={null}
import requests

response = requests.post(
    'https://api.artificialstudio.ai/api/run',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'YOUR_API_KEY'
    },
    json={
        'tool': 'sound-effects',
        'input': {
            'model': 'elevenlabs-sound-effects',
            'prompt': 'Thunder rumbling in the distance',
            'duration': 5
        }
    }
)

data = response.json()
```

```json 200 theme={null}
{
  "id": "507f1f77bcf86cd799439011",
  "status": "processing",
  "tool": "sound-effects",
  "createdAt": "2024-01-15T10:30:00.000Z"
}
```

```json 400 theme={null}
{
  "message": "Missing or invalid parameters"
}
```

```json 401 theme={null}
{
  "message": "Invalid or missing API key"
}
```

```json 402 theme={null}
{
  "message": "You do not have enough credits to perform this action"
}
```

```json 429 theme={null}
{
  "message": "Too many API requests, please try again later"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.