> ## 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.

# Music Generation

> Generate original music tracks from text prompts.

# Music Generation

`POST /api/v1/creative/music`

Generates original, licensable music tracks from descriptive prompts.

**Credit rate:** 750 credits per minute of output

## Request

```bash theme={null}
curl -X POST https://www.voicelab360.com/api/v1/creative/music \
  -H "Authorization: Bearer vl360_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Uplifting corporate background, piano and strings, 60 seconds",
    "duration_seconds": 60,
    "format": "mp3",
    "instrumental": true
  }'
```

## Parameters

| Parameter          | Type    | Required | Description                                               |
| ------------------ | ------- | -------- | --------------------------------------------------------- |
| `prompt`           | string  | Yes      | Description of the desired music. Maximum 500 characters. |
| `duration_seconds` | integer | No       | Duration: 10 to 300 seconds. Default: 30                  |
| `format`           | string  | No       | `mp3` (default), `wav`, `flac`                            |
| `instrumental`     | boolean | No       | Generate without vocals. Default: true                    |

## Response

```json theme={null}
{
  "job_id": "job_mus_001",
  "status": "completed",
  "output_url": "https://cdn.voicelab360.com/music/job_mus_001.mp3",
  "duration_ms": 60000,
  "credits_used": 750
}
```

All generated music is licensed for commercial use under your active VoiceLab360 API plan terms.