Skip to main content

Changelog 2025-02-19

· 2 min read
Johannes Giani

Announcing Audio Analysis V7 and more similarity search filters.

Audio Analysis V6​

The moodMaxTimes field on AudioAnalysisV6Result is deprecated. You can use the segments field to get detailed information about mood for each segment instead.

Audio Analysis V7​

Our Audio Analysis V7 classifers are already available through the audioAnalysisV6 resolver. Now, we introduce Analysis V7 resolver and its associated types:

  • audioAnalysisV7 resolver on LibraryTrack and SpotifyTrack.
  • AudioAnalysisV7Finished, AudioAnalysisV7Failed, AudioAnalysisV7NotStarted, AudioAnalysisV7Enqueued, AudioAnalysisV7Processing types that indicate the analysis status.
  • AudioAnalysisV7Result type that contains all fields from AudioAnalysisV6Result except deprecated ones listed here.
  • AudioAnalysisV7Error type.
Webhooks

Webhooks continue to use the AudioAnalysisV6 event type for both AudioAnalysisV6 and AudioAnalysisV7.

Example query​

This example queries a library track's audioAnalysisV7 with the given id.

query LibraryTrackQuery($id: ID!) {
  libraryTrack(id: $id) {
    __typename
    ... on LibraryTrack {
      audioAnalysisV7 {
        __typename
        ... on AudioAnalysisV7Finished {
          result {
            genreTags
          }
        }
        ... on AudioAnalysisV7Failed {
          error {
            message
          }
        }
      }
    }
  }
}

Example Result (AudioAnalysisV7Finished)

{
  "data": {
    "libraryTrack": {
      "__typename": "LibraryTrack",
      "audioAnalysisV7": {
        "__typename": "AudioAnalysisV7Finished",
        "result": {
          "genreTags": ["electronicDance"]
        }
      }
    }
  }
}

Example Error (AudioAnalysisV7Error)

{
  "data": {
    "libraryTrack": {
      "__typename": "LibraryTrack",
      "audioAnalysisV7": {
        "__typename": "AudioAnalysisV7Failed",
        "error": {
          "message": "The audio file could not be analyzed."
        }
      }
    }
  }
}

Similarity Search Filters​

Cyanite 2.0

The new fields are exclusive to Cyanite 2.0 and require additional permissions. Please contact sales@cyanite.ai for more information.

We've extended the Similar Tracks Filter with more filtering options. The following tag filters are now available:

  • character
  • freeGenre
  • instrument
  • moodAdvanced
  • mood
  • subgenre

Augmented Keyword and Brand Value Weights​

Cyanite 2.0

This change is exclusive to Cyanite 2.0 and requires additional permissions. Please contact sales@cyanite.ai for more information.

The weight for an Augmented Keyword and a Brand Value is now normalized to a fixed range between -1 and 1. This change improves absolute comparability by standardizing values across tracks to a fixed scale, eliminating inconsistencies from unbounded ranges.