Skip to main content

Create versions (Beta)

Beta Feature

This feature is currently in beta. The API may change based on feedback.

The edit versions feature allows you to generate a version of a track at any target duration between 1 second and 5 minutes. You can both shorten and lengthen tracks to fit a specific timeline duration. This is useful when you need a track to match a specific video length.

Creating extended versions: When you request a target duration longer than the source track, the API produces an extended musical arrangement up to the 5-minute ceiling.

Important: This is different from the "Adapt" feature on the Epidemic Sound website. Edit versions only adjust the track's duration—they do not change the mood, energy, or musical characteristics of the track.

How it works​

  1. Start a job: Use the start track versions endpoint to request an edited version of a track with your desired target duration. Specify durationMs in milliseconds (between 1000ms and 300000ms - 1 second to 5 minutes).

  2. Check job status: The job is processed asynchronously. Use the track versions status endpoint to check when it's complete.

  3. Get the result: When complete, the response includes URLs for both preview and high-quality versions of the edited track. Pass expand=waveform to include inline waveform data. URLs expire after 24 hours.

The high-quality URL (highQualityUrl) can be used directly to download the edited version — no separate download endpoint call is needed.

Performance note: Processing time scales with the target duration - a 5-minute request takes noticeably longer than a 15-second one. Consider this when setting user expectations for longer versions.