soundtrack

Getting the multi-regional soundtrack

Generates and bounces a soundtrack

POST /soundtrack

Request Body

Name	Type	Description
regions*	JSON	An Array of regions.
normalize	String	Enables soundtrack loudness normalization. Accept values: none, auto and high.

200: OK File successfully generated

// Sample response

{
    "apiVersion":"1.2.0",
    "mp3": "https://api.muzaic.ai/result/2024-01-31/st_3b12463ea3ecc474e22ebc302e70a0b3.mp3",
    "regions":[{"number":0,"hash":"6cc0b6861d5d369ec475d7236e9bfb63"},{"number":1,"hash":"9191593eb3992ba7c4307455c0e1b5ca"}],
    "status": "region 0 normalize: none | region 1 no params object | soundtrack normalized: auto",
    "tokensUsed": 65,
    "executionTime": 5.111389875412
}

400: Bad Request Bad request

//example response

{
    "Error": "No regions list"
}

Region object definition

Field	Type	Description	Required
time	float	A position (start) of given region in seconds.
duration	float	Requested composition time in seconds. If no parameter value is passed, the default time value is 60 seconds. Currently, there is a limit set at 1200 seconds.
tags	Array (int)	An array of integers representing tag id's.
params	JSON	An object containing user music params values: intensity, tempo, rhythm, tone , variance. These values are either integers ranging from 1 to 9 (mean parameter value) or keyframes arrays (except tempo).
sourceHash	String	A unique system music identifier obtained in a response. Please provide the sourceHash when you want to refer to a previously composed music region in your next call.
action	String	One of the possible actions for region generation process: 'generate', 'copy', 'regenerate' or 'extend'.
method	String	One of the methods to interpret time and duration fields is: 'strict', 'auto_adjust', 'adjust_start', or 'adjust_end'.