🎬 HeyGen AI Avatar News Video Generator

Fully automated AI video generator that transforms RSS news feeds into professional avatar-presented videos. Fetches headlines, generates scripts with Gemini AI, and creates videos with HeyGen's realistic AI avatars.

Simply click execute and watch as your workflow automatically creates a news video from the latest BBC headlines—complete with an AI avatar presenter and professionally generated script.

🎥 Project Demo:

🎯 Overview

HeyGen AI Avatar News Video Generator is an intelligent n8n workflow that fully automates the creation of news videos. It combines RSS feeds, Google Gemini AI for script generation, and HeyGen's cutting-edge AI avatars to produce professional-quality videos without any manual editing.

What Makes This Special?

🤖 Fully Automated - No manual intervention from feed to final video
📰 RSS Integration - Pulls latest news from any RSS feed (BBC News by default)
🧠 AI Script Generation - Gemini 2.5 Flash creates engaging news scripts
👤 Realistic AI Avatars - HeyGen's premium avatars present your content
🎙️ Natural Voice Synthesis - Automatic male voice selection
⏱️ Smart Polling - Waits for video generation with exponential backoff
📥 Auto Download - Saves completed video automatically
🔄 Error Handling - Robust retry logic and status checking

Who Is This For?

📺 Content Creators - Generate news recap videos daily
🎥 Social Media Managers - Create engaging video content at scale
📱 News Channels - Automate news video production
🏢 Marketing Teams - Quick video content from industry news
🎓 Educators - Create educational news summaries
🤖 Automation Enthusiasts - Learn advanced n8n workflows

✨ Key Features

📰 RSS Feed Integration

Fetches latest headlines from BBC News RSS
Processes multiple articles automatically
Creates digestible news summaries
Supports any RSS feed URL
Configurable number of headlines (default: 5)

🧠 AI Script Generation (Google Gemini)

Uses Gemini 2.5 Flash model
Converts headlines into engaging scripts
Natural conversational tone
Optimized for avatar delivery
Character limit enforcement (1400 chars)
Automatic script validation

🎬 HeyGen Avatar Video Creation

Access to HeyGen's avatar library
Automatic non-premium avatar selection
Smart male voice picker
Customizable video dimensions (1280x720)
Professional avatar presentation
Natural gestures and expressions

🎙️ Voice Synthesis

Automatic male voice selection from HeyGen library
Fallback voice ID for reliability
Natural speech patterns
Adjustable speech speed
Gender preference matching

⏱️ Smart Video Processing

Polls HeyGen API for completion status
Exponential backoff strategy
Maximum wait time protection
Status checking (completed/failed/waiting/pending/processing)
Automatic retry on transient failures

📥 Video Download & Management

Automatic video file download
Thumbnail and GIF URLs extracted
Complete metadata capture
Job ID tracking
Duration and creation timestamps

🔄 How It Works

User Experience

Step 1: Click "Execute Workflow" in n8n

Step 2: Workflow automatically:
        ├─ Fetches BBC News RSS feed
        ├─ Extracts top 5 headlines
        ├─ Creates news digest
        ├─ Sends to Gemini AI for script generation
        ├─ Fetches HeyGen avatars
        ├─ Fetches HeyGen voices
        ├─ Selects best avatar and voice
        ├─ Submits video generation request
        ├─ Polls for completion (every 6-30 seconds)
        └─ Downloads finished video

Step 3: Video ready! (~2-5 minutes total)
        • Professional AI avatar presentation
        • Natural voice narration
        • HD quality (1280x720)
        • Ready to publish

Technical Flow

Manual Trigger
     ↓
RSS Feed Reader (BBC News)
     ↓
Extract Top 5 Headlines
     ↓
Create News Digest
     ↓
Google Gemini API
├─ Generate engaging script
└─ Validate & truncate to 1400 chars
     ↓
Prepare Configuration
     ↓
Parallel Fetch:
├─ HeyGen Avatars → Pick Non-Premium Avatar
└─ HeyGen Voices → Pick Male Voice
     ↓
