Retrieve the status of the uploaded audio file

February 17, 2025

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

Use this endpoint to retrieve the status of the uploaded with POST music/upload-audio audio file.

At the time of writing this article, it is not clear how long it takes to process an uploaded audio file. Our internal testing shows that if a file is still being processed after 10 minutes, it is likely that the processing will never complete.

https://api.useapi.net/v1/riffusion/music/upload-audio/?…

Request Headers 
Authorization: Bearer {API token}
Content-Type: application/json
Query Parameters

  • user_id is optional when only one account configured. However, if you have multiple accounts configured, this parameter becomes required.

  • id is required, use job_id value returned by POST music/upload-audio.

Responses

  • 200 OK

    {
    "is_flagged": true,
    "transcribed_lyrics": "…transcribed lyrics…",
    "status": "complete"
}

  • 400 Bad Request

    {
    "error": "<Error message>",
    "code": 400
}

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}

  • 596 Pending error

    API was unable to refresh your cookie. Please resolve this issue by using the POST accounts endpoint before making any new API calls.

    {
  "error": "Your Riffusion account has pending error. Please address this issue at https://useapi.net/docs/api-riffusion-v1/post-riffusion-accounts before making any new API calls."
}
Model 
{   // TypeScript, all fields are optional
    is_flagged: boolean
    transcribed_lyrics: string
    status: 'complete' | unknown
}
Examples 
  • curl "https://api.useapi.net/v1/riffusion/music/upload-audio/?id=<id>&user_id=<user_id>" \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …" 

  • const token = "API token";
const id = "job_id of uploaded audio file"; 
const user_id = "Previously configured account"; 
const apiUrl = `https://api.useapi.net/v1/riffusion/music/upload-audio/?id=${id}&user_id=${user_id}`; 
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});

  • import requests
token = "API token"
id = "job_id of uploaded audio file"
user_id = "Previously configured account"
apiUrl = f"https://api.useapi.net/v1/riffusion/music/upload-audio/?id={id}&user_id={user_id}"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It