Pricing

Rating

Developer

Actor stats

Categories

Share

🎬 Script Architect

AI agent that researches trending short-form content and generates structured video scripts with scene-by-scene visual prompts for Instagram Reels, TikTok, and YouTube Shorts.

Built on Apify + LangGraph + Gemini 2.0 Flash.

How It Works

1. Scrapes trending content for your topic via Apify sub-actors (TikTok/Instagram)
2. Analyzes patterns — hook styles, engagement metrics, hashtag clusters, video durations
3. Generates a structured script with narrative arc enforcement, timed scenes, and AI-ready visual prompts
4. Validates everything — Pydantic cross-validators enforce duration math, scene sequencing, and visual prompt quality

Input

Example Input

{
"topic":"Why AI tools make junior devs slower before they make them faster",
"targetAudience":"Junior developers overwhelmed by AI coding assistants",
"contentGoal":"thought_leadership",
"platform":"TIKTOK",
"targetDuration":45,
"tone":"contrarian",
"hookStyle":"bold_claim",
"visualStyle":"b_roll_cinematic",
"brandVoice":"Direct and technical but accessible. Like a senior engineer mentoring over coffee.",
"avoidTopics":["specific tool names","pricing"]
}

Output

The agent produces a structured JSON script pushed to the Apify dataset:

Scene Structure

Each scene in the scenes array contains:

Example Output

{
"hook":"AI makes you slower.",
"hook_type":"bold_claim",
"scenes":[
{
"id":1,
"role":"hook",
"text":"AI makes you slower.",
"visual_prompt":"Close-up of hands struggling to type, surrounded by error messages, harsh red lighting, shallow depth of field, cinematic, 9:16 vertical frame, mobile-optimized composition",
"negative_prompt":null,
"duration_target":3.0
},
{
"id":2,
"role":"context",
"text":"At first, anyway.",
"visual_prompt":"Abstract animation of AI learning, lines of code forming and reforming, dark background with bright accents, futuristic, 9:16 vertical frame, mobile-optimized composition",
"negative_prompt":null,
"duration_target":4.0
},
{
"id":3,
"role":"conflict",
"text":"...but no understanding.",
"visual_prompt":"Junior dev staring blankly at code, confused expression, face illuminated by screen, desaturated colors, 9:16 vertical frame, mobile-optimized composition",
"negative_prompt":null,
"duration_target":6.0
},
{
"id":4,
"role":"revelation",
"text":"Learn fundamentals first.",
"visual_prompt":"Hands methodically writing code, syntax highlighting, warm lighting, focused, 9:16 vertical frame, mobile-optimized composition",
"negative_prompt":null,
"duration_target":6.0
},
{
"id":5,
"role":"cta",
"text":"Agree or disagree?",
"visual_prompt":"Developer leaning back, thoughtful expression, screen reflecting, soft lighting, 9:16 vertical frame, mobile-optimized composition",
"negative_prompt":null,
"duration_target":6.0
}
],
"total_duration":44.0,
"platform":"TIKTOK",
"visual_style":"Dark, moody cinematic B-roll footage. Focus on hands coding, screens glowing, and abstract algorithms. Grainy, desaturated color grading, 9:16 vertical frame",
"tone_used":"contrarian",
"content_strategy":"Challenge the idea that AI is always beneficial for junior devs.",
"trending_patterns_used":[
"Contrarian viewpoint to spark debate",
"Problem-Agitate-Solve narrative structure"
],
"cta":"Agree or disagree?",
"music_mood":null
}

Validation Rules

The agent enforces these constraints on every output:

• ✅ Narrative arc: First scene = hook, last scene = cta, at least one conflict or revelation in between
• ✅ Duration math: total_duration must match sum of scene durations (±3s)
• ✅ Scene IDs: Must be unique and sequential [1, 2, 3, ...]
• ✅ Visual prompts: 60+ characters with subject, lighting, camera angle, and 9:16 framing
• ✅ Target duration: Output checked against your targetDuration input (±5s tolerance)
• ✅ Speaking rate: Scene text validated against duration at language-appropriate words-per-minute

Running Locally

1. Set your Google API key:

   $exportGOOGLE_API_KEY=your_key_here

2. Run with the test input:

   $apify run

   The default input is in storage/key_value_stores/default/INPUT.json.

Deploying to Apify

1. Push to Apify:

   $apify push

2. Set GOOGLE_API_KEY in the actor's Environment Variables on Apify Console.

3. Run from the Console or via API.

Pricing (Pay-Per-Event)

Tech Stack

• Runtime: Python 3.14 on Apify
• LLM: Google Gemini 2.0 Flash
• Agent Framework: LangGraph (ReAct pattern)
• Schema Validation: Pydantic v2
• Data Sources: Apify sub-actors (clockworks/tiktok-scraper, apify/instagram-hashtag-scraper, apify/instagram-scraper)