Generate Video Request (HeyGen API)
     ↓
Extract Video ID
     ↓
Poll Video Status Loop:
├─ Check Status
├─ Switch (completed/failed/waiting/pending/processing)
├─ If Still Processing:
│   ├─ Calculate Backoff Wait Time
│   ├─ Wait (6-30 seconds)
│   └─ Poll Again
└─ If Completed:
    ├─ Download Video File
    ├─ Extract Metadata
    └─ Return Results

🏗️ System Architecture

Data Flow

┌─────────────────────────────────────────────────────────────┐
│                      INPUT LAYER                             │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌──────────────────────────────────────────────┐          │
│  │         RSS Feed Reader                      │          │
│  │         (BBC News RSS)                       │          │
│  │                                               │          │
│  │  Fetches: Title, Description, Link, PubDate  │          │
│  │  Returns: Array of news articles             │          │
│  └────────────────────┬─────────────────────────┘          │
│                       │                                      │
└───────────────────────┼──────────────────────────────────────┘
                        ↓
┌─────────────────────────────────────────────────────────────┐
│                   PROCESSING LAYER                           │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌──────────────────────────────────────────────┐          │
│  │        Create News Digest                    │          │
│  │        (JavaScript Code Node)                │          │
│  │                                               │          │
│  │  • Select first 5 headlines                  │          │
│  │  • Format as bullet points                   │          │
│  │  • Create single digest string               │          │
│  └────────────────────┬─────────────────────────┘          │
│                       │                                      │
│                       ↓                                      │
│  ┌──────────────────────────────────────────────┐          │
│  │        Google Gemini API                     │          │
│  │        (Script Generation)                   │          │
│  │                                               │          │
│  │  Input: News digest                          │          │
│  │  Model: Gemini 2.5 Flash                     │          │
│  │  Output: Engaging news script                │          │
│  └────────────────────┬─────────────────────────┘          │
│                       │                                      │
│                       ↓                                      │
│  ┌──────────────────────────────────────────────┐          │
│  │        Extract & Validate Script             │          │
│  │        (JavaScript Code Node)                │          │
│  │                                               │          │
│  │  • Extract text from Gemini response         │          │
│  │  • Trim whitespace                           │          │
│  │  • Enforce 1400 character limit              │          │
│  │  • Validate script is not empty              │          │
│  └────────────────────┬─────────────────────────┘          │
│                       │                                      │
└───────────────────────┼──────────────────────────────────────┘
                        ↓
┌─────────────────────────────────────────────────────────────┐
│                   HEYGEN PREPARATION                         │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌──────────────────────────────────────────────┐          │
│  │        Set Default Configuration             │          │
│  │        (Edit Fields Node)                    │          │
│  │                                               │          │
│  │  • Avatar ID: 9bb55566ca0242609aa1fea1f7144656│         │
│  │  • Voice ID: 0912d8004fd948a9aab02fffd264a3c1 │         │
│  │  • Dimensions: 1280x720                      │          │
│  │  • Script: Pass through                      │          │
│  └────────────────────┬─────────────────────────┘          │
│                       │                                      │
│          ┌────────────┴────────────┐                        │
│          ↓                         ↓                        │
│  ┌──────────────────┐      ┌──────────────────┐           │
│  │  Fetch Avatars   │      │  Fetch Voices    │           │
│  │  (HeyGen API)    │      │  (HeyGen API)    │           │
│  └────────┬─────────┘      └────────┬─────────┘           │
│           ↓                         ↓                        │
│  ┌──────────────────┐      ┌──────────────────┐           │
│  │  Pick Avatar     │      │  Pick Male Voice │           │
│  │  (Non-Premium)   │      │  (Preference)    │           │
│  └────────┬─────────┘      └────────┬─────────┘           │
│           │                         │                        │
│           └────────────┬────────────┘                        │
│                        │                                      │
└────────────────────────┼──────────────────────────────────────┘
                         ↓
