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

# The First Time

Welcome to your **first experience** with the Musicgpt API — where creativity meets technology. Browse the wide range of features available for you through our API.

***

## Integrate in 5 minutes with 5 steps:

<div style={{ textAlign: "center", fontWeight: "bold" }}>
  "A single API offering 20+ powerful features"
</div>

1. [Activate](https://musicgpt.com/api-dashboard) your API Key.
2. Go to [Documentation](https://docs.musicgpt.com/api-documentation/index/introduction).
3. Inside features, you can click Try-it button to open a live [playground](https://docs.musicgpt.com/api-documentation/conversions/musicai?playground=open).
4. You can also use the multi-language code samples provided for each feature to run it locally.
5. To get result: Set the [**webhook\_url**](https://docs.musicgpt.com/api-documentation/index/webhook) to an endpoint on your server or retrieve the result through our helper endpoint [**get conversion by id**](https://docs.musicgpt.com/api-documentation/endpoint/getById) instead.

## Available Features

### Music Generation Features 🎵

* **AI Music Generator**: Create original music from text prompts
* **Custom Voice Music Generator**: Generate songs with AI vocals in different voice styles
* **Cover Song**: Create AI-powered covers of existing songs
* **Remix**: Transform tracks into new musical styles using AI

### Voice & Speech Features

* **Text to Speech**: Convert text to natural-sounding speech
* **Voice Changer**: Modify voices in existing audio to different characteristics

### Sound Design

* **Sound Generator**: Create sound effects and audio elements from text prompts

### Extraction & Stem Separation

#### Vocal Processing

* **Vocal Extraction**: Isolate vocals from music tracks
* **Gender-Based Vocal Extraction**: Separate male and female vocals
* **Lead/Back Vocals Separation**: Split main vocals from backing harmonies

#### Instrument Separation

* **Instrumental Extraction**: Remove vocals to create instrumental versions
* **Guitar Type Stems**: Separate acoustic and electric guitars
* **Guitar Part Stems**: Isolate rhythm vs lead guitar parts
* **Strings Stems**: Extract string instrument sections
* **Keys Extraction**: Isolate piano and keyboard parts
* **Winds Splitter**: Separate wind instruments

#### Advanced Band Separation

* **Band Parts Splitter**: Extract drums, bass, piano, and guitar stems
* **Premium Bass/Drums Split**: High-accuracy rhythm section isolation
* **Drum Stems Separation**: Separate individual drum components

### Audio Enhancement Features

* **Voice Cleaner (Denoise)**: Remove background noise from audio
* **DeEcho**: Eliminate echo effects
* **DeReverb**: Reduce unwanted reverb
* **Audio Cutter**: Trim and edit audio clips
* **Speed Changer**: Adjust playback speed
* **Audio Mastering**: Enhance overall sound quality
* **File Converter**: Convert between audio formats

### Audio Analysis Features

* **Key & BPM Detector**: Identify musical key and tempo
* **Audio Transcription**: Convert speech to text with translation
* **Audio to MIDI**: Transform audio into MIDI sequences

***

## Your First AI Song

Let’s generate a **country song about our love for AI-generated music**

We’ll use the `MUSIC_AI` feature with the following endpoint:

```http theme={null}
POST https://api.musicgpt.com/api/public/v1/MusicAI
```

***

## Example Request

```bash theme={null}
curl -X 'POST' \
'https://api.musicgpt.com/api/public/v1/MusicAI' \
-H 'accept: application/json' \
-H 'Authorization: <api_key>' \
-H 'Content-Type: application/json' \
-d '{
  "music_style": "Song about my love to AI Music in Country Style",
  "webhook_url": "http://webhook.yourwebsite.com"
}'
```

> 🧠 Replace `<api_key>` with your actual API Key from your Musicgpt dashboard.

## Webhook Integration

To get notified when the music generation is complete, we recommend setting up a webhook. This allows you to receive the URL of the generated song directly.

> 🔗 Set the `webhook_url` to an endpoint on your server — this is where Musicgpt will notify you once the generation is done.

> **Tip:** If you can’t use a webhook (e.g., code running on a user device), you can retrive the result through our helper endpoint [get conversion by id](/api-documentation/endpoint/getById) instead.

***

## 📦 Example Webhook Response

```json theme={null}
{
  "success": true,
  "task_id": "string",
  "conversion_id": "string",
  "audio_url": "https://...", // signed AWS URL, valid for 1 day
  "conversion_cost": 1.0,
  "title": "string",
  "lyrics": "string",
  "prompt": "string",
  "music_style": "string"
}
```

***

## 🎉 Mission Accomplished!

You just generated your **first AI song** using the Musicgpt API. Now go make something amazing ✨

Need more help? Check out other endpoints and guides in the [documentation](/api-documentation/index/introduction)!