Skip to navigation
API ReferenceMusic Detection

Detect AI-generated music

Analyze a song or music track and classify it as AI-generated or human-produced.

Supply audio via one of three intake methods:

  • Direct file upload: multipart/form-data with the file attached as file. Files must be 150 MB or smaller.
  • Public URL: application/json with a url field. Resemble downloads and stores the file before analysis.
  • Secure upload token: application/json with a media_token field obtained from POST /secure_uploads.

Exactly one of file, url, or media_token must be provided per request. Only audio files are accepted.

Processing is asynchronous by default: the response returns immediately with status: processing. Music detections are standard detections, so you can poll GET /detect/{uuid} or supply a callback_url to be notified. Send the Prefer: wait header to block until the verdict is available and receive the completed item in the same response. Allow a generous client timeout when waiting, since the first request after a period of inactivity can take several minutes while the model warms up.

Each successful analysis is billed as audio Deepfake Detection usage. Failed analyses are not billed.

Authentication

AuthorizationBearer

Headers

PreferenumOptional
When set to "wait", the API processes synchronously and returns the completed result.
Allowed values:

Request

This endpoint expects a multipart form containing a file.
filefileRequired
The audio file to analyze. Must be 150 MB or smaller.
namestringOptional
Display name for the detection. Defaults to the source filename.
callback_urlstringOptionalformat: "uri"

POST destination for the result once processing finishes. The body matches the response of GET /detect/{uuid}.

visualizebooleanOptionalDefaults to false

Return a base64-encoded heatmap image in metrics.image.

start_regiondoubleOptional
Start of the segment to analyze, in seconds.
end_regiondoubleOptional
End of the segment to analyze, in seconds.

Response

Music detection created (or completed when Prefer: wait was sent)

successboolean
itemobject

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
422
Unprocessable Entity Error
502
Bad Gateway Error
504
Gateway Timeout Error