Enhance Your Audio Files with sakemin/audiosr-long-audio Cognitive Actions

25 Apr 2025
Enhance Your Audio Files with sakemin/audiosr-long-audio Cognitive Actions

In the realm of audio processing, the ability to enhance audio files is a game changer for developers working on applications that involve music, speech, or other audio types. The sakemin/audiosr-long-audio Cognitive Actions provide a powerful solution for upsampling audio files to 48kHz using the AudioSR model. This capability ensures high-fidelity output, making it suitable for longer audio inputs through effective audio slicing. In this article, we will explore how to utilize these Cognitive Actions to improve audio quality in your applications.

Prerequisites

Before diving into the implementation, ensure you have the following prerequisites:

  • An API key for accessing the Cognitive Actions platform.
  • Basic understanding of JSON structure and HTTP requests.
  • Familiarity with Python programming for the conceptual usage example.

To authenticate your requests, you typically pass your API key in the headers of your HTTP requests.

Cognitive Actions Overview

Upsample Audio with AudioSR

The Upsample Audio with AudioSR action is designed to enhance audio files by upsampling them to 48kHz. This is particularly useful for various audio types, including music and speech, ensuring that the output maintains high fidelity.

Input

The input for this action requires a structured JSON object with the following fields:

  • inputFile (required): A URI pointing to the audio file you wish to upsample. This file must be accessible via a direct link.
  • seed (optional): An integer to set a random seed for reproducible results. Leaving it blank will use a randomized seed.
  • guidanceScale (optional): A number that adjusts the strength of classifier-free guidance, balancing creativity and accuracy (default is 3.5, range 1-20).
  • inferenceSteps (optional): An integer representing the number of diffusion steps during inference (default is 50, range 10-500).
  • truncateBatches (optional): A boolean indicating whether to truncate audio batches to 5.12 seconds to manage memory (default is true).

Example Input:

{
  "inputFile": "https://replicate.delivery/pbxt/KAKI8ICYErWME5r97mH0u9PTiWSahhMWKQe6MBgyWt2bXku7/replicate-prediction-7qwdluzb3dgucqauj4gbkzl4w4.wav",
  "guidanceScale": 3.5,
  "inferenceSteps": 50,
  "truncateBatches": true
}

Output

The action typically returns a URI linking to the upsampled audio file. This output provides a direct way to access the enhanced audio.

Example Output:

https://assets.cognitiveactions.com/invocations/978b3ab8-71d3-46d1-86ca-abed52b2f569/bf11fc2b-7c15-4b5a-848c-3cf097b1d463.wav

Conceptual Usage Example (Python)

Here’s a conceptual Python code snippet illustrating how to use the Upsample Audio with AudioSR action:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"  # Hypothetical endpoint

action_id = "5ce5d0cd-37f4-4534-9e36-1db9f917cc09"  # Action ID for Upsample Audio with AudioSR

# Construct the input payload based on the action's requirements
payload = {
    "inputFile": "https://replicate.delivery/pbxt/KAKI8ICYErWME5r97mH0u9PTiWSahhMWKQe6MBgyWt2bXku7/replicate-prediction-7qwdluzb3dgucqauj4gbkzl4w4.wav",
    "guidanceScale": 3.5,
    "inferenceSteps": 50,
    "truncateBatches": True
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload}  # Hypothetical structure
    )
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

In this code snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id corresponds to the Upsample Audio with AudioSR action. The input payload is structured according to the action's requirements, ensuring proper execution.

Conclusion

The sakemin/audiosr-long-audio Cognitive Actions offer developers a straightforward way to enhance audio files by upsampling them to 48kHz. By leveraging these actions, you can significantly improve the quality of audio in your applications, whether for music, podcasts, or any other audio content. As you explore these capabilities, consider integrating them into your projects to unlock new levels of audio fidelity. Happy coding!

← Back to All Articles