AudioVerify™

AudioVerify identifies the music used in a video. Upload a clip and AudioVerify returns the recognized track, whether it lives in the Slipstream catalog, and, when an outside service exposes it, the registered label (for example Epidemic Sound).

Behind one simple submit-and-poll API, AudioVerify runs a three-tier pipeline: it matches against the Slipstream catalog first (audio fingerprinting), then falls back to external recognition for anything outside the catalog.

How it works

Recognition runs asynchronously. You submit a video and immediately get a job_id, then poll until the job is completed.

Submit a video, either as a direct file upload or by reference to a file you uploaded to S3 with a presigned URL. You get back a job_id.
Poll the job until status is completed. The response then carries the recognized track (or null if no music was found).

Endpoints

Method	Path	Purpose
`POST`	`/api/v4/video-recognition/`	Submit a video (file upload or `storage_key`). Returns a `job_id`.
`POST`	`/api/v4/video-recognition/upload-url/`	Get a presigned S3 URL to upload large videos directly.
`GET`	`/api/v4/video-recognition/{job_id}/`	Poll a job for its status and result.

The RecognitionJob object

{
  "job_id": "7b2c1e8a-0f4d-4a2b-9c11-7f5a2d9e3c10",
  "status": "completed",
  "track": {
    "id": "11111111-1111-1111-1111-111111111111",
    "title": "Golden Hour",
    "artist": "The Coast",
    "internal": true,
    "isrc": "USRC12345678",
    "score": 96.5,
    "external_label": null
  }
}

Field	Description
`job_id`	UUID of the recognition job. Use it to poll for the result.
`status`	One of `queued`, `processing`, or `completed`.
`track`	The recognized track once `status` is `completed`, or `null` if no music was detected. See below.

The RecognitionTrack object

Field	Type	Description
`id`	string or null	Slipstream track UUID. Present only for catalog matches (`internal: true`); `null` for outside matches.
`title`	string	Track title.
`artist`	string	Artist name.
`internal`	boolean	`true` when the track is in the Slipstream catalog, `false` when it was identified by an outside service.
`isrc`	string or null	International Standard Recording Code, when known.
`score`	number	Confidence from 0 to 100. For catalog matches this is the fingerprint similarity; outside matches report 100.
`external_label`	string or null	Registered label exposed by external recognition, for example `"Epidemic Sound"`. Set for outside matches when known; `null` for catalog matches. Use this to flag music from competing royalty-free libraries.

A track value of null on a completed job means no music was recognized in the video. That is a normal result, not an error.

Input limits

Accepted formats: .mp4, .mov, .avi, .mpeg
Maximum file size: 100 MB (use Get an upload URL for large files so the bytes never proxy through the API)

Render and download Submit a video