APIs and Controller

Identify Song Clip - Query Custom ML Model

Django API endpoint to save audio clip and call our machine learning model. Requires the audio file of a sound clip. Returns the identified song title.

Endpoint: POST /postAudio/

Request Parameters (Multipart Form):

Key	Value
audio	16-bit mono pcm audio file to identify

Returns (JSON): Response title of input audio clip

Key	Type	Value
songName	String	The title of the song identified by the ML model.

Response Codes:

Response Code	Interpretation
`200 OK`	Successfully identified the song; name supplied in return JSON.
`404 Bad Request`	Invalid request format.

Get Song's Movie Information

Django API endpoint to retrieve relevant movie/song information. Returns information for movies that contain a given song.

Endpoint: POST /getsongs/

Request Parameters:

Key	Value
songName	The name of the song on which movie data is desired.

Returns (JSON):

Key	Type	Value
movies	Array of String Arrays	An array of movie information that contain the song passed in the request body.

Here's a breakdown of the arrays contained in movies:

Index	Type	Value
0	String	The name of the movie.
1	String	The year the movie was released.
2	String	The director of the movie.
3	String	Link to movie poster.

Response Codes:

Response Code	Interpretation
`200 OK`	Successfully located related movies and associated data. Returns json results as above.
`400 Bad Request`	Invalid request format.
`404 Not Found`	Unrecognized song.