audio-processing

Transform Your Audio with Advanced Time-Scale Modification

25 Apr 2025
Transform Your Audio with Advanced Time-Scale Modification

In the fast-paced world of audio processing, the ability to modify time scales effectively can be a game changer for developers. With the Pytsmod library, you can achieve advanced audio manipulation techniques such as time-stretching and pitch-shifting using various algorithms like OLA, WSOLA, PV-TSM, and TD-PSOLA. This flexibility allows you to enhance audio for music production, sound design, and even speech processing, making it an invaluable tool for any developer looking to innovate in the audio space.

Imagine needing to create a soundtrack that matches the pace of a video or altering a voice recording to fit a specific musical key. The Pytsmod library simplifies these processes, saving you time and effort while providing high-quality results. Whether you're working on a podcast, a music track, or an audio application, Pytsmod enables you to manipulate audio files seamlessly and effectively.

Prerequisites

To get started with Pytsmod, you'll need a Cognitive Actions API key and a basic understanding of making API calls.

Perform Time-Scale Modification

The primary action of Pytsmod is to perform time-scale modification, allowing developers to manipulate audio files in various ways.

Purpose

This action utilizes advanced time-stretching and pitch-shifting techniques to modify audio files according to specific requirements. By adjusting the time scale, developers can create unique audio experiences that enhance their projects.

Input Requirements

To use this action, you'll need to provide the following inputs:

  • audioSourceUri: The URI of the audio file to be modified.
  • stretchFixed: A numerical value representing the constant time stretching factor.
  • stretchMethod: The method of time stretching to be used (e.g., OLA, WSOLA).
  • Additional parameters may include pitch shifting options and metrics for absolute frames or seconds.

Example Input:

{
  "stretchFixed": 2,
  "stretchMethod": "WSOLA",
  "audioSourceUri": "https://replicate.delivery/pbxt/K5D74nOaaZcp7IBzh1IGWJBg2nyVg1leTQKEkYrQrn3WvB3q/ditto_chopped.wav",
  "tdPsolaPitchMode": "None",
  "useAbsoluteSecond": false
}

Expected Output

Upon successful execution, the action will return a URI to the modified audio file, allowing you to access the newly processed audio.

Example Output:

https://assets.cognitiveactions.com/invocations/cac1084a-2c03-4573-bc61-486fda5c7c7f/9e110211-f5f5-42c6-a77b-6efdb872b321.wav

Use Cases for this Action

  1. Music Production: Adjust the tempo of a track without altering its pitch, allowing for perfect synchronization with video or other audio elements.
  2. Sound Design: Create dynamic soundscapes by stretching or compressing audio samples to fit specific time frames or artistic visions.
  3. Speech Processing: Modify the speed of spoken content in podcasts or audiobooks to enhance clarity or fit a desired duration.
  4. Creative Projects: Experiment with audio alterations for artistic projects, such as installations or multimedia presentations.
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "fc626d65-7be2-4204-8ddf-1b9f5332e962" # Action ID for: Perform Time-Scale Modification

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "stretchFixed": 2,
  "stretchMethod": "WSOLA",
  "audioSourceUri": "https://replicate.delivery/pbxt/K5D74nOaaZcp7IBzh1IGWJBg2nyVg1leTQKEkYrQrn3WvB3q/ditto_chopped.wav",
  "tdPsolaPitchMode": "None",
  "useAbsoluteSecond": false
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")

Conclusion

With the capabilities offered by Pytsmod for time-scale modification, developers can unlock new potentials in audio processing. The ability to manipulate audio files efficiently not only streamlines workflows but also enhances the creative possibilities of your projects. Whether you're a music producer, sound designer, or working on any audio-related application, integrating Pytsmod's actions can lead to innovative solutions and captivating audio experiences. Start exploring these features today and elevate your audio projects to the next level!

← Back to All Articles