┌─────────────────────────────────────────────────────────────┐
│                   VIDEO GENERATION                           │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌──────────────────────────────────────────────┐          │
│  │     HeyGen Video Generation Request          │          │
│  │                                               │          │
│  │  POST /v2/video/generate                     │          │
│  │  {                                            │          │
│  │    "video_inputs": [{                        │          │
│  │      "character": { avatar_id, avatar_style },│         │
│  │      "voice": { input_text, voice_id, speed } │         │
│  │    }],                                        │          │
│  │    "dimension": { width, height }            │          │
│  │  }                                            │          │
│  └────────────────────┬─────────────────────────┘          │
│                       │                                      │
│                       ↓                                      │
│  ┌──────────────────────────────────────────────┐          │
│  │     Extract Video ID                         │          │
│  │     Initialize Polling State                 │          │
│  │                                               │          │
│  │  • video_id: From HeyGen response            │          │
│  │  • attempts: 0                               │          │
│  │  • max_poll_seconds: 180                     │          │
│  │  • poll_interval_seconds: 6                  │          │
│  └────────────────────┬─────────────────────────┘          │
│                       │                                      │
└───────────────────────┼──────────────────────────────────────┘
                        ↓
┌─────────────────────────────────────────────────────────────┐
│                   POLLING LOOP                               │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌──────────────────────────────────────────────┐          │
│  │  ┌─────────────────────────────────────┐     │          │
│  │  │   Poll Video Status                 │     │          │
│  │  │   GET /v1/video_status.get          │     │          │
│  │  └────────────┬────────────────────────┘     │          │
│  │               │                               │          │
│  │               ↓                               │          │
│  │  ┌─────────────────────────────────────┐     │          │
│  │  │   Switch on Status                  │     │          │
│  │  ├─────────────────────────────────────┤     │          │
│  │  │  • completed → Download Video       │     │          │
│  │  │  • failed → Throw Error             │     │          │
│  │  │  • waiting → Continue Loop          │     │          │
│  │  │  • pending → Continue Loop          │     │          │
│  │  │  • processing → Continue Loop       │     │          │
│  │  └────────────┬────────────────────────┘     │          │
│  │               │                               │          │
│  │               ↓ (if not completed)           │          │
│  │  ┌─────────────────────────────────────┐     │          │
│  │  │   Calculate Backoff Wait            │     │          │
│  │  │   • Base: 6 seconds                 │     │          │
│  │  │   • Add: +2s per attempt            │     │          │
│  │  │   • Max: 30 seconds                 │     │          │
│  │  │   • Check: Total time < 180s        │     │          │
│  │  └────────────┬────────────────────────┘     │          │
│  │               │                               │          │
│  │               ↓                               │          │
│  │  ┌─────────────────────────────────────┐     │          │
│  │  │   Wait Node                         │     │          │
│  │  │   (Dynamic duration)                │     │          │
│  │  └────────────┬────────────────────────┘     │          │
│  │               │                               │          │
│  │               └──────────┐                    │          │
│  │                          │                    │          │
│  └──────────────────────────┼────────────────────┘          │
│                             │ (Loop back)                    │
└─────────────────────────────┼──────────────────────────────────┘
                              ↓ (completed)
┌─────────────────────────────────────────────────────────────┐
│                   OUTPUT LAYER                               │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌──────────────────────────────────────────────┐          │
│  │     Download Video File                      │          │
│  │     (HTTP Request - Binary Response)         │          │
│  └────────────────────┬─────────────────────────┘          │
│                       │                                      │
│                       ↓                                      │
│  ┌──────────────────────────────────────────────┐          │
│  │     Format Output Metadata                   │          │
│  │                                               │          │
│  │  • video_url: Direct download link           │          │
│  │  • thumbnail_url: Preview image              │          │
│  │  • gif_url: Animated preview                 │          │
│  │  • job_id: HeyGen job identifier             │          │
│  │  • status: completed                         │          │
│  │  • created_at: Timestamp                     │          │
│  │  • duration: Video length                    │          │
│  │  • message: Success confirmation             │          │
│  └──────────────────────────────────────────────┘          │
│                                                              │
└─────────────────────────────────────────────────────────────┘

