VideoDB icon

VideoDB

Interact with the VideoDB API

Overview

This node integrates with the VideoDB API to generate custom video streams from a selected video within a collection. It allows users to specify segments of the video timeline to create a tailored stream, which is useful for extracting highlights or specific parts of longer videos.

Common scenarios include:

  • Creating highlight reels by specifying multiple time ranges.
  • Generating short clips from longer videos for social media sharing.
  • Extracting relevant segments for review or analysis without downloading entire videos.

For example, a user can select a video from their collection and define a timeline like [[0, 10], [30, 40]] to generate a stream consisting of the first 10 seconds and another segment from 30 to 40 seconds.

Properties

Name Meaning
Collection Name or ID Choose a video collection from a list or specify its ID.
Video Name or ID Select a video within the chosen collection by name or ID.
Timeline JSON array defining start and end times for segments to include in the generated stream. Example: [[0, 10], [20, 30]].
Length The total length (in seconds) of the video stream to generate.

Output

The node outputs JSON data representing the response from the VideoDB API for the generated video stream. This typically includes metadata about the created stream or a URL/identifier to access the generated video content.

If the node supports binary data output (not explicitly shown in the code), it would represent the actual video stream data or a downloadable file reference.

Dependencies

  • Requires an API key credential for authenticating with the VideoDB API.
  • The base URL for the API defaults to https://api.videodb.io but can be customized via credentials.
  • Uses HTTP requests with authentication to interact with the VideoDB endpoints.

Troubleshooting

  • Invalid Collection or Video ID: If the selected collection or video ID does not exist or is incorrect, the API will likely return an error. Verify IDs are correct and accessible.
  • Authentication Errors: Missing or invalid API key will cause authentication failures. Ensure the API key credential is properly configured.
  • Malformed Timeline JSON: The timeline property must be valid JSON representing an array of [start, end] pairs. Invalid JSON or out-of-range times may cause errors.
  • Network Issues: Connectivity problems to the VideoDB API endpoint will result in request failures. Check network settings and API availability.

Links and References

Discussion