Glossary

Overview

Here are the definitions of various terms used throughout the music section of the API.

Band

A preset collection of instruments designed to be representative of a specific kind of music. They are typically chosen via a Descriptor’s data.attributes.bands list. Every band is guaranteed to have one Tag in the Category of band_size, denoting the general number of instruments it contains.

Category

The parent of a Tag, denoting a specific class of information its child tags relate to.

Descriptor

A name which describes a general characteristic of some kind of music to be composed.

Genre

A genre is a style tag with a label of “general”.

Hit

Single note events available for manual placement in time.

Instrument

A musical instrument with any associated audio processing characteristic to its sonic identity. They are typically chosen via a band or via a Descriptor’s data.attributes.instruments list. Every instrument is guaranteed to have one Tag in the Category of instrument_category and one of instrument_type, useful for determining the general family the instrument belongs to.

Label

A property that many be associated with a Tag. These function as a way to group multiple related tags together but are more general than a Categories.

Mood

One of the tags which are always associated with each descriptor, and one of the primary high-level properties of music Amper defines. Describes the general feeling conveyed by the associated music.

Preview

A short audio example of what a particular Entity could sound like when used. These are useful for giving an impression of what a particular kind of music or instrument could be prior to requesting a full render.

Style

One of the tags which are always associated with each descriptor, and one of the primary high-level properties of music Amper defines. Describes the genre or sub-genre of the associated music.

Sub-Genre

A sub-genre is a style tag with a label of “specific”.

Tag

A small piece of information denoting some property of another piece of data. Most records have at least one tag associated with them. Every tag exists in exactly one Category but may have zero or more Labels providing additional context.