🛠️ Tech Stack

Category	Technology	Purpose
Automation	n8n	Workflow orchestration
RSS Feed	BBC News RSS	News headline source
AI Script	Google Gemini 2.5 Flash	Script generation
Avatar Platform	HeyGen	AI avatar video creation
Voice Synthesis	HeyGen Voices	Natural speech generation
Programming	JavaScript (n8n Code nodes)	Data processing and logic
API Integration	HTTP Request nodes	External service communication

📦 Prerequisites

Required Accounts & API Keys

Service	Required?	Purpose	Cost
n8n	✅ Yes	Run workflows	Free (self-hosted) or $20/mo
Google AI Studio	✅ Yes	Gemini API access	Free tier: 15 requests/min
HeyGen	✅ Yes	AI avatar videos	$24-$120/mo (based on plan)

API Keys Needed

✅ Google Gemini API Key
✅ HeyGen API Key (X-Api-Key)

Technical Requirements

n8n instance (v1.0+)
Stable internet connection
~5 GB storage for video files

🚀 Installation

Step 1: Download Workflow

Download My workflow.json from repository
Save to your computer

Step 2: Import to n8n

Open your n8n instance
Click "Workflows" → "Import from File"
Select My workflow.json
Click "Import"
Workflow appears in your workspace

Step 3: Get Google Gemini API Key

Visit https://ai.google.dev/
Click "Get API key"
Create new project or select existing
Click "Create API Key"
Copy and save the key

Format: AIzaSyAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Step 4: Get HeyGen API Key

Sign up at https://www.heygen.com/
Go to "API" section in dashboard
Copy your API key

Format: MDU2NTExODlmZWJmNGY2MTk4ZjBhMjEzMjM1NGYyNGItMTc1OTY0NjA2Ng==

Note: The key in the workflow is the actual HeyGen key from the JSON. Replace it with your own key!

⚙️ Configuration

Update API Keys

You need to update API keys in 5 HTTP Request nodes:

1. HTTP Request20 (Gemini API)

Find this node and update the URL:

Before:

https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=AIzaSyAqNnJtQE888wIZHoTCYwP1pn0sZ3X2y_Q

After:

https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=YOUR_GEMINI_API_KEY

2. HTTP Request2 (Fetch Avatars)

Find the node and update headers:

Header Parameters:

Name: X-Api-Key
Value: Replace with YOUR_HEYGEN_API_KEY

3. HTTP Request16 (Fetch Voices)

Header Parameters:

Name: X-Api-Key
Value: Replace with YOUR_HEYGEN_API_KEY

4. HTTP Request17 (Generate Video)

Header Parameters:

Name: x-api-key
Value: Replace with YOUR_HEYGEN_API_KEY

5. HTTP Request18 (Poll Status)

Header Parameters:

Name: X-Api-Key
Value: Replace with YOUR_HEYGEN_API_KEY

Customize RSS Feed

By default, workflow uses BBC News. To change:

Find "RSS Read2" node
Update URL parameter:

Current:

https://feeds.bbci.co.uk/news/rss.xml

Other options:

CNN: http://rss.cnn.com/rss/cnn_topstories.rss
Reuters: http://feeds.reuters.com/reuters/topNews
TechCrunch: https://techcrunch.com/feed/

Adjust Headline Count

Find "Code1" node (Create Digest)
Modify maxItems value:

Current:

const maxItems = 5;

Change to:

const maxItems = 10; // Get 10 headlines instead

Customize Video Settings

Find "Edit Fields1" node
Adjust values:

Avatar ID:

"avatar_id": "9bb55566ca0242609aa1fea1f7144656"

Voice ID:

"voice_id": "0912d8004fd948a9aab02fffd264a3c1"

Video Dimensions:

"width": 1920,  // Change to 1920 for Full HD
"height": 1080  // Change to 1080 for Full HD

