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

# Sound Effect

> Generate sound effects with ElevenLabs

Generate sound effects from text descriptions using ElevenLabs AI.

## Model

```
elevenlabs/sound-effect
```

## Parameters

| Parameter          | Type          | Required | Default | Description                                     |
| ------------------ | ------------- | -------- | ------- | ----------------------------------------------- |
| `text`             | string        | Yes      | -       | Description of the sound effect                 |
| `prompt_influence` | number        | No       | `0.5`   | How much the prompt influences generation (0-1) |
| `duration`         | number/string | No       | `auto`  | Duration in seconds (0.5-30) or `"auto"`        |
| `loop`             | boolean       | No       | `false` | If true, audio loops seamlessly                 |

## Duration Options

| Value        | Description                                     |
| ------------ | ----------------------------------------------- |
| `"auto"`     | Automatic duration based on the sound (default) |
| `0.5` - `30` | Specific duration in seconds                    |

## Example - Basic Sound Effect

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "elevenlabs/sound-effect",
    "input": {
      "text": "wolf howling at the moon"
    }
  }'
```

## Example - With Duration

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "elevenlabs/sound-effect",
    "input": {
      "text": "thunder rumbling in the distance",
      "duration": 5,
      "prompt_influence": 0.7
    }
  }'
```

## Example - Looping Sound

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "elevenlabs/sound-effect",
    "input": {
      "text": "rain falling on a window",
      "loop": true,
      "duration": 10
    }
  }'
```

## Example - Ambient Sound

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "elevenlabs/sound-effect",
    "input": {
      "text": "busy coffee shop with people chatting and cups clinking",
      "prompt_influence": 0.8,
      "duration": "auto",
      "loop": true
    }
  }'
```

## Response

```json theme={null}
{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "processing"
  }
}
```

## Completed Response

```json theme={null}
{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "completed",
    "output": {
      "audio_url": "https://files.unifically.com/abc123.mp3"
    }
  }
}
```
