Create Dynamic Music Loops with the MusicGen Looper Cognitive Actions

24 Apr 2025
Create Dynamic Music Loops with the MusicGen Looper Cognitive Actions

In the realm of digital music production, the ability to generate unique soundscapes on-demand can be a game-changer for developers and musicians alike. The MusicGen Looper from Andreas Jansson offers a powerful suite of Cognitive Actions that enable you to create fixed BPM music loops from text prompts. By leveraging MusicGen for music generation and BeatNet for beat detection, these actions simplify the process of crafting audio tracks tailored to your specifications.

Prerequisites

Before diving into the integration of MusicGen Looper Cognitive Actions, ensure you have the following:

  • API Key: Obtain an API key from the Cognitive Actions platform to authenticate your requests.
  • Development Environment: Set up your development environment to make HTTP requests. This typically involves using libraries like requests in Python.

Authentication is generally handled by including your API key in the request headers, allowing you to securely access the Cognitive Actions.

Cognitive Actions Overview

Generate Fixed-BPM Music Loops

Description: This action creates music loops at a fixed BPM from text prompts. It's a versatile tool for generating sound tailored to specific themes or vibes.

Input

The input schema for this action is structured as follows:

  • prompt (string, required): A description of the music you want to generate.
  • bpm (number, optional): Beats per minute, default is 140 (range: 40-300).
  • seed (integer, optional): Random seed for generation, default is -1 (random).
  • topK (integer, optional): Limits sampling to the K most probable tokens, default is 250.
  • topP (number, optional): Cumulative probability limit, defaults to 0.
  • variations (integer, optional): Number of variations to generate (1-20), default is 4.
  • maxDuration (integer, optional): Max duration of the audio loop in seconds (2-20), default is 8.
  • temperature (number, optional): Diversity of the sampling process, default is 1.
  • modelVersion (string, optional): Model version to use, options are 'medium' or 'large', default is 'medium'.
  • outputFormat (string, optional): Format of the generated audio file, options are 'wav' or 'mp3', default is 'wav'.
  • classifierFreeGuidance (integer, optional): Input influence on output, default is 3.

Example Input:

{
  "bpm": 160,
  "seed": -1,
  "topK": 250,
  "prompt": "Melodic euro trance",
  "variations": 4,
  "maxDuration": 4,
  "temperature": 1,
  "modelVersion": "medium",
  "outputFormat": "wav",
  "classifierFreeGuidance": 3
}

Output

The action typically returns a set of audio file URLs corresponding to the generated variations. Example output might look like this:

{
  "variation_01": "https://assets.cognitiveactions.com/invocations/.../893a988d-2630-4860-b52f-1a370301dfc4.wav",
  "variation_02": "https://assets.cognitiveactions.com/invocations/.../e67b2bb1-18bd-49de-a810-090eaaa5638b.wav",
  "variation_03": "https://assets.cognitiveactions.com/invocations/.../fefcfe3a-90ca-4eda-a44f-e7e9680bee85.wav",
  "variation_04": "https://assets.cognitiveactions.com/invocations/.../dce73658-feda-4ab6-9910-6830455b5681.wav"
}

Conceptual Usage Example (Python)

Here’s how you might structure a call to the MusicGen Looper action using Python:

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 = "c6c53f68-7c12-4376-8544-28999453e18f" # Action ID for Generate Fixed-BPM Music Loops

# Construct the input payload based on the action's requirements
payload = {
    "bpm": 160,
    "seed": -1,
    "topK": 250,
    "prompt": "Melodic euro trance",
    "variations": 4,
    "maxDuration": 4,
    "temperature": 1,
    "modelVersion": "medium",
    "outputFormat": "wav",
    "classifierFreeGuidance": 3
}

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 snippet, the action_id is set to the ID for generating fixed-BPM music loops, and the input payload reflects the structure needed for the request. Remember that the endpoint URL and request structure are illustrative and may differ in your actual implementation.

Conclusion

The MusicGen Looper Cognitive Actions provide a robust framework for generating unique music loops based on descriptive prompts. By integrating these actions into your applications, you can unlock new creative possibilities in music production. Whether you're building a music app, game, or any other interactive experience, these tools can help you deliver tailored audio content efficiently. Explore how you can leverage these capabilities to enhance your projects!

← Back to All Articles