Download generated music

May 15, 2025 (November 16, 2026)

Table of contents

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

This endpoint retrieves a download URL for a completed music generation job. The job_id must be from a successfully completed generation job that can be verified with GET music/job_id.

https://api.useapi.net/v1/tempolor/music/download/job_id

Request Headers
Authorization: Bearer {API token}
Path Parameters
Query Parameters
  • file_format is optional. Specifies the format of the generated music to download.
    Supported values:
    • mp3 - MP3 format (default)
    • wav - WAV format (higher quality)
    • stems - ZIP archive containing separated stems (vocals, instruments, etc.)
Responses
  • 200 OK

    {
      "url": "https://ugc-cdn.api.instabeat.ai/ai_material/ai_material/mp3/abcdef123456789.mp3?auth_key=1747536678-0-0-9c67b3d5f8a2c41e0d7f6eab3f82fb45",
      "remainSeconds": 0
    }
    

    The download URL expires after remainSeconds seconds.

  • 400 Bad Request

    {
      "error": "Generation is not completed yet (0)",
      "code": 400
    }
    
  • 401 Unauthorized

    {
      "error": "Unauthorized",
      "code": 401
    }
    
  • 404 Not Found

    {
      "error": "No record found for user:12345-tempolor:user_id-job:abcdef123456789",
      "code": 404
    }
    
  • 596 Account signed out

    TemPolor signed the account out, so its session ticket no longer works. The API stops using the account until you add it again with fresh credentials at POST accounts, see Setup TemPolor. Requests without user_id use your other accounts in the meantime.

    {
      "error": "TemPolor signed out account 101441809 (You are currently logged out (400006)). Add it again with POST /v1/tempolor/accounts using fresh credentials, see https://useapi.net/docs/start-here/setup-tempolor",
      "code": 596
    }
    

    If every account you have is in this state, a request without user_id returns 596 as well.

Model

The download url for the finished music, which expires after remainSeconds seconds.

The download link, field by field
{   // TypeScript, all fields are optional
    url: string
    remainSeconds: number
    error: string
    code: number
}
Examples
  • # Download in MP3 format (default)
    curl -H "Authorization: Bearer …" \
         https://api.useapi.net/v1/tempolor/music/download/user:12345-tempolor:user_id-job:abcdef123456789
    
    # Download in WAV format (higher quality)
    curl -H "Authorization: Bearer …" \
         "https://api.useapi.net/v1/tempolor/music/download/user:12345-tempolor:user_id-job:abcdef123456789?file_format=wav"
    
    # Download stems (separated vocal, instruments, etc.)
    curl -H "Authorization: Bearer …" \
         "https://api.useapi.net/v1/tempolor/music/download/user:12345-tempolor:user_id-job:abcdef123456789?file_format=stems"
    
  • const job_id = "user:12345-tempolor:user_id-job:abcdef123456789";
    const token = "API token";
    const file_format = "mp3"; // or "wav" or "stems"
    const apiUrl = `https://api.useapi.net/v1/tempolor/music/download/${job_id}?file_format=${file_format}`;
    
    const response = await fetch(apiUrl, {
      method: "GET",
      headers: {
        "Authorization": `Bearer ${token}`
      }
    });
    const result = await response.json();
    console.log("Download URL:", result.url);
    
    // Example of downloading the file
    async function downloadFile(downloadUrl, fileName) {
      const fileResponse = await fetch(downloadUrl);
      const blob = await fileResponse.blob();
      
      // For browser environments
      const url = window.URL.createObjectURL(blob);
      const a = document.createElement('a');
      a.style.display = 'none';
      a.href = url;
      a.download = fileName;
      document.body.appendChild(a);
      a.click();
      window.URL.revokeObjectURL(url);
      
      // For Node.js environments
      // const fs = require('fs');
      // const buffer = Buffer.from(await blob.arrayBuffer());
      // fs.writeFileSync(fileName, buffer);
    }
    
    // If the request was successful, download the file
    if (result.url) {
      const fileName = `tempolor-music-${Date.now()}.${file_format === 'stems' ? 'zip' : file_format}`;
      await downloadFile(result.url, fileName);
    }
    
  • import requests
    import os
    
    job_id = "user:12345-tempolor:user_id-job:abcdef123456789"
    token = "API token"
    file_format = "mp3"  # or "wav" or "stems"
    apiUrl = f"https://api.useapi.net/v1/tempolor/music/download/{job_id}?file_format={file_format}"
    headers = {
        "Authorization": f"Bearer {token}"
    }
    
    response = requests.get(apiUrl, headers=headers)
    result = response.json()
    print("Download URL:", result.get("url"))
    
    # Example of downloading the file
    def download_file(download_url, file_name):
        file_response = requests.get(download_url)
        with open(file_name, 'wb') as f:
            f.write(file_response.content)
        print(f"File downloaded as {file_name}")
    
    # If the request was successful, download the file
    if result.get("url"):
        if file_format == "stems":
            file_name = f"tempolor-music-{job_id.split(':')[-1]}.zip"
        else:
            file_name = f"tempolor-music-{job_id.split(':')[-1]}.{file_format}"
        download_file(result.get("url"), file_name)
    
Try It