n8n community node for fal.ai AI model APIs
npm install n8n-nodes-falThis is an n8n community node that lets you integrate fal.ai AI model APIs into your n8n workflows.
fal.ai is a platform for running AI models with fast inference, supporting text-to-image, image-to-video, and other generative AI capabilities.
n8n is a fair-code licensed workflow automation platform.
Follow the installation guide in the n8n community nodes documentation.
1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-fal in Enter npm package name
4. Agree to the risks of using community nodes
5. Select Install
To get started install the package in your n8n root directory:
``bash`
npm install n8n-nodes-fal
- Generate: Generate images from text prompts using various AI models
- Multiple models available with different strengths
- Configurable aspect ratios and resolutions
- Optional negative prompts for better control
- Seed support for reproducible results
- Batch generation support
- Generate: Generate videos from text prompts using AI models
- Multiple models with different capabilities
- Various aspect ratios and resolutions
- Duration options
- Optional audio generation
- Advanced prompt controls
- Generate Video: Convert images to videos using AI models
- Multiple models for different use cases
- Single image animation
- Multiple reference images support
- First-last frame animation
- Configurable aspect ratios, durations, and resolutions
- Generate: Convert text to speech using AI models
- Multiple voice options
- Language support
- Adjustable speech parameters (stability, similarity, style, speed)
- Optional timestamps
To use this node, you'll need a fal.ai API key:
1. Sign up for a free account at fal.ai
2. Navigate to your API Keys dashboard
3. Create a new API key or use an existing one
4. Copy the API key (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
1. Open your n8n instance
2. Go to Credentials → New
3. Search for Fal.ai API
4. Enter your API Key
5. Click Create
The credentials will be automatically tested by making a request to the fal.ai API.
1. Add the Fal.ai node to your workflow
2. Select Text to Image as the resource
3. Select Generate as the operation
4. Choose your preferred model from the dropdown
5. Fill in:
- Prompt: Your text description (e.g., "A beautiful sunset over mountains")
- Additional Options: Configure aspect ratio, resolution, etc. based on the selected model
1. Add the Fal.ai node to your workflow
2. Select Text to Video as the resource
3. Select Generate as the operation
4. Choose your preferred model from the dropdown
5. Fill in:
- Prompt: Your video description (e.g., "A time-lapse of clouds moving over a city")
- Configure duration, aspect ratio, and resolution options
1. Add the Fal.ai node to your workflow
2. Select Image to Video as the resource
3. Select Generate Video as the operation
4. Choose your preferred model from the dropdown
5. Fill in:
- Image URL: Publicly accessible image URL (or multiple URLs for reference models)
- Prompt: Animation description (e.g., "Camera slowly pans from left to right")
- Configure duration, aspect ratio, and resolution options
1. Add the Fal.ai node to your workflow
2. Select Text to Speech as the resource
3. Select Generate as the operation
4. Choose your preferred model from the dropdown
5. Fill in:
- Text: The text you want to convert to speech
- Voice: Select from available voice options
- Language: Choose the language
- Configure additional speech parameters as needed
All operations use fal.ai's queue system for reliable async processing:
- Requests are submitted to a queue
- The node polls the queue status every 5 seconds
- Maximum wait time: 20 minutes (suitable for video generation)
- Status updates are logged for visibility
The node handles all queue management automatically - you don't need to worry about polling or checking status manually.
You can chain multiple Fal.ai nodes together for complex workflows:
1. Text to Image → Generate an image from text
2. HTTP Request → Download/process the image if needed
3. Image to Video → Convert the generated image to video
4. Text to Speech → Add narration to your content
Example workflows:
- Text prompt → Image generation → Video animation
- Text → Speech generation → Combine with video
- Multiple images → Reference-based video generation
- ✅ Text to Image - Generate images from text prompts with multiple models
- ✅ Text to Video - Create videos directly from text descriptions
- ✅ Image to Video - Animate static images into videos
- ✅ Text to Speech - Convert text to natural-sounding speech
- ✅ Multiple models - Choose the best model for your specific use case
- ✅ Flexible parameters - Aspect ratios, resolutions, durations, and more
- ✅ Advanced controls - Negative prompts, seeds, style parameters
- ✅ Batch operations - Generate multiple outputs in a single request
- ✅ Reference-based generation - Use multiple reference images for consistency
- ✅ Automatic polling - No manual status checking required
- ✅ Status tracking - Real-time progress updates
- ✅ Error handling - Graceful failure management
- ✅ Timeout protection - Appropriate timeouts for long-running operations
- ✅ Retry logic - Built-in retry mechanisms
fal.ai uses a credit-based pricing system with the following characteristics:
- Free tier: Available for testing and development
- Credits: Purchase credits based on your usage
- Pricing: Varies by model and complexity
- Queue system: Ensures reliable processing during high load
- Failed requests: Can be retried using n8n's built-in error handling
For detailed pricing information, visit:
- fal.ai Pricing
- Model-specific pricing
For more details about the fal.ai API:
- fal.ai Documentation
- Queue API Guide
- Model Gallery
- n8n community nodes documentation
- fal.ai Documentation
- GitHub Repository
`bashInstall dependencies
npm install
Contributions are welcome! Please feel free to submit a Pull Request.
For issues, questions, or contributions, please visit the GitHub repository.
A community node for fal.ai
Readme
MIT license