Integrate ACRCloud audio fingerprinting for music recognition via the identification API

Steps

1. Create an ACRCloud account and set up a recognition project — ACRCloud provides an access key and access secret per project, which are used to sign API requests
2. Construct an HMAC-SHA1 signature for each request: concatenate the HTTP method, endpoint path, access key, data type, signature version, and a Unix timestamp string with newlines between each value, then compute HMAC-SHA1 using your access secret as the key and base64-encode the result
3. Submit a recognition request by POSTing to the regional identification endpoint (e.g., 'https://identify-eu-west-1.acrcloud.com/v1/identify') with multipart/form-data fields: 'sample' (the audio segment), 'sample_bytes' (byte length of the sample), 'access_key', 'data_type' ('audio' or 'fingerprint'), 'signature_version' ('1'), 'signature', and 'timestamp'
4. Send audio clips of 10–15 seconds for best recognition accuracy — keep the sample file under 5 MB; ACRCloud recommends using their SDK to generate a compact fingerprint and set 'data_type' to 'fingerprint' to reduce bandwidth compared to sending raw audio
5. Parse the JSON response: a successful match returns 'status.code' of 0 with a 'metadata' object containing arrays of matching 'music', 'custom_files', or 'humming' results with title, artist, ISRC, and confidence fields; a 'status.code' of 1001 means no result found
6. For bulk file scanning rather than real-time identification, use ACRCloud's File Scanning API: upload files to a scanning container via POST to the console API and retrieve results asynchronously