Extend Song - v5 - Soundverse

🚀 apiv2 is live!

Soundverse’s Enterprise API has moved to apiv2.soundverse.ai — new self-serve account setup, API keys, and billing are managed at platform.soundverse.ai. This page documents the legacy api.soundverse.ai API.

Extend AI Song (v5)

The API supports both streaming and synchronous responses

Endpoints

/v5/extend/song - streaming
/v5/extend/song/sync - synchronous

Request Parameters

Parameter	Type	Description	Required	Default Value
`audio_url`	string	URL of the audio file to extend	Yes	N/A
`lyrics`	string	Lyrics to guide the extension style and mood.	Yes	N/A
`prompt`	string	Prompt to guide the extension style and mood.	No	N/A
`extend_at`	integer	Position (in ms) to extend the song at [8000,420000]	Yes	N/A

Example Request

{
  "audio_url": "https://storage.soundverse.ai/.../original_song.mp3",
  "lyrics": "These are the song lyrics to guide the extension",
}

Code Examples - Streaming

import requests
import json

url = "https://api.soundverse.ai/v5/extend/song"
headers = {
    "Authorization": "Bearer your_api_key_here",
    "Content-Type": "application/json"
}
payload = {
    "audio_url": "https://storage.soundverse.ai/.../original_song.mp3",
    "lyrics": "These are the song lyrics to guide the extension",
}

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

# Process streaming response
for line in response.iter_lines():
    if line:
        text = line.decode('utf-8')
        if text.startswith('data: '):
            data = json.loads(text[6:])
            print(data)

const url = "https://api.soundverse.ai/v5/extend/song";
const headers = {
  Authorization: "Bearer your_api_key_here",
  "Content-Type": "application/json",
};
const payload = {
  audio_url: "https://storage.soundverse.ai/.../original_song.mp3",
  lyrics: "These are the song lyrics to guide the extension",
};

const response = await fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload),
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  
  const chunk = decoder.decode(value);
  const lines = chunk.split('\n');
  
  lines.forEach(line => {
    if (line.startsWith('data: ')) {
      const data = JSON.parse(line.slice(6));
      console.log(data);
    }
  });
}

curl -X POST "https://api.soundverse.ai/v5/extend/song" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type": "application/json" \
  -d '{
    "audio_url": "https://storage.soundverse.ai/.../original_song.mp3",
    "lyrics": "These are the song lyrics to guide the extension",
  }' --no-buffer

Code Examples - Synchronous

import requests

url = "https://api.soundverse.ai/v5/extend/song/sync"
headers = {
    "Authorization": "Bearer your_api_key_here",
    "Content-Type": "application/json"
}
payload = {
    "audio_url": "https://storage.soundverse.ai/.../original_song.mp3",
    "lyrics": "These are the song lyrics to guide the extension",
}

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

const url = "https://api.soundverse.ai/v5/extend/song/sync";
const headers = {
  Authorization: "Bearer your_api_key_here",
  "Content-Type": "application/json",
};
const payload = {
  audio_url: "https://storage.soundverse.ai/.../original_song.mp3",
  lyrics: "These are the song lyrics to guide the extension",
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));

curl -X POST "https://api.soundverse.ai/v5/extend/song/sync" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type": "application/json" \
  -d '{
    "audio_url": "https://storage.soundverse.ai/.../original_song.mp3",
    "lyrics": "These are the song lyrics to guide the extension",
  }'

Streaming Response

Fields

🛈 The fields below are used in the chunks sent by SSE during the streaming process.

Parameter	Type	Description
`isComplete`	`bool`	Indicates if the streaming response is complete.
`status`	`string`	Current status of the extension process.
`chunkIndex`	`integer`	Index of the current chunk in the streaming sequence.
`message_id`	`string`	Unique identifier for the extension request.
`stream_url`	`string`	URL to access the generated audio stream when ready.
`version`	`integer`	Version of the generated content.
`album_art`	`string`	URL of the album art associated with the generated content.
`song_name`	`string`	Name of the generated track.
`progress`	`integer`	Progress percentage of the generation process. `0-100`
`streaming_ready`	`bool`	Indicates if audio is ready for streaming.
`version`	`integer`	Version number of the generated audio.
`audio_url`	`string`	URL of the generated audio file.
`error`	`string`	Error message if any issues occurred during processing.
`operation`	`string`	Type of operation being performed (e.g., “extend_song”).

please check Streaming Responses for more details

Synchronous Response

Sample Synchronous Output

{
  "message_id": "...",
  "album_art": "https://storage.soundverse.ai/soundverse-album-art/...album_art.png",
  "audio_data": [
    {
      "audio_url": "https://storage.soundverse.ai/x-one/.../.../extended_song_v1.mp3",
      "song_name": "Extended Song",
      "licenses": {
        "licenses": "Royalty Free"
      }
    },
    {
      "audio_url": "https://storage.soundverse.ai/x-one/.../.../extended_song_v2.mp3",
      "song_name": "Extended Song",
      "licenses": {
        "licenses": "Royalty Free"
      }
    }
  ],
  "ai_reply": "Your song has been extended successfully."
}

Possible Errors

Rate Limit Exceeded:

{
  "success": false,
  "message": "Rate limits have been passed for the user."
}

Insufficient Balance:

{
  "success": false,
  "message": "Insufficient balance for this operation."
}

Invalid Prompt:

{
  "detail": "Invalid or empty prompt provided"
}

NSFW Content Detected:

{
  "success": false,
  "message": "NSFW words detected. Please try again with different lyrics."
}

Service Unavailable:

{
  "success": false,
  "message": "Service temporarily unavailable. Please try again in a moment.",
  "error": "Database connection pool exhausted"
}

Get Started

Frequently Asked Questions

Creating with Soundverse

Exploring Soundverse

Account Management

Enterprise Platform

API Documentation

Extend Song - v5

🚀 apiv2 is live!

Extend AI Song (v5)

Endpoints

Request Parameters

Example Request

Code Examples - Streaming

Code Examples - Synchronous

Streaming Response

Fields

Synchronous Response

Sample Synchronous Output

Possible Errors

🚀 apiv2 is live!

​Extend AI Song (v5)

​Endpoints

​Request Parameters

​Example Request

​Code Examples - Streaming

​Code Examples - Synchronous

​Streaming Response

​Fields

​Synchronous Response

​Sample Synchronous Output

​Possible Errors

Extend AI Song (v5)

Endpoints

Request Parameters

Example Request

Code Examples - Streaming

Code Examples - Synchronous

Streaming Response

Fields

Synchronous Response

Sample Synchronous Output

Possible Errors