Actions2
Overview
This node integrates with Argil AI to create and retrieve engaging videos using AI-driven content generation. It supports multiple creation modes:
- Transcript (Simple): Provide a full transcript, and the node automatically splits it into video moments.
- Article to Video: Convert an article URL into a video summary or detailed video.
- Moments (Advanced): Define each video segment ("moment") individually with specific avatars, voices, gestures, layouts, and audio.
Additionally, users can enable features like automatic B-roll insertion, subtitles, and background music to enhance the video output.
Typical use cases include:
- Automatically generating video content from text transcripts or articles for marketing, education, or social media.
- Creating personalized videos with custom avatars and voices.
- Enhancing videos with dynamic B-rolls and subtitles without manual editing.
Properties
| Name | Meaning |
|---|---|
| Operation | Choose between creating a new video or retrieving an existing one by ID. |
| Video ID | The identifier of the video to retrieve (used only when getting a video). |
| Creation Mode | Method to create the video: "Transcript (Simple)", "Article to Video", or "Moments (Advanced)". |
| Video Name | Name assigned to the created video. |
| Avatar | Select an avatar for the video (used in Transcript mode). |
| Split Intensity | How the transcript is split into moments: "Dynamic" (AI-based context splitting) or "Normal" (regular intervals). |
| Transcript | Full transcript text for the video (used in Transcript mode). |
| Article Avatar | Avatar selection for article-to-video mode. |
| Article URL | URL of the article to convert into a video (used in Article to Video mode). |
| Format | Video length preference for article conversion: "Short" (summary) or "Long" (detailed). |
| Instructions | Optional instructions guiding how the article should be processed. |
| Article Split Intensity | Split intensity for article content: "Dynamic" or "Normal". |
| Moments | Collection of individual video segments, each with customizable avatar, voice, transcript, gesture, audio URL, layout type, and avatar position (used in Moments mode). |
| Aspect Ratio | Video format: "16:9 (Landscape)" or "9:16 (Portrait)". |
| Enable Auto B-Rolls | Toggle automatic insertion of B-roll footage. |
| B-Roll Source | Source for B-roll content: "Generation" (AI-generated), "Google Images", or "Video" (stock videos). |
| B-Roll Frequency | Frequency of B-roll insertions: "Low", "Medium", or "High". |
| Layout | Avatar layout style for all moments: "Auto", "Fullscreen", "Small", "Splitscreen", or "Back". |
| Avatar Position | Position of the avatar on screen, varies depending on layout and aspect ratio. Options include "Left", "Right", "Top", "Bottom". |
| Enable Subtitles | Enable automatic subtitles generation. |
| Subtitle Style | Choose subtitle style from available options. |
| Subtitle Position | Position of subtitles: "Top", "Bottom", or "Centered". |
| Subtitle Size | Size of subtitles: "Small", "Medium", or "Large". |
| Enable Background Music | Add background music to the video. |
| Background Music | Select a background music asset. |
| Background Music Volume | Volume level for background music (range 0 to 1). |
| Additional Options | Extra settings including whether to render the video immediately after creation, wait for rendering completion, polling interval for status checks, and maximum wait time for rendering. |
Output
The node outputs JSON data representing the video resource returned by the Argil API. This includes:
- Video metadata such as ID, name, status, and creation details.
- Configuration used for video creation (avatars, transcripts, moments, subtitles, B-rolls, background music).
- If rendering is requested, additional fields about the render status, response, and timing.
- In case of errors during rendering, error messages are included in the output.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for Argil AI to authenticate requests.
- Uses Argil AI's REST API endpoints for avatars, voices, assets, subtitles, video creation, retrieval, and rendering.
- Network access to
https://api.argil.ai/v1is necessary. - n8n environment must have HTTP request capabilities and configured credentials for Argil API.
Troubleshooting
- API Authentication Errors: Ensure the API key credential is correctly set up and valid.
- Timeouts: Video creation and rendering requests have long timeouts (up to 5 minutes). Network issues or large videos may cause delays or failures.
- Rendering Failures: If rendering fails or times out, check the error message in the output. Possible causes include content moderation flags or server-side errors.
- Invalid Input Data: Missing required parameters like transcript, article URL, or moments configuration will cause errors.
- Polling Issues: When waiting for render completion, ensure polling interval and max wait time are reasonable to avoid premature timeout or excessive waiting.
- Avatar/Voice/Asset Loading: If loading options for avatars, voices, or assets fail, verify API connectivity and permissions.
Links and References
- Argil AI API Documentation (assumed official docs)
- n8n HTTP Request Node Documentation
- n8n Credential Management
If you need details on a specific creation mode or property usage, feel free to ask!