REST API Documentation

1import requests
2import time
3
4API_KEY = "your_api_key_here"
5BASE_URL = "https://www.musicmcp.ai/api"
6
7def generate_custom_music():
8    headers = {
9        "api-key": API_KEY,
10        "Content-Type": "application/json"
11    }
12
13    # Step 1: Submit generation request
14    payload = {
15        "title": "Summer Vibes",
16        "lyric": "Walking on sunshine, feeling so free",
17        "tags": "pop, upbeat",
18        "instrumental": False
19    }
20
21    response = requests.post(
22        f"{BASE_URL}/music/generate/custom",
23        headers=headers,
24        json=payload
25    )
26
27    if response.status_code != 200:
28        print(f"Error: {response.status_code}")
29        print(response.json())
30        return
31
32    # Extract song IDs from response
33    result = response.json()
34    song_ids = result['data']['ids']
35    print(f"Generation started. Song IDs: {song_ids}")
36
37    # Step 2: Poll for completion
38    while True:
39        query_response = requests.post(
40            f"{BASE_URL}/music/generate/query",
41            headers=headers,
42            json={"ids": song_ids}
43        )
44
45        if query_response.status_code == 200:
46            query_result = query_response.json()
47            songs = query_result['data']['songs']
48
49            # Check if all songs are completed (status = 1)
50            all_completed = all(song['status'] == 1 for song in songs)
51
52            if all_completed:
53                print(f"\nGenerated {len(songs)} songs successfully!")
54                for i, song in enumerate(songs, 1):
55                    print(f"\nSong {i}:")
56                    print(f"  Title: {song['songName']}")
57                    print(f"  URL: {song['songUrl']}")
58                    print(f"  Duration: {song['duration']}s")
59                break
60            else:
61                print("Generation in progress...")
62                time.sleep(2)  # Wait 2 seconds before next poll
63        else:
64            print(f"Query error: {query_response.status_code}")
65            break
66
67generate_custom_music()

1const axios = require('axios');
2
3const API_KEY = 'your_api_key_here';
4const BASE_URL = 'https://www.musicmcp.ai/api';
5
6async function generateInspirationMusic() {
7  try {
8    // Step 1: Submit generation request
9    const response = await axios.post(
10      `${BASE_URL}/music/generate/inspiration`,
11      {
12        prompt: 'Create a relaxing ambient track for meditation',
13        instrumental: true,
14        style: 'ambient'
15      },
16      {
17        headers: {
18          'api-key': API_KEY,
19          'Content-Type': 'application/json'
20        }
21      }
22    );
23
24    // Extract song IDs
25    const songIds = response.data.data.ids;
26    console.log('Generation started. Song IDs:', songIds);
27
28    // Step 2: Poll for completion
29    while (true) {
30      const queryResponse = await axios.post(
31        `${BASE_URL}/music/generate/query`,
32        { ids: songIds },
33        {
34          headers: {
35            'api-key': API_KEY,
36            'Content-Type': 'application/json'
37          }
38        }
39      );
40
41      const songs = queryResponse.data.data.songs;
42
43      // Check if all songs are completed (status = 1)
44      const allCompleted = songs.every(song => song.status === 1);
45
46      if (allCompleted) {
47        console.log(`\nGenerated ${songs.length} songs successfully!`);
48        songs.forEach((song, index) => {
49          console.log(`\nSong ${index + 1}:`);
50          console.log(`  Title: ${song.songName}`);
51          console.log(`  URL: ${song.songUrl}`);
52          console.log(`  Duration: ${song.duration}s`);
53        });
54        break;
55      } else {
56        console.log('Generation in progress...');
57        await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2s
58      }
59    }
60  } catch (error) {
61    console.error('Error:', error.response?.data || error.message);
62  }
63}
64
65generateInspirationMusic();