Default Script (for testing):

"script": "Your custom test script here"

Polling Configuration

The workflow uses smart polling with exponential backoff. To adjust:

Find "Code15" node (Initialize polling)
Modify default values:

Current:

max_poll_seconds: 180,  // 3 minutes max
poll_interval_seconds: 6  // Start at 6 seconds

For faster polling:

max_poll_seconds: 300,  // 5 minutes max
poll_interval_seconds: 4  // Start at 4 seconds

📖 Workflow Breakdown

Stage 1: News Collection

Nodes: Manual Trigger → RSS Read2 → Code1

Manual Trigger: Click to start workflow
RSS Read2: Fetches BBC News RSS feed

Code1 (Create Digest):

// Selects first 5 headlines
const maxItems = 5;
const selected = input.slice(0, maxItems);

// Formats as bullet points
const lines = selected.map(it => `• ${it.json.title}`);
const digest = lines.join('\n');

Output Example:

• UK inflation rises to 2.6% amid energy costs
• Climate summit reaches historic agreement
• Tech giant announces new AI breakthrough
• Sports: Manchester United wins championship
• Markets surge on positive economic data

Stage 2: Script Generation

Nodes: HTTP Request20 → Code14

HTTP Request20 (Gemini API):
- Sends news digest to Gemini 2.5 Flash
- Model generates engaging script
- Returns JSON response

Code14 (Extract Script):

// Extract text from Gemini response
const cands = items[0].json.candidates || [];
const text = cands?.[0]?.content?.parts?.[0]?.text || "";

// Safety: trim & hard cap at 1400 chars
const script = text.trim().slice(0, 1400);

if (!script) {
  throw new Error("Empty script from Gemini");
}

Output Example:

"Good morning! Let's dive into today's top stories. 
Starting with the economy, UK inflation has climbed to 2.6%..."

Stage 3: HeyGen Preparation

Nodes: Use My Script1 → Edit Fields1 → HTTP Request2 & HTTP Request16

Use My Script1: Assigns script to variable
Edit Fields1: Sets default configuration
Parallel Execution:
- HTTP Request2: Fetches available avatars
- HTTP Request16: Fetches available voices

Stage 4: Avatar & Voice Selection

Nodes: Pick Avatar1 → Pick Male Voice1

Pick Avatar1 (JavaScript):

// Choose first non-premium avatar
const avatars = root?.data?.avatars || root?.avatars || [];
const chosen = avatars.find(a => a?.premium === false) || avatars[0];
const avatarId = chosen.avatar_id || 'Abigail_expressive_2024112501';

Pick Male Voice1 (JavaScript):

// Prefer explicit male gender
const voices = root?.data?.voices || root?.voices || [];
const preferred = voices.find(v => 
  String(v.gender || '').toLowerCase() === 'male'
);

// Fallback if no male voice found
const voiceId = preferred?.voice_id ?? '06f9223be7d444d887045ba89c1d00b6';

Stage 5: Video Generation

Node: HTTP Request17

API Request:

POST https://api.heygen.com/v2/video/generate

Headers:
- x-api-key: YOUR_HEYGEN_API_KEY
- Content-Type: application/json

Body:
{
  "video_inputs": [{
    "character": {
      "type": "avatar",
      "avatar_id": "{{ selected_avatar_id }}",
      "avatar_style": "normal"
    },
    "voice": {
      "type": "text",
      "input_text": "{{ script }}",
      "voice_id": "{{ selected_voice_id }}",
      "speed": 1.1
    }
  }],
  "dimension": {
    "width": 1280,
    "height": 720
  }
}

Response:

{
  "data": {
    "video_id": "abc123xyz789"
  }
}

Stage 6: Status Polling Loop

Nodes: Code15 → HTTP Request18 → Switch2 → Code16 → Wait2

Flow:

Code15: Extract video_id, initialize polling state
HTTP Request18: Check video status
Switch2: Route based on status
- completed → Download video
- failed → Throw error
- waiting/pending/processing → Continue loop

