Music

ShortGenius also provides an AI-curated music catalog to serve as background tracks for your videos. You can explore various genres and pick specific tracks to add life to your video content.

List Music Genres

Endpoint: GET /music/genres

Retrieve the full list of available music genres. Each genre may include recommended locales where that genre is particularly popular.

curl --request GET \
  --url "https://shortgenius.com/api/v1/music/genres" \
  --header "Authorization: Bearer YOUR_API_TOKEN"

Sample Response:

[
  {
    "name": "Classical",
    "recommended_for_locales": [
      "de-DE",
      "fr-FR",
      "en-US"
    ]
  },
  {
    "name": "Jazz",
    "recommended_for_locales": [
      "en-US",
      "fr-FR"
    ]
  },
  ...
]

Response Fields

Field	Description
name	The name of the genre (e.g., "Classical").
recommended_for_locales	Array of locales where the genre is particularly popular.

---

List Music in a Genre

Endpoint: GET /music/genres/{id}

Use the genre’s name or unique ID returned by GET /music/genres to list specific tracks.

curl --request GET \
  --url "https://shortgenius.com/api/v1/music/genres/Classical" \
  --header "Authorization: Bearer YOUR_API_TOKEN"

Sample Response:

[
  {
    "id": "73f3cd22-bd13-4ec1-a675-82de290c598f",
    "name": "Moonlight Sonata (Excerpt)",
    "preview_url": "https://cdn.shortgenius.com/music/73f3cd22-preview.mp3"
  },
  {
    "id": "ee13c403-6503-49c4-9ff8-a9a45eb558bb",
    "name": "Fur Elise (Excerpt)",
    "preview_url": "https://cdn.shortgenius.com/music/ee13c403-preview.mp3"
  },
  ...
]

Response Fields

Field	Description
id	Unique ID of the track (for use in /videos or /series).
name	Track title (may be partial or excerpt).
preview_url	Direct link to a short preview audio clip of the track.

---

Using Music in Videos

After identifying a suitable track’s id, simply include it in your request to create or update a video:

{
  "soundtrack_id": "73f3cd22-bd13-4ec1-a675-82de290c598f",
  "soundtrack_volume": 80,
  "soundtrack_playback_rate": 120
}

ShortGenius will overlay this music behind your AI-generated voice and scenes, producing a fully scored video.

---

Next Steps

Now that you can add background music:

1. Check out Connections & Publishing to learn how to publish your videos.
2. Monitor your Usage & Credits so you always have enough resources to generate new music-backed projects.