Upload audio file

February 17, 2025 (February 25, 2025)

Table of contents

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

You can upload the mp3, m4a and wav file types. Although there isn’t a file size limit, we recommend uploading files less than 50 MB.

POST raw content using Make.com and similar nocode tools.

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

Request Headers 
Authorization: Bearer {API token}
Content-Type: select from the table below
  • API token is required, see Setup useapi.net for details.
  • Content-Type is required, select from the table below:
Content-Type File Extension
audio/mp4 m4a
audio/x-m4a m4a
audio/mpeg mp3
audio/wav wav
audio/wave wav
Query Parameters

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

  • file_name is required. Specify your file name without the extension.

Responses

  • 200 OK

    Use the returned id for GET music/upload-audio to retrieve the status and transcribed lyrics of your upload. Once the response’s status field returns value different from pending, you can use this audio_upload_id in POST music/create-compose.

    {
    "is_flagged": true,
    "id": "e2c32a87-3d19-4e53-a007-efd4a9632847:b5d369a2-5b43-4484-a3a7-ee2d39af015d",
    "transcription_job_id": "b5d369a2-5b43-4484-a3a7-ee2d39af015d",
    "audio_upload_id": "e2c32a87-3d19-4e53-a007-efd4a9632847"
}

  • 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
  id: string
  is_flagged: boolean
  audio_upload_id: string
  transcription_job_id: string
  error: string
  code: number
}
Examples 
  • curl "https://api.useapi.net/v1/riffusion/music/upload-audio/?file_name=<file_name>&user_id=<user_id>" \
  -H "Authorization: Bearer …" \
  -H "Content-Type: audio/mpeg" \
  --data-binary /path/to/your/my-music-track.mp3

  • const token = "API token";
const user_id = "Previously configured account"; 
const file_name = "Your file name"; 
const apiUrl = `https://api.useapi.net/v1/riffusion/music/upload-audio/?file_name=${file_name}&user_id=${user_id}`; 
let blob;
/*
    // Example 1: Fetch audio from URL
    const audioUrl = "https://upload.wikimedia.org/wikipedia/commons/my-music-track.mp3";
    const responseAudio = await fetch(audioUrl);
    blob = await responseAudio.blob();
*/
/* 
    // Example 2: Load audio from local file (Blob)
    const fsp = require('fs').promises;
    const audioFileName = "./my-music-track.mp3";
    blob = new Blob([await fsp.readFile(audioFileName)]);
*/
/*
    // Example 3: Load from input file html element
    // <input id="audio-file" type="file"> 
    const audioFile = document.getElementById(`audio-file`);
    if (audioFile.files[0])
        blob = audioFile.files[0]);
*/
const response = await fetch(apiUrl, {
  method: "POST"
  headers: {
    "Authorization": `Bearer ${token}`,
  },
  body: blob
});
const result = await response.json();
console.log("response", {response, result});

  • import requests
token = "API token"
user_id = "Previously configured account"
file_name = "Your file name"
apiUrl = f"https://api.useapi.net/v1/riffusion/music/upload-audio/?file_name={file_name}&user_id={user_id}"
headers = {
    'Authorization': f'Bearer {token}',
    'Content-Type': 'audio/mpeg'
}

# # Example 1: Fetch audio from URL
# audio_url = "https://upload.wikimedia.org/wikipedia/commons/my-music-track.mp3"
# response_audio = requests.get(audio_url)
# file_content = response_audio.content

# # Example 2: Load audio from local file
# audio_file_path = "./my-music-track.mp3"
# with open(audio_file_path, 'rb') as audio_file:
#     file_content = audio_file.read()

response = requests.post(api_url, headers=headers, data=file_content)
print(response, response.json())
Try It