ValenceArousalV2

Continuous emotional axes and derived categorical descriptors. Use this model for continuous emotional metrics (valence/arousal) and for derived, user-friendly categorical summaries such as energy and emotion-change labels.

versionVersionrequired

Constant value: ValenceArousalV2

Default value: ValenceArousalV2

segments objectrequired

Segment-level axis values.

timestampsSecondsnumber[]required

Possible values: >= 0

values objectrequired

Map of axis key → array of values (aligned with timestampsSeconds).

valencenumber[]required

Possible values: >= -1 and <= 1

arousalnumber[]required

Possible values: >= -1 and <= 1

scores objectrequired

Track-level axis values (constrained to -1.0-1.0).

valenceValencerequired

Possible values: >= -1 and <= 1

arousalArousalrequired

Possible values: >= -1 and <= 1

energyLevelValenceArousalV2EnergyLevelTagsrequired

Overall energy level category.

Possible values: [low, medium, high, varying]

energyChangesValenceArousalV2EnergyChangesTagsrequired

How much energy changes over time.

Possible values: [low, medium, high]

emotionProfileValenceArousalV2EmotionProfileTagsrequired

Overall emotional profile category.

Possible values: [negative, neutral, positive, varying]

emotionChangesValenceArousalV2EmotionChangesTagsrequired

How much emotion changes over time.

Possible values: [low, medium, high]

ValenceArousalV2

{
  "version": "ValenceArousalV2",
  "segments": {
    "timestampsSeconds": [
      0
    ],
    "values": {
      "valence": [
        0
      ],
      "arousal": [
        0
      ]
    }
  },
  "scores": {
    "valence": 0,
    "arousal": 0
  },
  "energyLevel": "low",
  "energyChanges": "low",
  "emotionProfile": "negative",
  "emotionChanges": "low"
}