Overview
This node integrates with the Blotato API to create videos from predefined templates. Specifically, the Video - Create operation allows users to generate a video by selecting a template and providing the required input fields for that template. This is useful in scenarios where automated video generation is needed based on dynamic data, such as marketing videos, social media content, or personalized video messages.
For example, a marketing team could use this node to automatically create promotional videos by selecting a branded template and filling in product details dynamically from a CRM or database.
Properties
| Name | Meaning |
|---|---|
| Template | The video template to use for creating the video. Can be selected from a searchable list or specified by ID. |
| Template Inputs | A mapping of input fields required by the selected template. These inputs define the dynamic content to populate the template (e.g., text, images, options). |
Output
The output JSON contains the response from the Blotato API after attempting to create the video. It typically includes:
- Details about the created video, such as its ID, status, and metadata.
- If the video is still processing (status like "generating-script", "script-ready", or "queueing"), a hint message is included advising the user to wait longer and check credits.
- In case of errors, the output will contain error information.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Blotato API.
- The node uses the Blotato API endpoints related to video templates and video creation.
- The API server URL is obtained from the configured credentials.
- The node relies on helper methods to fetch available templates and their input schemas dynamically.
Troubleshooting
- Missing or invalid Template ID: If the template ID is not provided or invalid, the node will fail to retrieve the template schema, resulting in empty or error fields.
- Invalid JSON in Template Inputs: Input fields that are strings but represent JSON arrays or objects must be valid JSON. Invalid JSON will cause warnings and may lead to incorrect input mapping.
- Video still processing: When fetching a video by ID, if the video is not yet ready, the node returns a warning hint. Users should wait until the video status changes to a completed state.
- API errors: Network issues, authentication failures, or quota limits can cause API errors. The node surfaces these errors clearly, and users should verify API credentials and usage limits.
- Required fields: The template inputs marked as required must be provided; otherwise, the API may reject the request.