Code16: Calculate backoff wait time

const prev = $json.attempts || 0;
const base = $json.poll_interval_seconds || 6;

// Exponential backoff: 6s, 8s, 10s, 12s, ..., max 30s
const wait = Math.min(base + prev * 2, 30);

// Check if exceeded max polling time
if (elapsed >= 180) {
  throw new Error("Polling budget exceeded");
}

Wait2: Pause for calculated duration
Loop back to HTTP Request18

Stage 7: Video Download

Nodes: If2 → HTTP Request19 → Edit Fields5

If2: Verify video_url exists
HTTP Request19: Download video file
- Response format: Binary (video file)

Edit Fields5: Format metadata

{
  "video_url": "https://...",
  "thumbnail_url": "https://...",
  "gif_url": "https://...",
  "job_id": "...",
  "status": "completed",
  "duration": "...",
  "message": "Video successfully generated"
}

🎨 Customization

Use Different News Sources

Add Multiple RSS Feeds:

Duplicate RSS Read2 node

Update URL for each source:

Source 1: BBC News
Source 2: CNN
Source 3: TechCrunch

Merge results before Code1 node

Customize Script Prompt

Add system prompt to Gemini for specific styles:

In HTTP Request20 body:

{
  "contents": [{
    "parts": [{
      "text": "You are a professional news anchor. Create an engaging 60-second news script from these headlines. Use a conversational yet authoritative tone.\n\nHeadlines:\n" + $json.digest
    }]
  }]
}

Prompt variations:

"Create a humorous take on these news stories"
"Write in the style of a sports commentator"
"Make it suitable for children aged 8-12"

Select Specific Avatar

Instead of auto-selection:

In Edit Fields1 node:

"avatar_id": "YOUR_SPECIFIC_AVATAR_ID"

To find avatar IDs:

Run workflow once
Check output of HTTP Request2
Browse data.avatars array
Copy desired avatar_id

Choose Female Voice

In Pick Male Voice1 node, change logic:

// Change from male to female
const preferred = voices.find(v => 
  String(v.gender || '').toLowerCase() === 'female'
);

// Fallback female voice
const voiceId = preferred?.voice_id ?? 'FEMALE_VOICE_ID';

Add Background Music

This requires HeyGen Pro features. In video generation request:

{
  "video_inputs": [...],
  "dimension": {...},
  "audio": {
    "type": "music",
    "url": "https://yourmusicurl.com/background.mp3",
    "volume": 0.3
  }
}

Schedule Automatic Execution

Replace Manual Trigger with Schedule Trigger:

Delete "When clicking 'Execute workflow'" node
Add "Schedule Trigger" node

Configure schedule:

Cron Expression: 0 8 * * *
Meaning: Every day at 8:00 AM

Other schedules:

Every hour: 0 * * * *
Every 6 hours: 0 */6 * * *
Weekdays at 9 AM: 0 9 * * 1-5

🐛 Troubleshooting

Issue: "Empty script from Gemini"

Cause: Gemini API returned no text

Solutions:

Check API key is valid
Verify API quota not exceeded
Check if digest was properly formatted
Test Gemini API directly
Review request body in HTTP Request20

Issue: "HeyGen did not return video_id"

Cause: Video generation request failed

Solutions:

Verify HeyGen API key is correct
Check HeyGen account has credits
Verify avatar_id is valid
Confirm voice_id exists
Check script length (<1400 chars)
Review HTTP Request17 response

Issue: "Polling budget exceeded"

Cause: Video took longer than 3 minutes

Solutions:

Increase max_poll_seconds in Code15:
```
max_poll_seconds: 300  // 5 minutes
```
Check HeyGen service status
Try shorter script
Verify account limits

Issue: Video quality is poor

Cause: Resolution settings or HeyGen plan limits

Solutions:

Upgrade HeyGen plan for better quality
Increase dimensions in Edit Fields1:
```
"width": 1920,
"height": 1080
```
Select premium avatars (may cost more)

