Actions2
Overview
This node integrates with the LumaLabs AI video generation service. It allows users to either generate new videos based on text prompts or check the status of previously requested video generations.
Common scenarios include:
- Automatically creating AI-generated videos from descriptive prompts for marketing, social media, or content creation.
- Monitoring the progress of video generation jobs to trigger subsequent workflows once videos are ready.
For example, a user can input a creative prompt describing a scene, and the node will request LumaLabs to generate a video matching that description. Alternatively, if a video ID is known, the node can retrieve the current processing status or final result of that video.
Properties
| Name | Meaning |
|---|---|
| Operation | Choose between "Generate Video" (create a new video) or "Get Video Status" (check status). |
| Prompt | Text prompt describing the video to generate (required for Generate Video operation). |
| Wait For Video | Boolean option to wait until video generation completes before continuing (Generate Video). |
| Maximum Wait Time | Maximum time in seconds to wait for video generation to complete (only if waiting). |
| Video ID | The unique identifier of the video to check status for (required for Get Video Status). |
| Additional Fields (for Generate Video): | Collection of optional parameters: - Negative Prompt: things to avoid in the video - Aspect Ratio: 16:9, 9:16, or 1:1 - Loop: whether the video should loop - Callback URL: URL to receive status updates - Seed: random seed number for generation |
Output
The node outputs JSON data representing the video generation response from the LumaLabs API.
For Generate Video:
- If waiting for completion, the output contains the full video generation object including its final state, URLs, and metadata.
- If not waiting, the output contains the initial generation request response with an ID to track later.
For Get Video Status:
- The output contains the current status and details of the specified video generation job.
The node does not output binary data; all information is provided as structured JSON.
Dependencies
- Requires an API key credential for authenticating with the LumaLabs AI service.
- Makes HTTP requests to
https://api.lumalabs.ai/dream-machine/v1/generationsendpoints. - No additional environment variables are needed beyond the API key configuration.
Troubleshooting
- Timeout Errors: When waiting for video generation, the node may throw a timeout error if the video takes longer than the specified maximum wait time. Increase the "Maximum Wait Time" property or disable waiting to avoid this.
- Generation Failures: If the video generation fails, the node throws an error with the failure reason returned by the API. Check the prompt and parameters for validity.
- Invalid Video ID: When checking status, providing an incorrect or non-existent video ID will cause an error. Verify the video ID before use.
- API Authentication Errors: Ensure the API key credential is correctly configured and has necessary permissions.
Links and References
- LumaLabs AI Documentation (hypothetical link)
- n8n HTTP Request Helper Documentation