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

# Sound Design

> Generate professional sound effects and design elements.

# Sound Design

`POST /api/v1/creative/sound`

Generates custom sound effects and design elements from text prompts.

**Credit rate:** 150 credits per generation

## Request

```bash theme={null}
curl -X POST https://www.voicelab360.com/api/v1/creative/sound \
  -H "Authorization: Bearer vl360_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Cinematic tension sting, orchestral, 3 seconds",
    "duration_seconds": 3,
    "format": "wav"
  }'
```

## Parameters

| Parameter          | Type    | Required | Description                                                        |
| ------------------ | ------- | -------- | ------------------------------------------------------------------ |
| `prompt`           | string  | Yes      | Text description of the sound to generate. Maximum 500 characters. |
| `duration_seconds` | integer | No       | Target duration: 1 to 30 seconds. Default: 5                       |
| `format`           | string  | No       | `wav` (default), `mp3`, `flac`                                     |

## Response

```json theme={null}
{
  "job_id": "job_snd_001",
  "status": "completed",
  "output_url": "https://cdn.voicelab360.com/sound/job_snd_001.wav",
  "duration_ms": 3000,
  "credits_used": 150
}
```