Issue: Wrong avatar selected

Cause: Auto-selection picking incorrect avatar

Solutions:

Hardcode specific avatar ID

Modify Pick Avatar1 logic:

// Prefer specific style
const chosen = avatars.find(a => 
  a.avatar_style === 'professional'
);

Review available avatars list

Issue: Voice sounds robotic

Cause: Voice selection or speed settings

Solutions:

Try different voice_id
Adjust speech speed in HTTP Request17:
```
"speed": 1.0  // Slower, more natural
```
Select premium voices
Check voice preview on HeyGen

Issue: RSS feed fails to load

Cause: Feed URL changed or network issue

Solutions:

Test RSS URL in browser
Check for redirects
Try alternative RSS feeds

Add error handling:

if (!items || items.length === 0) {
  throw new Error("No RSS items found");
}

💡 Best Practices

Cost Management

HeyGen Credits:

Each video consumes credits
Monitor credit usage in dashboard
Consider bulk credit purchases
Use non-premium avatars for testing

Gemini API:

Free tier: 15 requests/minute
Cache script results if re-using
Monitor quota usage

Cost per video (estimated):

Gemini API: $0.00 (free tier)
HeyGen: $0.50 - $2.00 per video
Total: ~$0.50 - $2.00 per video

Script Optimization

Best practices:

Keep scripts under 60 seconds (~150 words)
Use conversational language
Avoid complex terms unless necessary
Include pauses (commas, periods)
Test different prompts

Example good script:

"Good morning! In today's news... [pause]
The UK economy shows mixed signals with inflation at 2.6%. 
Meanwhile, climate leaders reached a historic agreement..."

Avatar Selection

Guidelines:

Use professional avatars for news
Match avatar ethnicity to audience
Consider gender based on voice
Test different avatars for engagement

Popular avatar types:

News anchor style
Business professional
Casual presenter

Performance Optimization

Speed up workflow:

Reduce headline count (5 → 3)
Shorter scripts generate faster
Use standard resolution (720p vs 1080p)
Consider parallel processing for multiple videos

Error Recovery

Add error handling:

After Gemini request:

// Retry logic
let attempts = 0;
while (attempts < 3) {
  try {
    // API call
    break;
  } catch (e) {
    attempts++;
    if (attempts === 3) throw e;
    // Wait and retry
  }
}

Quality Assurance

Before publishing videos:

Watch complete video
Check audio sync
Verify script accuracy
Test on target platform
Review thumbnail/preview

📊 Use Cases

1. Daily News Recaps

Schedule:

Run every morning at 8 AM
Generate 2-minute news summary
Post to YouTube/social media

Benefits:

Consistent content schedule
No video editing required
Professional presentation

2. Industry News Updates

Example: Tech News

RSS: TechCrunch
Script focus: Latest tech developments
Avatar: Professional tech presenter

Distribution:

LinkedIn posts
Company newsletter
Internal communications

3. Educational Content

Example: Daily History Facts

RSS: History feed
Script: Engaging historical narratives
Avatar: Teacher/educator style

Target:

Educational platforms
Social media education accounts

4. Market Updates

Example: Financial News

RSS: Bloomberg/Reuters
Script: Market analysis summary
Avatar: Business professional

Audience:

Investors
Business professionals
Financial advisors

5. Social Media Content

Quick video clips:

30-second news highlights
Shareable format
Optimized for mobile

Platforms:

Instagram Reels
TikTok
YouTube Shorts
Twitter/X

📈 Performance Metrics

Workflow Execution Time:

Stage	Duration
RSS Feed Fetch	2-5 seconds
Script Generation	3-8 seconds
Avatar/Voice Selection	2-4 seconds
Video Generation Request	1-2 seconds
Video Processing	60-180 seconds
Video Download	5-15 seconds
Total	~2-5 minutes

Resource Usage:

CPU: Low (mostly API calls)
Memory: <100 MB
Network: ~50-200 MB per video
Storage: 10-50 MB per video

💰 Cost Analysis

