Actions22
- Video Actions
- Avatar Actions
- Voice Actions
- Template Actions
- Product Actions
- AI Script Actions
- File Actions
- Visual Style Actions
- Webhook Actions
Overview
The Video - Generate Preview operation in this node allows users to create AI-generated video previews based on a product and customizable parameters. It is designed to automate the creation of short promotional or informational videos by specifying details such as aspect ratio, video length, language, script style, avatar presenter, visual styling, and voice options.
This operation is beneficial for marketers, content creators, and e-commerce businesses who want to quickly generate engaging video previews for products without manual video editing. For example, a user can input a product ID from a previous step, select a portrait aspect ratio, choose a 30-second video length, specify English language with a "Soft Selling" script style, pick an avatar and template, and generate a ready-to-use video preview that highlights the product features.
Properties
| Name | Meaning |
|---|---|
| Product ID | The unique identifier of the product for which the video preview will be generated. This ID should come from a prior "Create Product" step. |
| Aspect Ratio | The shape of the video frame. Options: Portrait [9:16], Landscape [16:9], Square [1:1]. |
| Video Length | Duration of the final video in seconds. Options: 15, 30, or 60 seconds. |
| Language | The language used for generating the video script. Supports many languages including English, French, German, Hindi, Japanese, Spanish, Arabic, Chinese (Simplified and Traditional), and more. |
| Script Style | The writing style for the video script. Options include various tones and formats such as "Don't Worry" (casual), "Discovery" (exploratory), "Data" (analytical), "Soft Selling", "Humor & Meme", "Expert Advice", etc. |
| Avatar Type | Source of the avatar presenting the video. Options: Public Avatars or Custom Avatars. |
| Avatar ID | Numeric ID selecting the specific avatar to use as the presenter. |
| Template Type | Source of the video template. Options: Template From Template Library (public) or Template From My Templates (custom). |
| Template ID | Optional numeric ID of the chosen template from the selected template library. |
| Visual Style | Optional string describing the visual style to apply, e.g., "Simple split screen template". |
| Voice ID | Optional ID of the voice to use for narration, e.g., "en-US-ChristopherNeural". |
| Override Script | Optional multiline text field to provide a custom script that overrides the one generated automatically based on the selected script style. |
| Show Captions | Boolean flag indicating whether subtitles should be rendered on the video. |
Output
The output JSON contains data representing the generated video preview. This typically includes metadata about the created video such as URLs or IDs referencing the video file, status information, and possibly additional details like captions or script text.
If the node supports binary data output, it would represent the actual video file or related media assets. However, based on the provided code and properties, the main output is structured JSON data describing the generated preview rather than raw binary video data.
Dependencies
- Requires an API key credential for authenticating requests to the JoggAI API.
- Depends on the external JoggAI service to perform video generation operations.
- The node expects prior steps to provide valid product IDs.
- Configuration of avatars, templates, voices, and visual styles must exist within the JoggAI platform or user account.
Troubleshooting
- Invalid Product ID: If the product ID is missing or incorrect, the API call will fail. Ensure the product ID comes from a successful "Create Product" step.
- Unsupported Language or Script Style: Selecting unsupported or misspelled options may cause errors. Use only the provided options.
- Avatar or Template Not Found: Using an invalid avatar or template ID will result in failure. Verify IDs exist in your JoggAI account.
- API Authentication Errors: Missing or invalid API credentials will prevent the node from working. Confirm the API key is correctly configured.
- Network Issues: Connectivity problems with the JoggAI API endpoint can cause timeouts or request failures.
- Override Script Format: If providing a custom script, ensure it is properly formatted and relevant to the product context.
Common error messages usually indicate these issues and can be resolved by verifying inputs, credentials, and network connectivity.
Links and References
- JoggAI Documentation (placeholder URL, replace with actual documentation link)
- n8n Documentation on Creating Custom Nodes
- General info on Video Marketing Best Practices
Note: This summary is based solely on static analysis of the provided source code and property definitions.