Skip to main content

​
Trim and Loop Audio - Auto

This API automatically detects a seamless loop in the provided user uploaded audio, trims it, and loops the trimmed segment based on the textual description using AI.

​
Core Parameters

The following parameters are required to send a valid request:
ParameterTypeRequiredDescription
audioUrlstring✅ RequiredPublic URL of a user uploaded audio file to detect loop from.
countint✅ RequiredNumber of times to loop the detected seamless segment.

​
Request Example

{
  "audioUrl": "https://example.com/audio.wav",
  "count": 4
}
  • Python
  • cURL
  import requests

  url = "https://api.soundverse.ai/v1/generate/trim-and-loop/auto"
  headers = {
      "Authorization": "Bearer your_api_key_here",
      "Content-Type": "application/json"
  }
  payload = {
    "audioUrl": "string",
    "count": "int"
  }

  response = requests.post(url, json=payload, headers=headers)
  print(response.json())

​
Response

  • 200 OK
  • 400 Bad Request
{
  "albumArt":"str",
  "aiReply":"str",
  "audioData":[
    {
      "audioUrl":"str",
      "songName":"str"
    }
  ]
}

​
Sample Output

{
  "albumArt": "https://storage.googleapis.com/soundverse-assets/album-art/ambient_piano_loop.png",
  "aiReply": "Here's your cinematic ambient piano loop, repeated seamlessly 4 times.",
  "audioData": [
    {
      "audioUrl": "https://storage.googleapis.com/soundverse-outputs/looped/ambient_piano_loop_trimmed_x4.wav",
      "songName": "Hopeful Ambient Piano Loop"
    }
  ]
}

​
Possible Errors :

  • If Rate Limits have been passed for User.
{
"success": False,
"message": "Rate limits have been passed for the user.",
}
  • If Length of provided audio is too short.
{
"success": False,
"message": "Not enough beats to create loop.",
}
  • If Length of looped audio is more than 960.
{
"success": False,
"message": "Maximum audio duration of 960 seconds reached.",
}

​
Trim and Loop Audio - Beats

This API automatically detects a seamless loop in the provided user uploaded audio, trims it, and loops the trimmed segment based on the textual description and Number of Beats given by user using AI.

​
Core Parameters

The following parameters are required to send a valid request:
ParameterTypeRequiredDescription
audioUrlstring✅ RequiredPublic URL of a user uploaded audio file to detect loop from.
countint✅ RequiredNumber of times to loop the detected seamless segment.
beatsToIncludeint✅ RequiredNumber of beats to include in the looped segment.

​
Request Example

{
  "audioUrl": "https://example.com/audio.wav",
  "count": 4,
  "beatsToInclude": 32
}
  • Python
  • cURL
  import requests

  url = "https://api.soundverse.ai/v1/generate/trim-and-loop/beat-count"
  headers = {
      "Authorization": "Bearer your_api_key_here",
      "Content-Type": "application/json"
  }
  payload = {
    "audioUrl": "string",
    "count": "int",
    "beatsToInclude": "int"
  }

  response = requests.post(url, json=payload, headers=headers)
  print(response.json())

​
Response

  • 200 OK
  • 400 Bad Request
{
  "albumArt":"str",
  "aiReply":"str",
  "audioData":[
    {
      "audioUrl":"str",
      "songName":"str"
    }
  ]
}

​
Sample Output

{
  "albumArt": "https://storage.googleapis.com/soundverse-assets/album-art/ambient_piano_loop.png",
  "aiReply": "Here's your cinematic ambient piano loop, repeated seamlessly 4 times.",
  "audioData": [
    {
      "audioUrl": "https://storage.googleapis.com/soundverse-outputs/looped/ambient_piano_loop_trimmed_x4.wav",
      "songName": "Hopeful Ambient Piano Loop"
    }
  ]
}

​
Possible Errors :

  • If Rate Limits have been passed for User.
{
"success": False,
"message": "Rate limits have been passed for the user.",
}
  • If Length of provided audio is too short.
{
"success": False,
"message": "Not enough beats to create loop.",
}
  • If Length of looped audio is more than 960.
{
"success": False,
"message": "Maximum audio duration of 960 seconds reached.",
}

​
Trim and Loop Audio - Time Range

This API automatically detects a seamless loop in the provided user uploaded audio, trims it, and loops the trimmed segment based on the textual description and Time Ranges given by user using AI.

​
Core Parameters

The following parameters are required to send a valid request:
ParameterTypeRequiredDescription
audioUrlstring✅ RequiredPublic URL of a user uploaded audio file to detect loop from.
countint✅ RequiredNumber of times to loop the detected seamless segment.
timeRangesList✅ RequiredTime ranges to include in the looped segment.

​
Request Example

{
  "audioUrl": "https://example.com/audio.wav",
  "count": 4,
  "timeRanges": [                                 
        {"start": 10.5, "end": 20.0},
        {"start": 30.0, "end": 45.0},
        {"start": 50.25, "end": 65.75}
  ]
}
  • Python
  • cURL
  import requests

  url = "https://api.soundverse.ai/v1/generate/trim-and-loop/time-range"
  headers = {
      "Authorization": "Bearer your_api_key_here",
      "Content-Type": "application/json"
  }
  payload = 
  {
    "audioUrl": "string",
    "count": "integer",
    "timeRanges": [
      {
        "start": "float",
        "end": "float"
      }
    ]
  }

  response = requests.post(url, json=payload, headers=headers)
  print(response.json())

​
Response

  • 200 OK
  • 400 Bad Request
{
  "albumArt":"str",
  "aiReply":"str",
  "audioData":[
    {
      "audioUrl":"str",
      "songName":"str"
    }
  ]
}

​
Sample Output

{
  "albumArt": "https://storage.googleapis.com/soundverse-assets/album-art/ambient_piano_loop.png",
  "aiReply": "Here's your cinematic ambient piano loop, repeated seamlessly 4 times.",
  "audioData": [
    {
      "audioUrl": "https://storage.googleapis.com/soundverse-outputs/looped/ambient_piano_loop_trimmed_x4.wav",
      "songName": "Hopeful Ambient Piano Loop"
    }
  ]
}

​
Possible Errors :

  • If Rate Limits have been passed for User.
{
"success": False,
"message": "Rate limits have been passed for the user.",
}
  • If Time Range provided is out of bounds.
{
"success": False,
"message": "Time range {i} is out of bounds.",
}
  • If end sample is less than or equal to start sample.
{
"success": False,
"message": "Invalid range: start >= end at index {i}.",
}
  • If Time Range array is empty.
{
"success": False,
"message": "No valid segments found.",
}
  • If Length of looped audio is more than 960.
{
"success": False,
"message": "Maximum audio duration of 960 seconds reached.",
}
⌘I