Argil icon

Argil

Create engaging videos with Argil AI

Actions2

Overview

This node integrates with the Argil AI video creation platform to create and retrieve videos programmatically. It supports two main operations:

  • Create Video: Generate a new video using different input modes such as providing a transcript, converting an article URL into a video, or defining detailed moments (segments) manually.
  • Get Video: Retrieve information about an existing video by its ID.

The node is useful for automating video production workflows where you want to generate engaging videos from text content or articles without manual editing. For example, marketers can quickly create promotional videos from blog posts, educators can produce lecture videos from transcripts, and content creators can customize video segments with specific avatars and voices.

Properties

Name Meaning
Operation Choose between creating a new video or retrieving an existing one. Options: Create Video, Get Video.
Video ID The identifier of the video to retrieve (used only when operation is Get Video).
Creation Mode Method to create the video (used only when operation is Create Video):
- Transcript (Simple): Provide a single transcript; Argil automatically splits it into moments.
- Article to Video: Convert an article URL.
- Moments (Advanced): Define each moment individually.
Video Name Name assigned to the created video.
Avatar Select an avatar for the video (for transcript mode).
Split Intensity How the transcript is split into moments (for transcript mode):
- Dynamic: AI splits based on context.
- Normal: Splits at regular intervals.
Transcript Full transcript text for the video (for transcript mode).
Article Avatar Avatar selection for article-to-video mode.
Article URL URL of the article to convert into a video (for articleToVideo mode).
Format Video length for article-to-video mode:
- Short: Summary video.
- Long: Detailed video.
Instructions Optional instructions for processing the article (article-to-video mode).
Article Split Intensity How the article content is split (article-to-video mode), same options as transcript split intensity.
Moments Collection of moments (segments) for advanced mode, each with properties:
Avatar, Voice, Transcript, Gesture, Audio URL, Layout Type, Avatar Position.
Aspect Ratio Video format aspect ratio:
- 16:9 (Landscape)
- 9:16 (Portrait)
Enable Auto B-Rolls Enable automatic insertion of B-roll footage.
B-Roll Source Source of B-roll content:
- Generation
- Google Images
- Stock Videos
B-Roll Frequency Frequency of B-roll insertions:
- Low
- Medium
- High
B-Roll Layout Avatar layout style for B-roll moments:
- Auto
- Fullscreen
- Small
- Splitscreen
- Back
B-Roll Avatar Position Position of avatar during B-roll moments, varies depending on layout and aspect ratio.
Enable Subtitles Enable automatic subtitles in the video.
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 settings:
- 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 object returned by the Argil API. This includes:

  • Video metadata such as ID, name, status, and creation details.
  • Configuration used for the video (avatars, transcripts, moments, subtitles, B-rolls, background music).
  • If rendering is requested, additional fields include render response details, render status, and timing.
  • In case of errors during creation or rendering, error messages are included in the output.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for the Argil AI service.
  • Network access to https://api.argil.ai/v1.
  • The node uses several API endpoints:
    • /videos for creating videos.
    • /videos/{id} for retrieving video info and checking render status.
    • /videos/{id}/render for triggering video rendering.
    • Other endpoints to load options for avatars, voices, assets, and subtitle styles.

Troubleshooting

  • Common Issues:

    • Invalid or missing API key will cause authentication failures.
    • Providing invalid video IDs when retrieving videos will result in not found errors.
    • Incorrectly formatted inputs (e.g., empty transcript or invalid article URL) may cause API errors.
    • Rendering timeouts if the video takes too long to process.

  • Error Messages:

    • "Video rendering timeout after X minutes": Increase max wait time or check video complexity.
    • "Video rendering failed with status: FAILED": Check input content and retry.
    • "Video was moderated due to content policy violations": Review video content for prohibited material.
    • Network or API errors: Verify API key and network connectivity.

  • Resolution Tips:

    • Ensure all required parameters are provided according to the selected creation mode.
    • Use valid URLs and properly formatted transcripts.
    • Adjust polling intervals and max wait times based on expected rendering duration.
    • Handle errors gracefully by enabling "Continue On Fail" in n8n if needed.

Links and References

Discussion