Soundtrack a video
Endpoints that power the Soundtrack a video flow. Together they upload a video, return a ranked list of matching tracks, and (optionally) render the final mixed video.
Endpoints
| Method | Path | Purpose |
|---|---|---|
POST | /api/v4/soundtrack/video/ | Upload a video file or submit a YouTube URL |
GET | /api/v4/soundtrack/video/{id}/ | Retrieve a previously uploaded video |
GET | /api/v4/search/ai/by-video/ | Find tracks that match the video |
POST | /api/v4/soundtrack/video/{id}/download/ | Render and download the video with a chosen track mixed in |
For the conceptual flow and a step-by-step guide, see Soundtrack a video.
The SoundtrackVideo object
{
"id": "8a4b2c1d-9e7f-4a6b-b3c2-1f8d4e5a7c6b",
"source_type": "file",
"source_value": "5f3e7d9c8b2a4f1e6d0c5b8a3e2f7d9c",
"source_title": "clip.mp4",
"file": "https://media.slipstreammusic.com/.../clip.mp4"
}| Field | Description |
|---|---|
id | UUID of the video. Use this in retrieve and download paths. |
source_type | "file" for uploaded files, "youtube_url" for YouTube submissions. |
source_value | The AIMS hash for files, or the YouTube URL for links. Pass this as the value query parameter to Search by video. |
source_title | Filename for uploads, video title for YouTube. |
file | Public URL to the uploaded file. null for YouTube videos. |