CharacterV2

High-level “character” descriptors. Use this model to describe the overall sonic “personality” of a track (e.g. for playlisting, similarity, and creative search).

versionVersionrequired

Constant value: CharacterV2

Default value: CharacterV2

segments objectrequired

Segment-level scores for character tags.

timestampsSecondsnumber[]required

Possible values: >= 0

values objectrequired

Map of character tag → array of scores (aligned with timestampsSeconds).

boldnumber[]required

Possible values: >= 0 and <= 1

coolnumber[]required

Possible values: >= 0 and <= 1

epicnumber[]required

Possible values: >= 0 and <= 1

etherealnumber[]required

Possible values: >= 0 and <= 1

heroicnumber[]required

Possible values: >= 0 and <= 1

luxuriousnumber[]required

Possible values: >= 0 and <= 1

magicalnumber[]required

Possible values: >= 0 and <= 1

mysteriousnumber[]required

Possible values: >= 0 and <= 1

playfulnumber[]required

Possible values: >= 0 and <= 1

powerfulnumber[]required

Possible values: >= 0 and <= 1

retronumber[]required

Possible values: >= 0 and <= 1

sophisticatednumber[]required

Possible values: >= 0 and <= 1

sparklingnumber[]required

Possible values: >= 0 and <= 1

sparsenumber[]required

Possible values: >= 0 and <= 1

unpolishednumber[]required

Possible values: >= 0 and <= 1

warmnumber[]required

Possible values: >= 0 and <= 1

scores objectrequired

Track-level scores (0.0-1.0) keyed by character tags.

boldBoldrequired

Possible values: >= 0 and <= 1

coolCoolrequired

Possible values: >= 0 and <= 1

epicEpicrequired

Possible values: >= 0 and <= 1

etherealEtherealrequired

Possible values: >= 0 and <= 1

heroicHeroicrequired

Possible values: >= 0 and <= 1

luxuriousLuxuriousrequired

Possible values: >= 0 and <= 1

magicalMagicalrequired

Possible values: >= 0 and <= 1

mysteriousMysteriousrequired

Possible values: >= 0 and <= 1

playfulPlayfulrequired

Possible values: >= 0 and <= 1

powerfulPowerfulrequired

Possible values: >= 0 and <= 1

retroRetrorequired

Possible values: >= 0 and <= 1

sophisticatedSophisticatedrequired

Possible values: >= 0 and <= 1

sparklingSparklingrequired

Possible values: >= 0 and <= 1

sparseSparserequired

Possible values: >= 0 and <= 1

unpolishedUnpolishedrequired

Possible values: >= 0 and <= 1

warmWarmrequired

Possible values: >= 0 and <= 1

tagsCharacterV2Tags[]required

Possible values: [bold, cool, epic, ethereal, heroic, luxurious, magical, mysterious, playful, powerful, retro, sophisticated, sparkling, sparse, unpolished, warm]

CharacterV2

{
  "version": "CharacterV2",
  "segments": {
    "timestampsSeconds": [
      0
    ],
    "values": {
      "bold": [
        0
      ],
      "cool": [
        0
      ],
      "epic": [
        0
      ],
      "ethereal": [
        0
      ],
      "heroic": [
        0
      ],
      "luxurious": [
        0
      ],
      "magical": [
        0
      ],
      "mysterious": [
        0
      ],
      "playful": [
        0
      ],
      "powerful": [
        0
      ],
      "retro": [
        0
      ],
      "sophisticated": [
        0
      ],
      "sparkling": [
        0
      ],
      "sparse": [
        0
      ],
      "unpolished": [
        0
      ],
      "warm": [
        0
      ]
    }
  },
  "scores": {
    "bold": 0,
    "cool": 0,
    "epic": 0,
    "ethereal": 0,
    "heroic": 0,
    "luxurious": 0,
    "magical": 0,
    "mysterious": 0,
    "playful": 0,
    "powerful": 0,
    "retro": 0,
    "sophisticated": 0,
    "sparkling": 0,
    "sparse": 0,
    "unpolished": 0,
    "warm": 0
  },
  "tags": [
    "bold"
  ]
}