media-factory

name	media-factory
description	AI-powered media production pipeline using Nano Banana Pro (images), KLING AI (video/transitions), and ElevenLabs (voiceover). Use when creating video content, product demos, social media assets, or any multimedia production.
version	1.0.0
mcps	["firecrawl","perplexity"]
subagents	["nana-image-generator"]
skills	["terminal-ui-design"]

ID8 MEDIA FACTORY - AI Production Pipeline

Purpose

Orchestrate AI-powered multimedia production using three specialized tools:

• Nano Banana Pro (fal.ai) → Image generation
• KLING AI → Video generation & transitions
• ElevenLabs → Voiceover & audio

Philosophy: Assemble, don't animate. Generate high-quality assets, then compose them into polished content.

---

When to Use

• Creating product demos or explainer videos
• Generating social media video content
• Building marketing assets (ads, promos)
• Producing educational content
• Creating podcast/video intros and outros
• Generating b-roll or background footage
• Building visual storytelling content
• Product launch videos
• Any multimedia content requiring images + video + audio

---

The Three Pillars

🖼️ Nano Banana Pro (Images)

Provider: fal.ai (fal-ai/nano-banana-pro) Purpose: Generate high-quality still images from text prompts

Feature	Value
Model	Gemini 3 Pro Image (Nano Banana 2)
Resolutions	1K, 2K, 4K
Aspect Ratios	21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16
Formats	PNG, JPEG, WebP
Web Search	Can use live web data for current topics

Best For:

• Hero images, thumbnails
• Character/product shots
• Background scenes
• Storyboard frames
• Social media graphics

🎬 KLING AI (Video)

Provider: KLING AI / AI/ML API Purpose: Generate video from text or images, create transitions

Feature	Value
Text-to-Video	v1, v1.6, v2, v2.1 (standard/pro/master)
Image-to-Video	v1, v1.6, v2, v2.1 (standard/pro/master)
Effects	v1.6-standard/effects, v1.6-pro/effects
Resolution	Up to 1080p
Frame Rate	30 fps
Duration	5-10 seconds per generation

Best For:

• Animating still images
• Creating transitions between scenes
• Generating b-roll footage
• Motion graphics
• Product animations

🎙️ ElevenLabs (Voice)

Provider: ElevenLabs API Purpose: Generate natural voiceovers and audio

Feature	Value
Models	eleven_multilingual_v2 (default), eleven_turbo_v2_5
Languages	32+ supported
Voices	1000s of pre-made + custom voice cloning
Formats	mp3_44100_128, pcm_44100, etc.
Features	Pronunciation dictionaries, voice settings

Best For:

• Narration and voiceovers
• Character voices
• Podcast intros
• Product demo audio
• Multilingual content

---

Production Workflows

Workflow 1: Image → Video → Audio (Standard)

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  NANO BANANA    │────▶│    KLING AI     │────▶│   ELEVENLABS    │
│  Generate       │     │  Animate        │     │   Narrate       │
│  Still Images   │     │  Images to      │     │   Final         │
│                 │     │  Video          │     │   Video         │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Steps:

1. Write prompts for each scene/shot
2. Generate images with Nano Banana Pro
3. Feed images to KLING for animation
4. Write script for voiceover
5. Generate audio with ElevenLabs
6. Composite in video editor (CapCut, DaVinci, Premiere)

Workflow 2: Script-First (Narrative)

┌─────────────────┐
│   SCRIPT        │
│   Write story   │
└────────┬────────┘
         │
    ┌────┴────┐
    ▼         ▼
┌───────┐  ┌───────────┐
│ELEVEN │  │NANO BANANA│
│LABS   │  │Scene imgs │
└───┬───┘  └─────┬─────┘
    │            │
    │      ┌─────┴─────┐
    │      ▼           │
    │  ┌───────┐       │
    │  │KLING  │       │
    │  │Animate│       │
    │  └───┬───┘       │
    │      │           │
    └──────┴───────────┘
           │
           ▼
    ┌─────────────┐
    │  COMPOSITE  │
    │  Final Edit │
    └─────────────┘

Workflow 3: Product Demo

Product Photos → KLING (animate) → KLING (transitions) → ElevenLabs (VO)

---

Commands

/media-factory plan <concept>

Create a production plan for multimedia content.

Output:

• Scene breakdown
• Image prompts (for Nano Banana)
• Video direction (for KLING)
• Script draft (for ElevenLabs)
• Estimated assets and timeline

/media-factory image <prompt>

