Fal.ai video Generator

Fal.ai video Generator lets you turn a set of images or a single image into a short video.
You provide a prompt, choose a model, and the component talks to the fal.ai API to create the video. The result can be used right away in your workflow or sent to another tool.

How it Works

When you run the component, Nappai collects all the input values you set (image files, prompt, duration, etc.) and builds a request to the fal.ai API.
fal.ai processes the request, generates the video frames, and returns a video file.
Nappai then stores that file as a Data object and also creates a Tool that can be used by other components in the workflow.

Inputs

Mapping Mode

This component has a special mode called Mapping Mode. When you enable this mode using the toggle switch, an additional input called Mapping Data is activated, and each input field offers you three different ways to provide data:

Fixed: You type the value directly into the field.
Mapped: You connect the output of another component to use its result as the value.
Javascript: You write Javascript code to dynamically calculate the value.

This flexibility allows you to create more dynamic and connected workflows.

Credential
This component requires a Fal.ai API credential.

First, add a Fal.ai API credential in the Credentials section of Nappai.
Then, in the component, select that credential in the Credential field.

Input Fields

Image Files: The list of image files (URL or File Id) to use for image generation.
Aspect Ratio: The aspect ratio of the generated video.
Duration (seconds): The duration of the video in seconds (varies by model).
Generate Audio: Generate audio for the video.
Generation Mode: Mode of video generation.
Image URL: The URL of the image to edit.
Mapping Mode: Enable mapping mode to process multiple data records in batch.
Video Model: The Fal.ai model to use for video generation.
Negative Prompt: What you don’t want in the video (supported by some models).
Prompt: A text description of the desired video. The maximum length varies by model.
Resolution: Resolution of the generated video.
Model Specific Parameters: Parameters specific to each model. See model documentation for details. https://fal.ai/models
Tool Description: Description of the tool to be used for the image generation.
Example default value:
```
Generates images using size, quality, and generation parameters
```
Tool Name: Tool name to be used for the image generation.
Tools arguments metadata: Defines the arguments metadata for the tools.

Outputs

Video: A Data object containing the generated video (method: generate_video).
Tool: A Tool object that can be passed to other components (method: to_toolkit).

Usage Example

Add the component to your workflow.
Configure the credential: In the Credential field, choose the Fal.ai API credential you created earlier.
Set the inputs:
- Image Files: Drag and drop a set of images or provide URLs.
- Prompt: “A sunny beach with waves crashing.”
- Video Model: “fal-ai-video-1.0”.
- Duration (seconds): 10.
- Resolution: “1080p”.
Run the workflow.
The component will return a Video output that you can feed into a Video Player component or store in your data repository.

FalAiImageGenerator – Create still images from prompts.
FalAiTextToVideo – Generate videos directly from text prompts.

Tips and Best Practices

Keep the Prompt concise; longer prompts may be truncated by the model.
Choose a Video Model that matches your desired style and resolution.
If you need background music, enable Generate Audio.
Use Mapping Mode to batch‑process multiple images or prompts in one run.
Test with a short Duration first to verify the output before scaling up.

Security Considerations

The Fal.ai API key is stored securely in Nappai’s credential store.
Never expose the API key in public workflows or share the credential with untrusted users.
Use the Credential field to ensure the key is only used by authorized components.