Audio Mastering

Python

import requests

url = "https://api.musicgpt.com/api/public/v1/audio_mastering"

headers = {
    "Authorization": "<API_KEY>"
}

data = {
    "output_extension": "wav",
    "webhook_url": "https://example.com/my-webhook"
}

# Option 1: audio URLs
data["audio_url"] = "<YOUR_AUDIO_URL>"
data["reference_audio_url"] = "<YOUR_REFERENCE_AUDIO_URL>"
response = requests.post(url, headers=headers, data=data)

# Option 2: File Upload
# with open("song.mp3", "rb") as audio, open("reference.mp3", "rb") as reference:
#     files = {
#         "audio_file": audio,
#         "reference_audio_file": reference
#     }
#     response = requests.post(url, headers=headers, data=data, files=files)

print(response.json())

curl --request POST \
  --url https://api.musicgpt.com/api/public/v1/audio_mastering \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form audio_url=https://example.com/input_audio.mp3 \
  --form reference_audio_url=https://example.com/reference_track.wav \
  --form 'audio_file=<string>' \
  --form 'reference_audio_file=<string>' \
  --form output_extension=wav \
  --form webhook_url=http://your-webhook-url.com/callback \
  --form 0.audio_file='@example-file' \
  --form 0.reference_audio_file='@example-file' \
  --form 1.audio_file='@example-file' \
  --form 1.reference_audio_file='@example-file'

const form = new FormData();
form.append('audio_url', 'https://example.com/input_audio.mp3');
form.append('reference_audio_url', 'https://example.com/reference_track.wav');
form.append('audio_file', '<string>');
form.append('reference_audio_file', '<string>');
form.append('output_extension', 'wav');
form.append('webhook_url', 'http://your-webhook-url.com/callback');
form.append('0.audio_file', '{
  "fileName": "example-file"
}');
form.append('0.reference_audio_file', '{
  "fileName": "example-file"
}');
form.append('1.audio_file', '{
  "fileName": "example-file"
}');
form.append('1.reference_audio_file', '{
  "fileName": "example-file"
}');

const options = {method: 'POST', headers: {Authorization: '<api-key>'}};

options.body = form;

fetch('https://api.musicgpt.com/api/public/v1/audio_mastering', 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/v1/audio_mastering",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_url\"\r\n\r\nhttps://example.com/input_audio.mp3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_url\"\r\n\r\nhttps://example.com/reference_track.wav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"output_extension\"\r\n\r\nwav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\nhttp://your-webhook-url.com/callback\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: multipart/form-data; boundary=---011000010111000001101001"
  ],
]);

$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/v1/audio_mastering"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_url\"\r\n\r\nhttps://example.com/input_audio.mp3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_url\"\r\n\r\nhttps://example.com/reference_track.wav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"output_extension\"\r\n\r\nwav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\nhttp://your-webhook-url.com/callback\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")

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

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "multipart/form-data; boundary=---011000010111000001101001")

	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/v1/audio_mastering")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "multipart/form-data; boundary=---011000010111000001101001")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_url\"\r\n\r\nhttps://example.com/input_audio.mp3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_url\"\r\n\r\nhttps://example.com/reference_track.wav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"output_extension\"\r\n\r\nwav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\nhttp://your-webhook-url.com/callback\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.musicgpt.com/api/public/v1/audio_mastering")

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"] = 'multipart/form-data; boundary=---011000010111000001101001'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_url\"\r\n\r\nhttps://example.com/input_audio.mp3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_url\"\r\n\r\nhttps://example.com/reference_track.wav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"output_extension\"\r\n\r\nwav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\nhttp://your-webhook-url.com/callback\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "task_id": "master123",
  "conversion_id": "conv456",
  "credit_estimate": 150.75,
  "eta": 300,
  "message": "Mastering task queued successfully"
}

{
  "success": false,
  "error": "Invalid output format specified"
}

{
  "success": false,
  "error": "Authentication failed"
}

{
  "success": false,
  "error": "Insufficient credits for this operation",
  "required_credits": 150.75,
  "available_credits": 100
}

{
  "success": false,
  "error": "User subscription plan not found"
}

{
  "success": false,
  "error": "Internal server error during mastering"
}

POST

audio_mastering

Python

import requests

url = "https://api.musicgpt.com/api/public/v1/audio_mastering"

