Run Mastering

This endpoint starts the audio mastering process for an uploaded file.

POST https://platform.cryo-mix.com/api/mastering

Request Headers

Header	Type	Required	Description
`X-Api-Key`	string	Yes	Your client API key.
`Session-Id`	string	Yes	The unique session identifier you used to upload the file.
`Source`	string	Yes	Must be set to `Mastering API`.

Request Body

Parameter	Type	Required	Description
`mwa`	number	No	Stereo Width Adjustment. Range: `-5` to `5`. Default: `0`.
`meq`	number	No	EQ Correction. Range: `0` to `10`. Default: `5`.
`mha`	number	No	Highs Adjustment. Range: `-5` to `5`. Default: `0`.
`mma`	number	No	Mids Adjustment. Range: `-5` to `5`. Default: `0`.
`mla`	number	No	Lows Adjustment. Range: `-5` to `5`. Default: `0`.
`mca`	number	No	Loudness Adjustment. Range: `-5` to `5`. Default: `0`.

Example Request

{
  "mwa": 0,
  "meq": 5,
  "mha": 0,
  "mma": 0,
  "mla": 0,
  "mca": 0
}

Response

Success Response (200 OK)

{
  "data": null,
  "message": "Mastering started, please use percentage api to check the progress",
  "status": "success",
  "code": 200
}

Error Responses

400 Bad Request

{
  "message": "Missing required parameters.",
  "status": "error",
  "code": 400
}

Possible Causes:

• A required header (X-Api-Key, Session-Id, or Source) is missing or invalid.

• The Session-Id was not found.

• The mastering process is not in a state that can be started.

401 Unauthorized

{
  "message": "unauthorized client",
  "status": "error",
  "code": 401
}

Possible Causes:

• The API key is incorrect.

• The Source header is incorrect.

• The request is coming from a domain that is not on your list of allowed domains.

Usage Examples

JavaScript (Fetch)

const response = await fetch('https://platform.cryo-mix.com/api/mastering', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'your-api-key-here',
    'Session-Id': 'unique-session-id',
    'Source': 'Mastering API'
  },
  body: JSON.stringify({
    mwa: 0,
    meq: 5,
    mha: 0,
    mma: 0,
    mla: 0,
    mca: 0
  })
});

const result = await response.json();
console.log(result.message);

cURL

curl -X POST https://platform.cryo-mix.com/api/mastering \
  -H "X-Api-Key: your-api-key-here" \
  -H "Session-Id: unique-session-id" \
  -H "Source: Mastering API" \
  -H "Origin: your-domain.com" \
  -d '{
    "mwa": 0,
    "meq": 5,
    "mha": 0,
    "mma": 0,
    "mla": 0,
    "mca": 0
  }'

Note

• The Session-Id is the same identifier used when uploading the file.

• Use the Get Mastering Progress endpoint to check the mastering progress.

Overview

Endpoints