# Music Generator

> The Music Generation API allows you to generate music based on textual prompts and optional conditioning melodies.

## Overview

- **Model ID**: `music_gen`
- **Category**: audio
- **Provider**: modelslab
- **Status**: active
- **Screenshot**: `https://assets.modelslab.com/generations/81518309-4cc2-4c68-b1cb-e6dde58f3ada.webp`

## API Information

This model can be used via our HTTP API. See the API documentation and usage examples below.

### Endpoint

- **URL**: `https://modelslab.com/api/v6/voice/music_gen`
- **Method**: POST

### Parameters

- **`prompt`** (required): Prompt
  - Type: textarea
  - Example: Prompt

- **`init_audio`** (required): init_audio 
  - Type: file (URL)
  - Example: init_audio 

- **`sampling_rate `** (optional): Sampling rate of the generated music. Default: 32000, Minimum: 10000.
  - Type: number (range: 10000-100000)
  - Example: Sampling rate

## Usage Examples

### cURL

```bash
curl --request POST \
  --url https://modelslab.com/api/v6/voice/music_gen \
  --header "Content-Type: application/json" \
  --data '{
    "key": "YOUR_API_KEY",
    "model_id": "music_gen",
    "prompt": "marimba, percussion, bass, tropical house, melodic riff, G# minor, 96 bpm",
    "init_audio": "https://pub-3626123a908346a7a8be8d9295f44e26.r2.dev/livewire-tmp/IxizU51vL2IwiEjy6XtvbDECa9f16E-metaU2hhcGUgb2YgeW91IFJpbmd0b25lIO+9nO+9nCBJbnN0cnVtZW50YWwgQkdNIO+9nO+9nCBMSUdIVCBHT0pPLndhdg==-.wav",
    "sampling_rate ": "32000"
  }'
```

### Python

```python
import requests

response = requests.post(
    "https://modelslab.com/api/v6/voice/music_gen",
    headers={
        "Content-Type": "application/json"
    },
    json={
        "key": "YOUR_API_KEY",
        "model_id": "music_gen",
        "prompt": "marimba, percussion, bass, tropical house, melodic riff, G# minor, 96 bpm",
        "init_audio": "https://pub-3626123a908346a7a8be8d9295f44e26.r2.dev/livewire-tmp/IxizU51vL2IwiEjy6XtvbDECa9f16E-metaU2hhcGUgb2YgeW91IFJpbmd0b25lIO+9nO+9nCBJbnN0cnVtZW50YWwgQkdNIO+9nO+9nCBMSUdIVCBHT0pPLndhdg==-.wav",
        "sampling_rate ": "32000"
    }
)

print(response.json())
```

### JavaScript

```javascript
fetch("https://modelslab.com/api/v6/voice/music_gen", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "key": "YOUR_API_KEY",
    "model_id": "music_gen",
    "prompt": "marimba, percussion, bass, tropical house, melodic riff, G# minor, 96 bpm",
    "init_audio": "https://pub-3626123a908346a7a8be8d9295f44e26.r2.dev/livewire-tmp/IxizU51vL2IwiEjy6XtvbDECa9f16E-metaU2hhcGUgb2YgeW91IFJpbmd0b25lIO+9nO+9nCBJbnN0cnVtZW50YWwgQkdNIO+9nO+9nCBMSUdIVCBHT0pPLndhdg==-.wav",
    "sampling_rate ": "32000"
  })
})
.then(response => response.json())
.then(data => console.log(data));
```

## Links

- [Model Playground](https://modelslab.com/models/music_gen/music_gen)
- [API Documentation](https://docs.modelslab.com)
- [ModelsLab Platform](https://modelslab.com)