VideoDB icon

VideoDB

Interact with the VideoDB API

Overview

This node integrates with the VideoDB API to perform various operations related to video, audio, image, and collection management. Specifically, the "Generate Image URL" operation allows users to retrieve a direct URL for an image stored within a specified collection in the VideoDB service.

Common scenarios where this node is beneficial include:

  • Automating workflows that require fetching media URLs dynamically from a managed video/image database.
  • Integrating VideoDB-hosted images into content management systems or marketing automation tools.
  • Building pipelines that process or display media assets by referencing their URLs without manual lookup.

For example, a user can select a collection and an image within it, then generate the image's URL to embed in a website or send via email campaigns.

Properties

Name Meaning
Collection Name or ID Select a collection from the list or specify its ID using an expression. This identifies the group of images to work with.
Image Name or ID Select an image from the chosen collection or specify its ID using an expression. This identifies the specific image to generate the URL for.

Output

The node outputs a JSON object containing the response from the VideoDB API for the requested operation. For the "Generate Image URL" operation, the output JSON includes the direct URL of the selected image.

Example output structure (simplified):

{
  "url": "https://cdn.videodb.io/images/abc123.jpg",
  "id": "abc123",
  "name": "Sample Image"
}

If the node supports binary data output (not explicitly shown here), it would typically represent the actual media file; however, in this case, the node returns metadata including the image URL rather than the binary image itself.

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 VideoDB endpoints.
  • The node depends on n8n's built-in HTTP request helper methods and credential management.

Troubleshooting

  • Missing or invalid API key: The node requires a valid API key credential. Errors related to authentication usually indicate missing or incorrect credentials. Verify the API key and ensure it has proper permissions.
  • Invalid collection or image ID: Selecting or specifying a non-existent collection or image ID will result in errors or empty responses. Use the provided dropdowns or verify IDs carefully.
  • Network issues: Connectivity problems to the VideoDB API endpoint may cause timeouts or failures. Check network access and proxy settings if applicable.
  • Unexpected API response: If the API changes or returns unexpected data, the node might fail. Review the API documentation and update the node or credentials accordingly.

Links and References

Discussion