Monthly Costs (30 videos/month)

Service	Cost
n8n (self-hosted)	$0 or $20/mo (cloud)
Google Gemini	$0 (free tier)
HeyGen	$24-120/mo (plan-based)
Total	$24-140/month

Cost per video: $0.80 - $4.67

🚀 Advanced Features

Multi-Language Support

Generate videos in different languages:

Modify Gemini prompt:

"Generate this news script in Spanish..."

Select appropriate voice:

Filter voices by language in Pick Male Voice node

A/B Testing

Create multiple versions:

Generate with different avatars
Try various script styles
Test speech speeds
Compare engagement metrics

Batch Processing

Generate multiple videos:

Add loop node before RSS Read
Array of topics/sources
Process each sequentially
Save all videos

📄 License

This project is licensed under the MIT License.

✅ Commercial use allowed
✅ Modification allowed
✅ Distribution allowed
✅ Private use allowed
⚠️ No warranty or liability

🌟 Acknowledgments

Built with powerful tools:

n8n - Workflow automation
HeyGen - AI avatar platform
Google Gemini - Script generation AI
BBC News RSS - News source

🎬 Ready to Create AI Videos!

Start generating professional AI avatar videos automatically:

✅ Import workflow to n8n
✅ Add API keys (Gemini & HeyGen)
✅ Click execute
✅ Wait 2-5 minutes
✅ Download your video!

Made with 🎬 for content creators everywhere

⭐ Automate your video content creation! 🤖 Professional AI avatars at scale! 📺 High-quality videos without editing!

Name		Name	Last commit message	Last commit date
Latest commit History 12 Commits
Images		Images
Vidoes		Vidoes
n8n workflow		n8n workflow
.DS_Store		.DS_Store
LICENSE		LICENSE
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

🎬 HeyGen AI Avatar News Video Generator

📋 Table of Contents

🎯 Overview

What Makes This Special?

Who Is This For?

✨ Key Features

📰 RSS Feed Integration

🧠 AI Script Generation (Google Gemini)

🎬 HeyGen Avatar Video Creation

🎙️ Voice Synthesis

⏱️ Smart Video Processing

📥 Video Download & Management

🔄 How It Works

User Experience

Technical Flow

🏗️ System Architecture

Data Flow

🛠️ Tech Stack

📦 Prerequisites

Required Accounts & API Keys

API Keys Needed

Technical Requirements

🚀 Installation

Step 1: Download Workflow

Step 2: Import to n8n

Step 3: Get Google Gemini API Key

Step 4: Get HeyGen API Key

⚙️ Configuration

Update API Keys

1. HTTP Request20 (Gemini API)

2. HTTP Request2 (Fetch Avatars)

3. HTTP Request16 (Fetch Voices)

4. HTTP Request17 (Generate Video)

5. HTTP Request18 (Poll Status)

Customize RSS Feed

Adjust Headline Count

Customize Video Settings

Polling Configuration

📖 Workflow Breakdown

Stage 1: News Collection

Stage 2: Script Generation

Stage 3: HeyGen Preparation

Stage 4: Avatar & Voice Selection

Stage 5: Video Generation

Stage 6: Status Polling Loop

Stage 7: Video Download

🎨 Customization

Use Different News Sources

Customize Script Prompt

Select Specific Avatar

Choose Female Voice

Add Background Music

Schedule Automatic Execution

🐛 Troubleshooting

Issue: "Empty script from Gemini"

Issue: "HeyGen did not return video_id"

Issue: "Polling budget exceeded"

Issue: Video quality is poor

Issue: Wrong avatar selected

Issue: Voice sounds robotic

Issue: RSS feed fails to load

💡 Best Practices

Cost Management

Script Optimization

Avatar Selection

Performance Optimization

Error Recovery

Quality Assurance

📊 Use Cases

1. Daily News Recaps

2. Industry News Updates

3. Educational Content

4. Market Updates

5. Social Media Content

📈 Performance Metrics

💰 Cost Analysis

Packages