headers = {
    "Authorization": "<API_KEY>"
}

data = {
    "output_extension": "wav",
    "webhook_url": "https://example.com/my-webhook"
}

# Option 1: audio URLs
data["audio_url"] = "<YOUR_AUDIO_URL>"
data["reference_audio_url"] = "<YOUR_REFERENCE_AUDIO_URL>"
response = requests.post(url, headers=headers, data=data)

# Option 2: File Upload
# with open("song.mp3", "rb") as audio, open("reference.mp3", "rb") as reference:
#     files = {
#         "audio_file": audio,
#         "reference_audio_file": reference
#     }
#     response = requests.post(url, headers=headers, data=data, files=files)

print(response.json())

curl --request POST \
  --url https://api.musicgpt.com/api/public/v1/audio_mastering \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form audio_url=https://example.com/input_audio.mp3 \
  --form reference_audio_url=https://example.com/reference_track.wav \
  --form 'audio_file=<string>' \
  --form 'reference_audio_file=<string>' \
  --form output_extension=wav \
  --form webhook_url=http://your-webhook-url.com/callback \
  --form 0.audio_file='@example-file' \
  --form 0.reference_audio_file='@example-file' \
  --form 1.audio_file='@example-file' \
  --form 1.reference_audio_file='@example-file'

const form = new FormData();
form.append('audio_url', 'https://example.com/input_audio.mp3');
form.append('reference_audio_url', 'https://example.com/reference_track.wav');
form.append('audio_file', '<string>');
form.append('reference_audio_file', '<string>');
form.append('output_extension', 'wav');
form.append('webhook_url', 'http://your-webhook-url.com/callback');
form.append('0.audio_file', '{
  "fileName": "example-file"
}');
form.append('0.reference_audio_file', '{
  "fileName": "example-file"
}');
form.append('1.audio_file', '{
  "fileName": "example-file"
}');
form.append('1.reference_audio_file', '{
  "fileName": "example-file"
}');

const options = {method: 'POST', headers: {Authorization: '<api-key>'}};

options.body = form;

fetch('https://api.musicgpt.com/api/public/v1/audio_mastering', 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/v1/audio_mastering",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_url\"\r\n\r\nhttps://example.com/input_audio.mp3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_url\"\r\n\r\nhttps://example.com/reference_track.wav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"output_extension\"\r\n\r\nwav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\nhttp://your-webhook-url.com/callback\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: multipart/form-data; boundary=---011000010111000001101001"
  ],
]);

$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/v1/audio_mastering"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_url\"\r\n\r\nhttps://example.com/input_audio.mp3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_url\"\r\n\r\nhttps://example.com/reference_track.wav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"output_extension\"\r\n\r\nwav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\nhttp://your-webhook-url.com/callback\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")

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

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "multipart/form-data; boundary=---011000010111000001101001")

	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/v1/audio_mastering")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "multipart/form-data; boundary=---011000010111000001101001")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_url\"\r\n\r\nhttps://example.com/input_audio.mp3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_url\"\r\n\r\nhttps://example.com/reference_track.wav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"output_extension\"\r\n\r\nwav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\nhttp://your-webhook-url.com/callback\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.musicgpt.com/api/public/v1/audio_mastering")

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"] = 'multipart/form-data; boundary=---011000010111000001101001'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_url\"\r\n\r\nhttps://example.com/input_audio.mp3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_url\"\r\n\r\nhttps://example.com/reference_track.wav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference_audio_file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"output_extension\"\r\n\r\nwav\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\nhttp://your-webhook-url.com/callback\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"0.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"1.reference_audio_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "task_id": "master123",
  "conversion_id": "conv456",
  "credit_estimate": 150.75,
  "eta": 300,
  "message": "Mastering task queued successfully"
}

{
  "success": false,
  "error": "Invalid output format specified"
}

{
  "success": false,
  "error": "Authentication failed"
}

{
  "success": false,
  "error": "Insufficient credits for this operation",
  "required_credits": 150.75,
  "available_credits": 100
}

{
  "success": false,
  "error": "User subscription plan not found"
}

{
  "success": false,
  "error": "Internal server error during mastering"
}

Master your audio files professionally using a reference track. Audio Mastering uses intelligent processing to match the sonic quality of your track to a reference file — perfect for music production, podcasts, and post-production work.