Generate an image using Nano Banana Pro.

Parameters:

• --aspect - Aspect ratio (default: 16:9)
• --resolution - 1K, 2K, or 4K (default: 1K)
• --count - Number of variations (default: 1)
• --format - png, jpeg, webp (default: png)

/media-factory video <prompt-or-image>

Generate video using KLING AI.

Parameters:

• --model - v2.1-master, v1.6-pro, etc.
• --mode - text-to-video or image-to-video
• --duration - 5 or 10 seconds

/media-factory voice <script>

Generate voiceover using ElevenLabs.

Parameters:

• --voice - Voice ID or name
• --model - eleven_multilingual_v2, eleven_turbo_v2_5
• --format - mp3_44100_128, pcm_44100, etc.

/media-factory storyboard <concept>

Generate a complete storyboard with images for each scene.

---

API Reference

Nano Banana Pro (fal.ai)

Endpoint: fal-ai/nano-banana-pro

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/nano-banana-pro", {
  input: {
    prompt: "A product shot of a sleek black smartwatch on a marble surface, soft studio lighting, commercial photography",
    num_images: 1,
    aspect_ratio: "16:9",
    resolution: "2K",
    output_format: "png"
  }
});

console.log(result.data.images[0].url);

Input Schema:

Field	Type	Required	Default	Description
prompt	string	✓	-	Text description of image
num_images	integer		1	Number of images to generate
aspect_ratio	enum		1:1	21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16
resolution	enum		1K	1K, 2K, 4K
output_format	enum		png	jpeg, png, webp
enable_web_search	boolean		false	Use live web data

Environment:

export FAL_KEY="your-fal-api-key"

---

KLING AI

Text-to-Video:

const response = await fetch("https://api.klingai.com/v1/videos/text-to-video", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${KLING_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "v2.1-master",
    prompt: "A camera slowly pans across a modern office space, morning light streaming through windows",
    duration: 5,
    aspect_ratio: "16:9"
  })
});

Image-to-Video:

const response = await fetch("https://api.klingai.com/v1/videos/image-to-video", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${KLING_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "v2.1-master",
    image_url: "https://storage.example.com/my-image.png",
    prompt: "The subject slowly turns to face the camera, subtle wind moving their hair",
    duration: 5
  })
});

Models Available:

Model	Type	Quality	Speed
v2.1-master	Both	Highest	Slow
v2.1-pro	Both	High	Medium
v2.1-standard	Both	Good	Fast
v1.6-pro	Both	High	Medium
v1.6-standard	Both	Good	Fast
v1.6-standard/effects	I2V	Special FX	Fast

---

ElevenLabs

Text-to-Speech:

const response = await fetch(
  `https://api.elevenlabs.io/v1/text-to-speech/${voiceId}`,
  {
    method: "POST",
    headers: {
      "xi-api-key": ELEVENLABS_API_KEY,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      text: "Welcome to our product demo. Today we'll show you how our solution transforms your workflow.",
      model_id: "eleven_multilingual_v2",
      voice_settings: {
        stability: 0.5,
        similarity_boost: 0.75,
        style: 0.0,
        use_speaker_boost: true
      }
    })
  }
);

// Response is audio stream (mp3 by default)
const audioBuffer = await response.arrayBuffer();

Query Parameters:

Param	Default	Description
output_format	mp3_44100_128	Audio format
optimize_streaming_latency	0	0-4, higher = faster but lower quality

Voice Settings:

Setting	Range	Description
stability	0-1	Lower = more expressive, Higher = more consistent
similarity_boost	0-1	How closely to match the original voice
style	0-1	Style exaggeration (v2 models only)
use_speaker_boost	bool	Enhance speaker clarity

Environment:

export ELEVENLABS_API_KEY="your-elevenlabs-key"

---

Prompt Engineering

For Nano Banana Pro (Images)

Structure: [Subject] + [Setting] + [Style] + [Technical]

Examples:

Product shot of a minimalist desk lamp on a wooden table, soft natural lighting, commercial photography, 4K resolution

A cyberpunk street market at night, neon signs reflecting on wet pavement, cinematic composition, moody atmosphere

Professional headshot of a confident business woman, studio lighting, neutral background, corporate style

For KLING AI (Video)

Structure: [Camera Movement] + [Subject Action] + [Environment] + [Mood]

Examples:

Camera slowly pushes in on a coffee cup as steam rises, morning kitchen setting, warm and cozy atmosphere

