If you’ve dreamed of turning a single prompt into a polished, long-form video—automatically—this guide will show you how to do it inside n8n using Scrptly. Scrptly is an AI Video Agent that turns your prompts into ads, product showcases, anime, or short films. With its native n8n integration, you can automate entire video pipelines for ecommerce, faceless YouTube channels, educational explainers, mini-docs, and more.
What you’ll learn in this guide:
- How to install and authenticate the Scrptly n8n node
- How to design a robust workflow for long-form AI video generation
- Proven prompt templates and best practices for character and scene consistency
- Tips for scaling, error handling, and downstream publishing
Learn more or get started: https://scrptly.com/
Why Scrptly + n8n for long-form AI video automation
Scrptly’s swarm of specialized AI sub-agents—research, screenplay, character design, narration, and editing—work together to produce cohesive videos from a single prompt plus optional context images. This is especially powerful for longer content, where character and environment consistency are crucial.
Key advantages:
- Long-form reliability: Excellent character and environment consistency across scenes.
- One-prompt simplicity: Provide a detailed prompt and optional context images—Scrptly handles the rest.
- Automation ready: Native n8n node, plus an API and MCP server for agent-to-agent orchestration.
- Scalable: Use the n8n node in scheduled, webhook-triggered, or data-driven workflows.
Start here: https://scrptly.com/
Prerequisites
- An n8n instance (self-hosted or cloud)
- A Scrptly account and API key from your account page: https://scrptly.com/
Optional but helpful:
- Product images or brand assets to use as context images for consistency
- A content calendar source (Google Sheet, CMS, database) to feed topics, scripts, or metadata
Step 1: Install the Scrptly n8n node
1) In n8n, go to Settings > Community Nodes > Install New
2) Search for: n8n-nodes-scrptly
3) Click Install
Source and docs: https://github.com/ybouane/n8n-nodes-scrptly
Step 2: Add credentials
1) In the n8n editor, open the Credentials tab
2) Create New Credential > Scrptly API
3) Paste your Scrptly API key and Save
Step 3: Blueprint for a long-form video workflow
Here’s a robust pattern you can adapt for ecommerce, documentaries, or faceless channels:
- Trigger (Schedule or Webhook)
- Data Prep (HTTP Request or Google Sheets): Fetch topic, product details, or research notes
- Transform (Set or Function): Build a structured prompt and gather context image URLs
- Scrptly (Generate Video): Provide prompt, context images, and budget
- Wait/Async Handling: Either wait for completion or poll task status (if configured)
- Post-Process: Upload to storage, send to a CMS, or publish to social platforms
- Notify/Log: Send a Slack/Email notification and persist the video URL and metadata
Step 4: Configure the Scrptly node
In your workflow, add the Scrptly node and set these fields:
- Prompt: A thorough description of your video—story arc, style, length, aspect ratio, key scenes, tone, and CTA.
- Context Images (optional): Brand/product images, character references, or environment stills to ensure consistency.
- Approve Up To: Maximum token budget (default 10,000) to control complexity/cost.
- Wait For Completion: On to block until the video is ready; off to return immediately with a task ID for polling.
Tip: For long-form content, lean on context images to lock character and environment consistency. This is where Scrptly shines.
Prompt templates for long-form videos
Use these as starting points and adapt per niche.
1) Ecommerce documentary-style product story (3–6 minutes)
"Create a cinematic mini-documentary about the journey from raw material to finished product. Focus on tactile close-ups, macro textures, and transitions from workshop ambiance to studio showcase. Introduce a recurring artisan character who appears across scenes. Maintain a warm, natural color grade, steady camera, soft ambient sound design, and a calm voiceover. Integrate product close-ups based on provided context images. End with a clear CTA to learn more. Format: 16:9, YouTube-ready."
2) Faceless YouTube explainer (5–10 minutes)
"Produce a structured explainer with a hook, three chapters, and a summary. Keep on-screen text minimal and rely on smooth cutaways and simple motion graphics. Maintain consistent visual motifs and recurring background environment. Include a friendly but authoritative narration. Insert subtle section bumpers every 90 seconds. Close with a concise takeaway and CTA. Format: 16:9."
3) Brand UGC hybrid ad (60–120 seconds)
"Make a UGC-style ad featuring hands-on product interactions, natural lighting, and lifestyle b-roll. Keep character appearances consistent using context images. Alternate between handheld and locked-off shots. Include overlays that call out 3 benefits and one social proof element. End with a bold CTA and logo reveal from context images. Format: 9:16 for short-form platforms."
Example: Building the prompt dynamically in n8n
Use a Set or Function node to assemble your prompt from upstream data.
{
"title": "How to Sleep Better in 7 Days",
"chapters": [
"Evening light and caffeine timing",
"Bedroom temperature and sound",
"Pre-sleep routines and journaling"
],
"style": "calming, cinematic, soft piano score, minimal text on screen",
"cta": "Subscribe for weekly science-backed habits"
}
Then merge into a final prompt string:
Create a 6–8 minute faceless explainer titled: {{title}}.
Use three chapters: {{chapters}}. Keep shots cohesive with recurring bedroom and desk environments. Maintain character and room consistency with the provided context images. Apply a calming, cinematic grade, soft piano score, clean lower thirds, and natural voiceover pacing. End with CTA: {{cta}}. Output 16:9, YouTube-ready.
Pass this final string to the Scrptly node’s Prompt field, and add context image URLs from your product or brand library.
Handling async generation
- Recommended: Keep "Wait For Completion" on during prototyping.
- For high throughput: Turn it off, capture the returned task ID, then poll status or continue the pipeline when the video is ready. Use a Wait or polling loop strategy in n8n and route results to upload/publish nodes.
Post-processing and publishing ideas
- Store the video in cloud storage and write the URL to your CMS
- Auto-generate social cutdowns by triggering additional Scrptly jobs with new prompts
- Send Slack/Email notifications with thumbnail, title, and links
- Schedule platform-specific posts (YouTube, Instagram, TikTok) via their connectors
Developer note: Using the Scrptly SDK
If you also want programmatic control alongside n8n, install the package and set your API key:
npm install scrptly
import Scrptly from 'scrptly';
Scrptly.setApiSettings({
apiKey: process.env.SCRPTLY_API_KEY,
});
Explore the platform and APIs: https://scrptly.com/
Best practices for long-form consistency
- Provide 2–5 high-quality context images for each recurring character or product.
- Name characters and locations in your prompt to help the agent maintain identity across scenes.
- Specify pacing and structure (acts, chapters, timestamps) to guide narration and editing.
- Define aspect ratio early (16:9 for YouTube, 9:16 for shorts) to avoid reframing.
- Use a steady voice style (calm, energetic, documentary) to match brand tone.
- Budget wisely: increase the token budget for complex multi-location stories.
Troubleshooting checklist
- Characters drifting between scenes? Add more specific context images and reiterate names, wardrobe, and settings.
- Overly fast pacing? Ask for longer beats and fewer cuts per minute.
- Visual style mismatch? Define color grade, lighting, camera movement, and lens feel in the prompt.
- Running time too short/long? State a clear target duration with allowable variance.
Example workflow: Faceless channel episode, weekly
- Trigger: Schedule weekly at 9 AM
- Fetch topic: HTTP Request to your CMS or spreadsheet adapter
- Build prompt: Function node composes chapters, tone, CTA
- Scrptly node: Generate long-form 16:9 episode with context images
- Upload: Cloud storage node writes the file and returns URL
- Publish: YouTube node drafts title, description, and thumbnail
- Notify: Slack node posts the episode link to your team
Ready to build your first automated long-form video?
With Scrptly’s AI Video Agent and n8n, you can scale a consistent, on-brand video pipeline from a single prompt. Whether you’re an ecommerce marketer, educator, researcher, or entertainment creator, this stack gives you production-grade output without manual stitching.
Start creating today: https://scrptly.com/
—
Some images in this article were generated via AI tools and the article itself was proof-read with AI.


Top comments (0)