This endpoint creates rendered audio from timeline data. It returns a render ID that you can use to download the finished audio when it is ready. The render ID is valid for up to 48 hours.
643 matches
100 actions
Shutterstock API Explorer
100 actions
- Add audio tracks to collectionsPOSTv1.0.0
- Add images to collectionsPOSTv1.0.0
- Add items to catalog collectionsPOSTv1.0.0
- Add videos to collectionsPOSTv1.0.0
- Authorize applicationsGETv1.0.0
- Create audio collectionsPOSTv1.0.0
- Create catalog collectionsPOSTv1.0.0
- Create image collectionsPOSTv1.0.0
- Create rendered audioPOSTv1.0.0
- Create video collectionsPOSTv1.0.0
- Delete audio collectionsDELETEv1.0.0
- Delete catalog collectionsDELETEv1.0.0
- Delete image collectionsDELETEv1.0.0
- Delete video collectionsDELETEv1.0.0
- Echo textGETv1.0.0
- Get details about a single contributorGETv1.0.0
- Get details about audio rendersGETv1.0.0
- Get details about audio tracksGETv1.0.0
- Get details about contributors' collectionsGETv1.0.0
- Get details about imagesGETv1.0.0
- Get details about multiple contributorsGETv1.0.0
- Get details about sound effectsGETv1.0.0
- Get details about videosGETv1.0.0
- Get editorial content detailsGETv1.0.0
- Get editorial livefeedGETv1.0.0
- Get editorial livefeed itemsGETv1.0.0
- Get editorial livefeed listGETv1.0.0
- Get editorial video content detailsGETv1.0.0
- Get keywords from textPOSTv1.0.0
- Get suggestions for a search termGETv1.0.0
- Get suggestions for a search termGETv1.0.0
- Get the contents of audio collectionsGETv1.0.0
- Get the contents of featured image collectionsGETv1.0.0
- Get the contents of featured video collectionsGETv1.0.0
- Get the contents of image collectionsGETv1.0.0
- Get the contents of video collectionsGETv1.0.0
- Get the details of audio collectionsGETv1.0.0
- Get the details of featured image collectionsGETv1.0.0
- Get the details of featured video collectionsGETv1.0.0
- Get the details of image collectionsGETv1.0.0
- Get the details of video collectionsGETv1.0.0
- Get the items in contributors' collectionsGETv1.0.0
- Get user detailsGETv1.0.0
- License audio tracksPOSTv1.0.0
- License editorial contentPOSTv1.0.0
- License editorial video contentPOSTv1.0.0
- License imagesPOSTv1.0.0
- License sound effectsPOSTv1.0.0
- License videosPOSTv1.0.0
- List audio collectionsGETv1.0.0
- List audio genresGETv1.0.0
- List audio instrumentsGETv1.0.0
- List audio licensesGETv1.0.0
- List audio moodsGETv1.0.0
- List audio tracksGETv1.0.0
- List catalog collectionsGETv1.0.0
- List computer audio descriptorsGETv1.0.0
- List computer audio instrumentsGETv1.0.0
- List contributors' collectionsGETv1.0.0
- List details about sound effectsGETv1.0.0
- List editorial categoriesGETv1.0.0
- List editorial image licensesGETv1.0.0
- List editorial video categoriesGETv1.0.0
- List editorial video licensesGETv1.0.0
- List featured image collectionsGETv1.0.0
- List featured video collectionsGETv1.0.0
- List image categoriesGETv1.0.0
- List image collectionsGETv1.0.0
- List image licensesGETv1.0.0
- List imagesGETv1.0.0
- List recommended imagesGETv1.0.0
- List similar imagesGETv1.0.0
- List similar imagesGETv1.0.0
- List similar videosGETv1.0.0
- List similar videosGETv1.0.0
- List sound effects licensesGETv1.0.0
- List suggested keywordsGETv1.0.0
- List updated contentGETv1.0.0
- List updated imagesGETv1.0.0
- List updated videosGETv1.0.0
- List user subscriptionsGETv1.0.0
- List video categoriesGETv1.0.0
- List video collectionsGETv1.0.0
- List video licensesGETv1.0.0
- List videosGETv1.0.0
- Remove audio tracks from collectionsDELETEv1.0.0
- Remove images from collectionsDELETEv1.0.0
- Remove items from catalog collectionDELETEv1.0.0
- Remove videos from collectionsDELETEv1.0.0
- Rename audio collectionsPOSTv1.0.0
- Rename image collectionsPOSTv1.0.0
- Search catalogs for assetsGETv1.0.0
- Search editorial imagesGETv1.0.0
- Search editorial video contentGETv1.0.0
- Search for imagesGETv1.0.0
- Search for sound effectsGETv1.0.0
- Search for tracksGETv1.0.0
- Search for videosGETv1.0.0
- Update collection metadataPATCHv1.0.0
- Validate inputGETv1.0.0
Other/Shutterstock API Explorer
Create rendered audio
v1.0.0Input
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
- 73
- 74
- 75
- 76
- 77
- 78
- 79
- 80
- 81
- 82
- 83
- 84
- 85
- 86
- 87
- 88
- 89
- 90
- 91
- 92
- 93
- 94
- 95
- 96
- 97
- 98
- 99
- 100
- 101
- 102
- 103
- 104
- 105
- 106
- 107
- 108
- 109
- 110
- 111
- 112
- 113
- 114
- 115
- 116
- 117
- 118
- 119
- 120
- 121
- 122
- 123
- 124
- 125
- 126
- 127
- 128
- 129
- 130
- 131
- 132
- 133
- 134
- 135
- 136
- 137
- 138
- 139
- 140
- 141
- 142
- 143
- 144
- 145
- 146
- 147
- 148
- 149
- 150
- 151
- 152
- 153
- 154
- 155
- 156
- 157
- 158
- 159
- 160
{
"type": "object",
"description": "Render request data",
"required": [
"audio_renders"
],
"properties": {
"audio_renders": {
"type": "array",
"description": "Parameters to create computer audio renders",
"items": {
"type": "object",
"description": "Data required to create an audio render",
"required": [
"preset",
"timeline",
"filename"
],
"properties": {
"filename": {
"type": "string",
"description": "A user-specified file name suggestion; this file name becomes the filename property of the Content-Disposition header when the user downloads the rendered audio file"
},
"preset": {
"type": "string",
"description": "File format, such as MP3 file, combined WAV file, or individual track WAV files",
"enum": [
"MASTER_MP3",
"MASTER_WAV",
"STEMS_WAV"
]
},
"timeline": {
"type": "object",
"description": "A timeline object that represents either a request for music to be created or an entire music composition",
"properties": {
"spans": {
"type": "array",
"description": "A span object that represents the beginning of a period of absolute time",
"items": {
"type": "object",
"description": "The beginning of a non-overlapping period of absolute time",
"required": [
"span_type",
"time"
],
"properties": {
"id": {
"type": "number",
"description": "An identifier which must be unique within the parent span"
},
"instrument_groups": {
"type": "array",
"description": "An array of instrument_group objects that are used in this span",
"items": {
"type": "object",
"description": "An instrument and the status objects that specify when that instrument plays",
"required": [
"instrument_group"
],
"properties": {
"instrument_group": {
"type": "object",
"additionalProperties": true
},
"statuses": {
"type": "object",
"additionalProperties": true
}
}
}
},
"regions": {
"type": "array",
"description": "An array of region objects within the span",
"items": {
"type": "object",
"description": "A period of music or silence, measured in beats",
"required": [
"id",
"region",
"descriptor",
"beat"
],
"properties": {
"beat": {
"type": "object",
"additionalProperties": true
},
"descriptor": {
"type": "object",
"additionalProperties": true
},
"end_type": {
"type": "object",
"additionalProperties": true
},
"id": {
"type": "object",
"additionalProperties": true
},
"key": {
"type": "object",
"additionalProperties": true
},
"region": {
"type": "object",
"additionalProperties": true
}
}
}
},
"span_type": {
"type": "string",
"description": "Type of span; metered spans represent a pariod of time with music, and unmetered spans denote the end of the prior metered span",
"enum": [
"metered",
"unmetered"
]
},
"tempo": {
"type": "integer",
"description": "The tempo, in beats per minute, at the start of the span; if not provided, the API selects a random tempo"
},
"tempo_changes": {
"type": "array",
"description": "Two or more inflection points in a tempo curve; the API creates a smoothly changing tempo by using a linear interpolation of the time between each tempo change",
"items": {
"type": "object",
"description": "An inflection point in a tempo curve; the API creates the overall tempo by using a linear interpolation of the time between each tempo change",
"required": [
"time",
"tempo"
],
"properties": {
"tempo": {
"type": "object",
"additionalProperties": true
},
"time": {
"type": "object",
"additionalProperties": true
}
}
}
},
"time": {
"type": "integer",
"description": "The absolute time, in seconds, at which the span starts"
}
}
}
}
}
}
}
}
}
}
}Output
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
- 73
- 74
- 75
- 76
- 77
- 78
- 79
- 80
- 81
- 82
- 83
- 84
- 85
- 86
- 87
- 88
- 89
- 90
- 91
- 92
- 93
- 94
- 95
- 96
- 97
- 98
- 99
- 100
- 101
- 102
- 103
- 104
- 105
- 106
- 107
- 108
- 109
- 110
- 111
- 112
- 113
- 114
- 115
- 116
- 117
- 118
- 119
- 120
- 121
- 122
- 123
- 124
- 125
- 126
- 127
- 128
- 129
- 130
- 131
- 132
- 133
- 134
- 135
- 136
- 137
- 138
- 139
- 140
- 141
- 142
- 143
- 144
- 145
- 146
- 147
- 148
- 149
- 150
- 151
- 152
- 153
- 154
- 155
- 156
- 157
- 158
- 159
- 160
- 161
- 162
- 163
- 164
- 165
- 166
- 167
- 168
- 169
- 170
- 171
- 172
- 173
- 174
- 175
- 176
- 177
- 178
- 179
- 180
- 181
- 182
- 183
- 184
- 185
- 186
- 187
- 188
- 189
- 190
- 191
- 192
- 193
- 194
- 195
- 196
- 197
- 198
- 199
- 200
- 201
- 202
- 203
- 204
- 205
- 206
- 207
- 208
- 209
- 210
- 211
- 212
- 213
- 214
- 215
- 216
- 217
- 218
- 219
- 220
- 221
- 222
- 223
- 224
- 225
- 226
- 227
- 228
- 229
- 230
- 231
- 232
- 233
- 234
- 235
- 236
- 237
- 238
- 239
- 240
{
"description": "Audio render data",
"required": [
"audio_renders"
],
"properties": {
"audio_renders": {
"type": "array",
"description": "Audio render results",
"items": {
"type": "object",
"description": "The output of an audio render in WAV or MP3 format",
"required": [
"id",
"timeline",
"status"
],
"properties": {
"created_date": {
"type": "string",
"format": "date-time",
"description": "The time the render was submitted to the API"
},
"files": {
"type": "array",
"description": "The files associated with the render",
"items": {
"type": "object",
"description": "Files associated with the render",
"required": [
"filename",
"bits_sample",
"content_type",
"download_url",
"frequency_hz",
"kbits_second",
"size_bytes",
"tracks"
],
"properties": {
"bits_sample": {
"type": "number",
"description": "The bit depth of the audio files in bits/sample"
},
"content_type": {
"type": "string",
"description": "The content-type of the file"
},
"download_url": {
"type": "string",
"description": "The internet-accessible URL from which the file can be downloaded. Any redirects encountered when using this URL must be followed"
},
"filename": {
"type": "string",
"description": "The user-specified file name suggestion from the render request; this file name becomes the filename property of the Content-Disposition header when the user downloads the rendered audio file"
},
"frequency_hz": {
"type": "number",
"description": "The Sample rate of the audio files in Hertz (Hz)"
},
"kbits_second": {
"type": "number",
"description": "The data rate of the audio files in kilobits/second"
},
"size_bytes": {
"type": "number",
"description": "Size of the file in bytes"
},
"tracks": {
"type": "array",
"description": "An array of track names included in the file",
"items": {
"type": "string"
}
}
}
}
},
"id": {
"type": "string",
"description": "The alphanumeric ID of the simple render"
},
"preset": {
"type": "string",
"description": "The file format preset",
"enum": [
"MASTER_MP3",
"MASTER_WAV",
"STEMS_WAV"
]
},
"progress_percent": {
"type": "integer",
"description": "The current progress of the render as a percentage"
},
"status": {
"type": "string",
"description": "A coarse progress indicator",
"enum": [
"WAITING_COMPOSE",
"RUNNING_COMPOSE",
"WAITING_RENDER",
"RUNNING_RENDER",
"CREATED",
"FAILED_CREATE"
]
},
"timeline": {
"type": "object",
"description": "A timeline object that represents either a request for music to be created or an entire music composition",
"properties": {
"spans": {
"type": "array",
"description": "A span object that represents the beginning of a period of absolute time",
"items": {
"type": "object",
"description": "The beginning of a non-overlapping period of absolute time",
"required": [
"span_type",
"time"
],
"properties": {
"id": {
"type": "number",
"description": "An identifier which must be unique within the parent span"
},
"instrument_groups": {
"type": "array",
"description": "An array of instrument_group objects that are used in this span",
"items": {
"type": "object",
"description": "An instrument and the status objects that specify when that instrument plays",
"required": [
"instrument_group"
],
"properties": {
"instrument_group": {
"type": "object",
"additionalProperties": true
},
"statuses": {
"type": "object",
"additionalProperties": true
}
}
}
},
"regions": {
"type": "array",
"description": "An array of region objects within the span",
"items": {
"type": "object",
"description": "A period of music or silence, measured in beats",
"required": [
"id",
"region",
"descriptor",
"beat"
],
"properties": {
"beat": {
"type": "object",
"additionalProperties": true
},
"descriptor": {
"type": "object",
"additionalProperties": true
},
"end_type": {
"type": "object",
"additionalProperties": true
},
"id": {
"type": "object",
"additionalProperties": true
},
"key": {
"type": "object",
"additionalProperties": true
},
"region": {
"type": "object",
"additionalProperties": true
}
}
}
},
"span_type": {
"type": "string",
"description": "Type of span; metered spans represent a pariod of time with music, and unmetered spans denote the end of the prior metered span",
"enum": [
"metered",
"unmetered"
]
},
"tempo": {
"type": "integer",
"description": "The tempo, in beats per minute, at the start of the span; if not provided, the API selects a random tempo"
},
"tempo_changes": {
"type": "array",
"description": "Two or more inflection points in a tempo curve; the API creates a smoothly changing tempo by using a linear interpolation of the time between each tempo change",
"items": {
"type": "object",
"description": "An inflection point in a tempo curve; the API creates the overall tempo by using a linear interpolation of the time between each tempo change",
"required": [
"time",
"tempo"
],
"properties": {
"tempo": {
"type": "object",
"additionalProperties": true
},
"time": {
"type": "object",
"additionalProperties": true
}
}
}
},
"time": {
"type": "integer",
"description": "The absolute time, in seconds, at which the span starts"
}
}
}
}
}
},
"updated_date": {
"type": "string",
"format": "date-time",
"description": "The time that the audio output was uploaded"
}
}
}
}
}
}