Music Identification - AudioShake Developers

Documentation Index

Fetch the complete documentation index at: /llms.txt

Use this file to discover all available pages before exploring further.

The music_identification model analyzes audio or video content to determine when music is present and whether that music can be identified. It is designed for short-form content, automated highlights, and cue sheet workflows, with a focus on copyright compliance and music clearance.

What the model provides

Create a Task

music_identification.py

import requests

API_KEY = "your_api_key"
HEADERS = {"Content-Type": "application/json", "x-api-key": API_KEY}

response = requests.post(
    "https://api.audioshake.ai/tasks",
    headers=HEADERS,
    json={
        "assetId": "your_asset_id",
        "targets": [
            {"model": "music_identification", "formats": ["json"]}
        ]
    }
)

task_id = response.json()["id"]
print(f"Task created: {task_id}")

musicIdentification.js

const API_KEY = "your_api_key";
const headers = { "Content-Type": "application/json", "x-api-key": API_KEY };

const createRes = await fetch("https://api.audioshake.ai/tasks", {
  method: "POST",
  headers,
  body: JSON.stringify({
    assetId: "your_asset_id",
    targets: [
      { model: "music_identification", formats: ["json"] }
    ]
  })
});

const { id: taskId } = await createRes.json();
console.log(`Task created: ${taskId}`);

curl

curl -X POST "https://api.audioshake.ai/tasks" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $AUDIOSHAKE_API_KEY" \
  -d '{
    "assetId": "your_asset_id",
    "targets": [
      { "model": "music_identification", "formats": ["json"] }
    ]
  }'

Check Task status to monitor progress and download results, or use webhooks to be notified when each target completes.

Example response

{
  "events": [
    {
      "start_time_s": 0.0,
      "end_time_s": 10.0,
      "music_detected": true,
      "music_identified": false,
      "detection_confidence": 0.70
    },
    {
      "start_time_s": 12.0,
      "end_time_s": 18.0,
      "music_detected": true,
      "music_identified": true,
      "detection_confidence": 0.99,
      "identification_confidence": 0.76,
      "title": "Schön Rosmarin",
      "artists": [
        "Gil Shaham",
        "Orpheus Chamber Orchestra"
      ],
      "album": "Violin Romances",
      "label": "Deutsche Grammophon",
      "release_date": "1996-09-02",
      "isrc": "DEF059503430"
    }
  ]
}

Event fields

Field Description
start_time_s Start time of the event (seconds)
end_time_s End time of the event (seconds)
music_detected Whether music is present
music_identified Whether the music was identified
detection_confidence Confidence score for music detection
identification_confidence Confidence score for identification (when available)
title Track title (if identified)
artists Performing artist(s)
album Album name
label Record label
release_date Release date
isrc ISRC code

Identification fields are only included when music is successfully identified.

Use cases