Actions2
Overview
This node integrates with Argil AI to create and retrieve engaging videos using AI-driven content generation. It supports two main operations:
- Create Video: Generate a new video from various input modes such as a transcript, an article URL, or detailed "moments" (segments) with specific settings.
- Get Video: Retrieve details of an existing video by its ID.
Typical use cases include automating video creation for marketing, educational content, social media posts, or converting articles into video summaries. For example, you can provide a full transcript and let the AI split it into meaningful segments with avatars and voices, or convert a news article URL into a short summary video automatically.
Properties
| Name | Meaning |
|---|---|
| Operation | Choose between creating a new video (Create Video) or retrieving an existing one by ID (Get Video). |
| Video ID | The unique identifier of the video to retrieve (required for Get Video operation). |
| Creation Mode | Method to create a video when using Create Video: - Transcript (Simple): Provide a single transcript; AI splits it into moments. - Article to Video: Convert an article URL into a video. - Moments (Advanced): Define each video segment manually. |
| Video Name | Name assigned to the created video. |
| Avatar | Select an avatar character for the video (used in transcript mode). |
| Split Intensity | How the transcript is split into moments: - Dynamic: AI splits based on context. - Normal: Splits at 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 (article-to-video mode). |
| Format | Video length for article-to-video: - Short: Summary video. - Long: Detailed video. |
| Instructions | Optional instructions guiding how to process the article content. |
| Article Split Intensity | How the article content is split: - Dynamic: AI-based contextual splitting. - Normal: Regular interval splitting. |
| Moments | Collection of individual video segments, each with options: - Avatar - Voice - Transcript text - Gesture - Audio URL override - Layout type and position |
| Aspect Ratio | Video format: - 16:9 (Landscape) - 9:16 (Portrait) |
| Enable Auto B-Rolls | Enable automatic insertion of B-roll footage. |
| B-Roll Source | Source for B-roll content: - Generation (AI-generated) - Google Images - Stock Videos |
| B-Roll Frequency | Frequency of B-roll insertions: - Low - Medium - High |
| B-Roll Layout | Avatar layout style during B-rolls: - Auto - Fullscreen - Small - Splitscreen - Back |
| B-Roll Avatar Position | Position of avatar during B-rolls: - Left, Right, Bottom, Top (depending on layout and aspect ratio) |
| Enable Subtitles | Enable automatic subtitles display. |
| Subtitle Style | Choose subtitle style. |
| Subtitle Position | Position of subtitles: - Top - Bottom - Centered |
| Subtitle Size | Size of subtitles: - Small - Medium - Large |
| Enable Background Music | Add background music to the video. |
| Background Music | Select background music asset. |
| Background Music Volume | Volume level for background music (0 to 1). |
| Additional Options | Extra controls: - Render Video immediately after creation. - Wait until rendering completes. - Polling interval for status checks. - Maximum wait time for rendering completion. |
Output
The node outputs JSON data representing the video resource returned by the Argil API.
- For Get Video, it returns the video details fetched by ID.
- For Create Video, it returns the newly created video object including its ID and metadata.
- If rendering is requested, the output includes render response details and optionally the final rendered video status.
- In case of errors during creation or rendering, the output contains error messages describing the failure.
The output JSON structure corresponds directly to the Argil API's video resource schema, including fields like video ID, status, configuration, and rendering info.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for Argil AI to authenticate requests.
- Uses Argil AI REST API endpoints under
https://api.argil.ai/v1. - Network access to Argil API must be available.
- The node uses n8n helper methods for HTTP requests and credential management.
Troubleshooting
Common issues:
- Invalid or missing API key will cause authentication failures.
- Providing an incorrect video ID for retrieval results in not found errors.
- Rendering may timeout if the video takes too long to process.
- Content moderation may block video rendering if policy violations are detected.
Error messages:
"Video rendering timeout after X minutes": Increase max wait time or check video complexity."Video rendering failed with status: FAILED": Inspect video content or retry."Video was moderated due to content policy violations": Review content for compliance.- Network or API errors: Verify API key validity and network connectivity.
To handle errors gracefully, enable "Continue On Fail" in the node settings.
Links and References
- Argil AI Documentation (general reference for API capabilities)
- Argil API Reference (for detailed API endpoint info)
- n8n documentation on Creating Custom Nodes