List Music

`GET /music`

Returns a paginated list of available background music tracks. Use the name value when creating shorts with the musicName parameter to select a specific track.

Available tracks

Click any track to preview it.

Query parameters

Parameter	Type	Default	Description
`page`	number	`1`	Page number (starting from 1)
`limit`	number	`20`	Items per page (1–100)

Request

curl -H "X-API-Key: sk_ssemble_your_key" \
  "https://aiclipping.ssemble.com/api/v1/music?page=1&limit=20"

Response

{
  "data": {
    "music": [
      {
        "name": "Arms Dealer",
        "duration": 90
      },
      {
        "name": "Blade Runner",
        "duration": 216
      },
      {
        "name": "Feeling Blue",
        "duration": 107
      },
      {
        "name": "Hell n Back",
        "duration": 214
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "totalPages": 3,
      "totalCount": 45
    }
  }
}

Response fields

Music object

Field	Type	Description
`name`	string	Track name. Use this exact value as `musicName` in `POST /shorts/create`.
`duration`	number	Track duration in seconds

Pagination object

Field	Type	Description
`page`	number	Current page number
`limit`	number	Items per page
`totalPages`	number	Total pages available
`totalCount`	number	Total number of music tracks

Using music in shorts

To add background music to your shorts, set music: true in your create request. You can optionally specify a track name and volume level.

With a specific track

{
  "url": "https://www.youtube.com/watch?v=...",
  "start": 0,
  "end": 600,
  "music": true,
  "musicName": "Blade Runner",
  "musicVolume": 15
}

With a random track

If you omit musicName, a random track from the library is selected:

{
  "url": "https://www.youtube.com/watch?v=...",
  "start": 0,
  "end": 600,
  "music": true,
  "musicVolume": 10
}

Controlling volume

The musicVolume parameter (0–100) controls how loud the background music is relative to the original audio:

Volume range	Effect
0–10	Very subtle — barely noticeable background
10–20	Light ambiance — enhances without distracting
20–40	Balanced — clearly audible alongside speech
40–60	Prominent — music is the primary audio
60–100	Loud — speech may be hard to hear

Default volume is 10, which works well for most content.

Browsing all tracks

To see all available tracks, paginate through the full list:

async function getAllMusic(apiKey) {
  const allTracks = [];
  let page = 1;
  let totalPages = 1;
 
  while (page <= totalPages) {
    const response = await fetch(
      `https://aiclipping.ssemble.com/api/v1/music?page=${page}&limit=100`,
      { headers: { 'X-API-Key': apiKey } }
    );
    const { data } = await response.json();
 
    allTracks.push(...data.music);
    totalPages = data.pagination.totalPages;
    page++;
  }
 
  return allTracks;
}

Error responses

Status	Code	When
400	`invalid_request`	Invalid pagination parameters (e.g., `page=0`, `limit=200`)
401	`invalid_api_key`	Missing or invalid API key
429	`rate_limit_exceeded`	Too many requests

Notes

The music library is curated by Ssemble and may be updated over time with new tracks.
Track names are case-sensitive when used in POST /shorts/create.
If a musicName doesn't match any track in the library, the API returns a 400 error with code invalid_request.
Music is mixed with the original video audio — it doesn't replace it. Use musicVolume to control the balance.

On this page