Drone shot ascending over a mountain lake at sunrise, mist rolling across the water, epic and serene

Subject walks toward camera through a busy city street, shallow depth of field, dynamic and urban

For ElevenLabs (Voice)

Script Best Practices:

• Use natural punctuation for pacing
• Add ... for longer pauses
• Use CAPS sparingly for emphasis
• Include pronunciation hints: [Nanotechnology: nan-oh-tek-nol-oh-jee]
• Write conversationally, not formally

---

Production Checklist

Before starting any media production:

• Concept defined: Clear vision of final output
• Script drafted: Narration or dialogue written
• Storyboard created: Scene-by-scene breakdown
• Aspect ratios consistent: All assets match target format
• Voice selected: ElevenLabs voice chosen and tested
• API keys configured: FAL_KEY, KLING_API_KEY, ELEVENLABS_API_KEY

Before compositing:

• Images generated: All Nano Banana assets ready
• Videos rendered: All KLING clips complete
• Audio recorded: All ElevenLabs VO exported
• Music selected: Background music sourced (if needed)
• Timing mapped: Script synced to visual timeline

---

Asset Organization

project-name/
├── 01-planning/
│   ├── concept.md
│   ├── script.md
│   └── storyboard.md
├── 02-images/
│   ├── scene-01-hero.png
│   ├── scene-02-product.png
│   └── scene-03-cta.png
├── 03-videos/
│   ├── scene-01-animated.mp4
│   ├── scene-02-animated.mp4
│   └── transition-01.mp4
├── 04-audio/
│   ├── voiceover-full.mp3
│   ├── voiceover-scene-01.mp3
│   └── background-music.mp3
├── 05-exports/
│   ├── final-1080p.mp4
│   ├── final-4k.mp4
│   └── social-cuts/
└── project-notes.md

---

Cost Estimation

Tool	Pricing Model	Approximate Cost
Nano Banana Pro	Per image	~$0.04-0.10 per 1K image
KLING AI	Per second	~$0.05-0.20 per 5s clip
ElevenLabs	Per character	~$0.30 per 1K characters

Example 60-second video:

• 10 images × $0.08 = $0.80
• 6 video clips × $0.15 = $0.90
• 1000 character script × $0.30 = $0.30
• Total: ~$2.00

---

Integration with ID8 Pipeline

When to Invoke

During these pipeline stages:

• Stage 9 (Launch Prep): Create launch videos, product demos
• Stage 10 (Ship): Marketing assets, social content
• Stage 11 (Listen & Iterate): Testimonial videos, update announcements

Handoff

After completing media production:

1. Save outputs:

   • Assets → project assets/media/ directory
   • Production notes → docs/MEDIA_PRODUCTION.md

2. Log to tracker:

   /tracker log {project-slug} "MEDIA: Produced {asset-type}. {count} images, {count} videos, {duration}s VO."
   

3. Quality check:

   • Preview all assets
   • Verify audio sync
   • Check resolution and format

---

Tool Integration

MCP Tools

firecrawl:

• Research competitor video styles
• Scrape reference content for inspiration

perplexity:

• Research trending video formats
• Find voice style references

Subagents

nana-image-generator:

• Batch image generation with optimized prompts
• Style consistency across image sets

---

Troubleshooting

Common Issues

Issue	Solution
KLING video too static	Add more motion direction in prompt
ElevenLabs pacing too fast	Add punctuation, commas, ellipses
Nano Banana style inconsistent	Include style keywords in every prompt
Video transitions jarring	Use KLING effects mode for smoother cuts
Audio doesn't match timing	Generate VO in segments, not full script

Quality Optimization

For sharper images:

• Use 2K or 4K resolution
• Include "sharp focus" or "high detail" in prompt
• Export as PNG (lossless)

For smoother video:

• Use v2.1-master model
• Keep prompts focused on single action
• Generate 10s clips for more natural motion

For natural voice:

• Set stability to 0.4-0.6
• Use eleven_multilingual_v2 model
• Include natural punctuation in script

---

Anti-Patterns

Avoid	Why	Do Instead
Generating video from text directly	Less control over visuals	Generate image first, then animate
Long VO in single generation	Pacing issues, errors compound	Generate in segments (30s max)
Inconsistent aspect ratios	Compositing nightmare	Lock ratio at start of project
Skipping storyboard	Waste of API credits	Plan shots before generating
Using default voice settings	Generic sound	Tune stability and style per project

---

Media Factory v1.0.0 - Added 2025-12-29