Upload, Trim and Loop Audio - v1

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:

Parameter	Type	Required	Description
`audioUrl`	`string`	✅ Required	Public URL of a user uploaded audio file to detect loop from.
`count`	`int`	✅ Required	Number 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())

curl -X POST "https://api.soundverse.ai/v1/generate/trim-and-loop/auto" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
    "audioUrl": "string",
    "count": "int"
  }'

Response

200 OK
400 Bad Request

{
  "albumArt":"str",
  "aiReply":"str",
  "audioData":[
    {
      "audioUrl":"str",
      "songName":"str"
    }
  ]
}

    
  {
    "Detail": “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:

Parameter	Type	Required	Description
`audioUrl`	`string`	✅ Required	Public URL of a user uploaded audio file to detect loop from.
`count`	`int`	✅ Required	Number of times to loop the detected seamless segment.
`beatsToInclude`	`int`	✅ Required	Number 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())

curl -X POST "https://api.soundverse.ai/v1/generate/trim-and-loop/beat-count" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
    "audioUrl": "string",
    "count": "int",
    "beatsToInclude": "int"
  }'

Response

200 OK
400 Bad Request

{
  "albumArt":"str",
  "aiReply":"str",
  "audioData":[
    {
      "audioUrl":"str",
      "songName":"str"
    }
  ]
}

    
  {
    "Detail": “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:

Parameter	Type	Required	Description
`audioUrl`	`string`	✅ Required	Public URL of a user uploaded audio file to detect loop from.
`count`	`int`	✅ Required	Number of times to loop the detected seamless segment.
`timeRanges`	`List`	✅ Required	Time 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())

curl -X POST "https://api.soundverse.ai/v1/generate/trim-and-loop/time-range" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
    "audioUrl": "string",
    "count": "integer",
    "timeRanges": [
      {
        "start": "float",
        "end": "float"
      }
    ]
   }'

Response

200 OK
400 Bad Request

{
  "albumArt":"str",
  "aiReply":"str",
  "audioData":[
    {
      "audioUrl":"str",
      "songName":"str"
    }
  ]
}

    
  {
    "Detail": “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.",
}

Get Started

Frequently Asked Questions

Creating with Soundverse

Exploring Soundverse

Account Management

Enterprise Platform

API Documentation

Upload, Trim and Loop Audio - v1

Trim and Loop Audio - Auto

Core Parameters

Request Example

Response

Sample Output

Possible Errors :

Trim and Loop Audio - Beats

Core Parameters

Request Example

Response

Sample Output

Possible Errors :

Trim and Loop Audio - Time Range

Core Parameters

Request Example

Response

Sample Output

Possible Errors :

​Trim and Loop Audio - Auto

​Core Parameters

​Request Example

​Response

​Sample Output

​Possible Errors :

​Trim and Loop Audio - Beats

​Core Parameters

​Request Example

​Response

​Sample Output

​Possible Errors :

​Trim and Loop Audio - Time Range

​Core Parameters

​Request Example

​Response

​Sample Output

​Possible Errors :

Trim and Loop Audio - Auto

Core Parameters

Request Example

Response

Sample Output

Possible Errors :

Trim and Loop Audio - Beats

Core Parameters

Request Example

Response

Sample Output

Possible Errors :

Trim and Loop Audio - Time Range

Core Parameters

Request Example

Response

Sample Output

Possible Errors :