LumaLabs

Generate videos using LumaLabs AI
Join our community

Actions2

Overview

This node integrates with the LumaLabs AI service to generate videos based on textual prompts. It is designed for creative workflows where users want to produce AI-generated video content automatically. The node supports generating new videos from prompts and checking the status of ongoing or completed video generations.

Common scenarios include:

  • Automatically creating marketing or social media videos from descriptive text.
  • Generating visual content for storytelling or presentations.
  • Automating video creation pipelines where waiting for completion or receiving callbacks is needed.

For example, a user can input a prompt describing a scene or concept, optionally specify parameters like aspect ratio or looping, and receive a generated video URL or ID. They can also choose to wait until the video generation completes or check the status later.

Properties

Name Meaning
Prompt The textual description used to generate the video.
Wait For Video Whether the node should wait for the video generation process to complete before continuing.
Maximum Wait Time The maximum time in seconds to wait for video generation if "Wait For Video" is enabled.
Additional Fields A collection of optional parameters:
- Negative Prompt Text describing elements to avoid in the generated video.
- Aspect Ratio The video's aspect ratio; options are "16:9", "9:16", or "1:1".
- Loop Whether the generated video should loop continuously (true/false).
- Callback URL A URL to receive asynchronous status updates about the video generation.
- Seed A numeric seed value to influence randomness in generation.

Output

The node outputs JSON data representing the video generation response from the LumaLabs API.

  • When generating a video, the output JSON includes details such as the video ID, current state (queued, processing, completed, or failed), and URLs or metadata related to the generated video.
  • If waiting for completion is enabled, the output will contain the final video generation result once done.
  • When checking video status, the output JSON reflects the current state and any relevant metadata of the specified video ID.

The node does not directly output binary video data but provides URLs or references to access the generated video.

Dependencies

  • Requires an API key credential for authenticating with the LumaLabs AI service.
  • Makes HTTP requests to the LumaLabs API endpoints at https://api.lumalabs.ai/dream-machine/v1/generations.
  • No additional environment variables are required beyond the API key credential.

Troubleshooting

  • Timeout Errors: If the video generation takes longer than the specified maximum wait time, the node throws a timeout error. To resolve, increase the "Maximum Wait Time" or disable waiting to handle asynchronously.
  • Generation Failures: If the API returns a failure state, the node reports the failure reason. Check the prompt and parameters for validity or try again later.
  • Authentication Issues: Ensure the API key credential is correctly configured and valid.
  • Network Errors: Verify network connectivity to the LumaLabs API endpoint.
  • Invalid Parameters: Make sure all required fields like "Prompt" are provided and that optional fields conform to expected types and values.

If "Continue On Fail" is enabled, errors will be returned as part of the output JSON instead of stopping execution.

Links and References

Discussion