Match tone, loudness, and clarity
Quick, accurate mastering with webhook support

Endpoint

POST /v1/audio_mastering

Use this endpoint to master an audio file based on a reference track.

Sample Output

Listen to the mastered audio:

Try it Yourself

Visit the Audio Mastering Endpoint Explorer to upload an audio and reference track for instant mastering.

Tip: Use a professionally mastered song as your reference for best results!

Request Parameters

Parameter	Type	Required	Description
`audio_path`	String	Yes	URL path of the input audio file to be mastered
`conversion_id`	String	Yes	Unique identifier for this conversion request
`reference_audio_path`	String	Yes	URL path of the reference audio file to match
`output_extension`	String	Optional	Desired output format (`mp3`, `wav`, `flac`, `ogg`, `aac`, `webm`)
`audio_duration`	Float	Yes	Duration of input audio in seconds (for credit calculation)
`webhook_url`	String	Optional	URL to receive callback notification when processing completes
`user_id`	String	Optional	User ID for tracking (from authentication token)

content-type: multipart/form-data

Sample Request

Python

import requests

url = "https://api.musicgpt.com/api/public/v1/audio_mastering"
headers = {"Authorization": "<<<api key>>>"}

# Option 1: Using URLs
payload = {
    "audio_url": "https://example.com/input_audio.mp3",
    "reference_audio_url": "https://example.com/reference_track.wav",
    "output_extension": "wav",
    "webhook_url": "http://your-webhook-url.com/callback"
}
response = requests.post(url, headers=headers, data=payload)
print(response.json())

# Option 2: Upload files
# with open("input.mp3", "rb") as input_file, open("ref.wav", "rb") as ref_file:
#     files = {
#         "audio_file": input_file,
#         "reference_audio_file": ref_file
#     }
#     data = {
#         "output_extension": "wav",
#         "webhook_url": "http://your-webhook-url.com/callback"
#     }
#     response = requests.post(url, headers=headers, files=files, data=data)
#     print(response.json())

Sample Response

Success (200 OK)

{
  "success": true,
  "task_id": "0d12ef34-5678-4abc-9123-456def7890ab",
  "conversion_id": "user_master_12345",
  "credit_estimate": 0.02,
  "eta": 120,
  "message": "Mastering request accepted"
}

Webhook Response

If a webhook_url is provided, you will receive the following once processing completes:

{
  "success": true,
  "task_id": "0d12ef34-5678-4abc-9123-456def7890ab",
  "conversion_id": "user_master_12345",
  "conversion_path": "https://musicgpt.s3.us-east-1.amazonaws.com/conversions/sample-mastered.mp3",
  "credit_cost": 0.02
}

📂 If no webhook is provided, you can fetch the final mastered audio manually later using the conversion_id.

Payload and Request Formation

Authorizations

Authorization

string

header

required

Body

multipart/form-data

Option 1
Option 2

audio_url

string

required

Input audio URL (supported format: YouTube URL).

Example:

"https://example.com/input_audio.mp3"

reference_audio_url

string

required

URL of the reference audio file to match.

Example:

"https://example.com/reference_track.wav"

audio_file

file

Input audio file to upload directly.

reference_audio_file

file

Reference audio file to upload directly.

output_extension

enum<string>

Desired output file format.

Available options:

mp3,

wav,

flac,

ogg,

aac,

webm

Example:

"wav"

webhook_url

string

Callback URL to receive async result.

Example:

"http://your-webhook-url.com/callback"

Response

Successfully queued for mastering

success

boolean

task_id

string

conversion_id

string

credit_estimate

number<float>

eta

integer

message

string

API Documentation

Utilities

Resources

Keep in mind

Features

Sample Request Endpoints

Helper Endpoints

Conversion Endpoints

Endpoint

Sample Output

Try it Yourself

Request Parameters

Sample Request

Python

Sample Response

Success (200 OK)

Webhook Response

Payload and Request Formation

Authorizations

Body

Response

​Endpoint

​Sample Output

​Try it Yourself

​Request Parameters

​Sample Request

​Python

​Sample Response

​Success (200 OK)

​Webhook Response

​Payload and Request Formation

Authorizations

Body

Response

Endpoint

Sample Output

Try it Yourself

Request Parameters

Sample Request

Python

Sample Response

Success (200 OK)

Webhook Response

Payload and Request Formation