Skip to main content
POST
/
v2
/
MusicAI
Python
import requests

url = "https://api.musicgpt.com/api/public/v2/MusicAI"

headers = {
    "Authorization": "<API_KEY>",
    "Content-Type": "application/json"
}

payload = {
    "prompt": "Create a relaxing lo-fi song for studying",
    "music_style": "Lo-fi",
    "lyrics": "It's a brand new day",
    "make_instrumental": False,
    "vocal_only": False,
    "voice_id": "e1cb7380-e3db-433a-b186-a996d7545986",
    "title": "My Generated Track",
    "gender": "female",
    "generate_album_cover": False,
    "model": "v7-pro",
    "webhook_url": "https://example.com/my-webhook"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
curl --request POST \
--url https://api.musicgpt.com/api/public/v2/MusicAI \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "<string>",
"music_style": "<string>",
"lyrics": "<string>",
"make_instrumental": false,
"vocal_only": false,
"title": "<string>",
"gender": "<string>",
"voice_id": "<string>",
"generate_album_cover": false,
"webhook_url": "<string>"
}
'
const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
prompt: '<string>',
music_style: '<string>',
lyrics: '<string>',
make_instrumental: false,
vocal_only: false,
title: '<string>',
gender: '<string>',
voice_id: '<string>',
generate_album_cover: false,
webhook_url: '<string>'
})
};

fetch('https://api.musicgpt.com/api/public/v2/MusicAI', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.musicgpt.com/api/public/v2/MusicAI",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'prompt' => '<string>',
'music_style' => '<string>',
'lyrics' => '<string>',
'make_instrumental' => false,
'vocal_only' => false,
'title' => '<string>',
'gender' => '<string>',
'voice_id' => '<string>',
'generate_album_cover' => false,
'webhook_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"strings"
"net/http"
"io"
)

func main() {

url := "https://api.musicgpt.com/api/public/v2/MusicAI"

payload := strings.NewReader("{\n \"prompt\": \"<string>\",\n \"music_style\": \"<string>\",\n \"lyrics\": \"<string>\",\n \"make_instrumental\": false,\n \"vocal_only\": false,\n \"title\": \"<string>\",\n \"gender\": \"<string>\",\n \"voice_id\": \"<string>\",\n \"generate_album_cover\": false,\n \"webhook_url\": \"<string>\"\n}")

req, _ := http.NewRequest("POST", url, payload)

req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.musicgpt.com/api/public/v2/MusicAI")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prompt\": \"<string>\",\n \"music_style\": \"<string>\",\n \"lyrics\": \"<string>\",\n \"make_instrumental\": false,\n \"vocal_only\": false,\n \"title\": \"<string>\",\n \"gender\": \"<string>\",\n \"voice_id\": \"<string>\",\n \"generate_album_cover\": false,\n \"webhook_url\": \"<string>\"\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.musicgpt.com/api/public/v2/MusicAI")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"prompt\": \"<string>\",\n \"music_style\": \"<string>\",\n \"lyrics\": \"<string>\",\n \"make_instrumental\": false,\n \"vocal_only\": false,\n \"title\": \"<string>\",\n \"gender\": \"<string>\",\n \"voice_id\": \"<string>\",\n \"generate_album_cover\": false,\n \"webhook_url\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body
{
  "success": true,
  "message": "Message published to queue",
  "task_id": "4fc2cdba-005d-4d14-a208-5fb02a2809da",
  "conversion_id_1": "05092d5c-f8b1-4c96-a4a3-45bc00de6268",
  "conversion_id_2": "52fcd3b6-3925-41ed-b4c6-aee17a29e40b",
  "eta": 154
}
{
"success": false,
"error": "Insufficient credit balance"
}
{
"success": false,
"error": "Internal Server Error"
}

Authorizations

Authorization
string
header
required

Body

application/json
prompt
string

A natural language prompt for music generation. Keep it under 280 characters for guaranteed results, but detailed—the clearer and more descriptive it is, the better the outcome.

music_style
string

Style of music to generate (e.g., Rock, Pop)

lyrics
string

Custom lyrics for the generated music

make_instrumental
boolean
default:false

Whether to make the music instrumental

vocal_only
boolean
default:false

Whether to generate only vocals of output audio

title
string

Title of the generated music track

gender
string

Gender of the voice model

voice_id
string

Voice model to convert generated audio

generate_album_cover
boolean
default:false

Whether to generate an album cover for the generated audio

model
enum<string>

Model version to use for generation

Available options:
v6,
v6-pro,
v7,
v7-pro
webhook_url
string

URL for callback upon completion

Response

Successful response

success
boolean
message
string
task_id
string
conversion_id_1
string
conversion_id_2
string
eta
integer