Overview
This node generates videos using various AI-powered modes and customization options. It supports creating simple narrated videos, multi-character scene-based videos, or videos featuring an AI avatar presenter. Users can specify scripts, voices, visual styles, aspect ratios, animations, subtitles, background music, and more.
Common scenarios include:
- Creating marketing or explainer videos with a single narrator voice.
- Producing storytelling or dialogue-driven videos with multiple characters.
- Generating professional presentations or tutorials using AI avatars.
- Customizing video appearance and audio to match brand style or target audience.
Practical examples:
- A product demo video narrated by a chosen voice in English or other languages.
- An educational video with different character voices acting out scenes.
- A corporate presentation video featuring an AI avatar presenter with background music and subtitles.
Properties
| Name | Meaning |
|---|---|
| Video Mode | Mode of video generation: Single Voice (one narrator), Scenes (multi-character with scenes), Avatar (AI avatar presenter). |
| Video Script | The script text for the video. For scenes mode, use special formatting with character names and scene blocks. |
| Quality Tier | Quality level: Basic or Premium (premium supports custom visual styles). |
| Language | Language for narration (e.g., English, Spanish, French, German, etc.). |
| Country | Target country for voice/content localization (e.g., US, ES, FR, DE, etc.). |
| Aspect Ratio | Video orientation: 16:9 (landscape) or 9:16 (portrait). |
| Animation Type | Animation style: Moving Image (Ken Burns effect) or AI Video (AI-generated animation; not compatible with scenes mode). |
| Voice | Narrator voice selection for single voice or avatar modes. Includes predefined voices and option for custom voice ID. |
| Custom Voice ID | Custom voice identifier (used if "Custom Voice ID" is selected as voice). |
| Voice Style | Speaking style of narration: Narrative, Expressive, or Dynamic. |
| Voice Speed | Speed of narration: Standard, Fast, or Very Fast. |
| Character Voices | For scenes mode: mapping of character names to voice IDs (required). |
| Media Type | Source of images/media: AI-generated images, Google image search, or custom images. |
| Visual Style | Style for AI-generated images (photorealistic, comic, anime, retro, etc.). Only applies if media type is AI image. |
| Custom Style ID | Custom visual style ID (premium tier only, when style is set to custom). |
| Images Per Minute | Number of images generated per minute of video (range 8-40). Not applicable for custom images. |
| Custom Image URLs | List of URLs for custom images (required if media type is custom image). |
| Avatar | Selection of AI avatar presenter for avatar mode, including option for custom avatar ID. |
| Custom Avatar ID | Custom avatar identifier (used if "Custom Avatar ID" is selected). |
| Avatar Layout | Layout style for avatar mode: Full Screen (avatar only) or Combined (avatar plus media content). |
| Avatar Layout Style | Style for combined avatar layout (split screen, overlay, corner overlay, presentation). Only for combined layout. |
| Avatar Layout Options | Additional options for presentation layout style: perspective effect toggle and background ID selection. |
| Add Subtitles | Whether to add subtitles/captions to the video. |
| Caption Font | Font family for subtitles, including many standard fonts and option for custom font URL. |
| Caption Font URL | URL for custom font file (if custom font is selected). |
| Caption Alignment | Position alignment of captions: top, middle, bottom, etc. |
| Subtitle Highlight Color | Color used to highlight words in subtitles (various color options or none). |
| Subtitle Stroke Width | Stroke width of subtitle text: hidden, light, standard, heavy. |
| Subtitle Highlight Mode | Mode of subtitle highlighting: background behind text or colored text. |
| Add Background Music | Whether to add background music to the video. |
| Background Music | Selection of background music track, including option for custom music ID. |
| Custom Music ID | Custom background music identifier (used if "Custom Music ID" is selected). |
Output
The node outputs JSON data containing details about the generated video. This typically includes URLs or identifiers for the created video file(s), status information, and metadata such as duration or resolution.
If binary data output is supported, it would represent the actual video file content or related media assets.
Dependencies
- Requires access to Vuela.ai API services for video generation.
- Needs an API key credential configured in n8n for authentication with the external service.
- Internet connectivity to fetch AI-generated images, voices, avatars, and background music.
- Optional: Access to Google Image Search if that media type is selected.
Troubleshooting
- Invalid Script Format: For scenes mode, ensure the script uses correct formatting with character names and scene blocks. Errors may occur if the format is incorrect.
- Unsupported Animation with Scenes: AI Video animation type is incompatible with scenes mode; selecting this combination may cause errors.
- Missing Required Fields: Properties like voice ID, avatar ID, or custom IDs must be provided when their respective "custom" options are selected.
- API Authentication Failures: Ensure the API key credential is valid and has necessary permissions.
- Media Generation Limits: The number of images per minute must be within allowed range (8-40); exceeding limits may cause failures.
- Custom Fonts or Styles: When using custom font URLs or style IDs, verify that the URLs/IDs are correct and accessible.
- Background Music Issues: If adding background music, ensure the selected music ID or custom music ID is valid.
Links and References
- Vuela.ai Official Website
- Documentation on video script formatting and scene scripting (refer to Vuela.ai docs)
- Guides on voice and avatar customization at Vuela.ai
- n8n documentation on setting up API credentials and HTTP request nodes