VideoDB icon

VideoDB

Interact with the VideoDB API

Overview

This node integrates with the VideoDB API to perform various operations related to video, audio, and image collections. Specifically, the "Generate Image" operation allows users to create an image based on a textual prompt within a specified collection. This is useful for automating creative workflows where images need to be generated dynamically from descriptions, such as content creation, marketing materials, or prototyping visual concepts.

For example, a user might select a collection of image templates and generate new images by providing descriptive prompts and choosing an aspect ratio, optionally receiving a callback URL notification when the generation completes.

Properties

Name Meaning
Collection Name or ID Select an existing collection by name or ID where the image will be generated.
Prompt Text description used to generate the image.
Aspect Ratio Choose the aspect ratio of the generated image. Options: 1:1, 16:9, 3:4, 4:3, 9:16
Callback URL Optional URL to receive a callback notification once the image generation is complete.

Output

The node outputs JSON data containing the response from the VideoDB API after requesting image generation. This typically includes metadata about the generated image(s), such as IDs, URLs, status, or other relevant details returned by the API.

If the API supports asynchronous processing, the callback URL can be used to notify when the image is ready, but this node's output immediately reflects the API response to the generation request.

No binary data output is indicated in the source code.

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.
  • The node uses HTTP requests with authentication to communicate with the VideoDB service.

Troubleshooting

  • Invalid Collection ID: If the selected collection does not exist or is invalid, the API may return an error. Verify the collection ID or use the provided load options to select a valid collection.
  • Authentication Errors: Missing or incorrect API key will cause authentication failures. Ensure the API key credential is correctly configured.
  • Prompt Issues: An empty or malformed prompt may result in errors or no image generation. Always provide a meaningful prompt string.
  • Callback URL Problems: If using a callback URL, ensure it is reachable and correctly handles incoming notifications; otherwise, you may miss completion events.
  • API Rate Limits or Downtime: The external VideoDB API may impose rate limits or experience downtime, causing request failures. Check API status and usage limits.

Links and References

Discussion