Video Asset Manager

Source, download, and organize video clips for music video production using Pexels API and GenSpark AI generation.

Workflow

1. Input: Scene Plan JSON

Receive scene plan from creative-director skill:

{
  "scenes": [
    {
      "sceneNumber": 1,
      "clipKeywords": ["sunrise", "mountains", "golden hour"],
      "duration": 15
    }
  ]
}

2. Search Pexels for Stock Footage

Pexels API Access:

• Credentials: Ask McKinzie for Pexels API key
• Endpoint: https://api.pexels.com/videos/search
• Rate limit: 200 requests/hour (free tier)

Search strategy:

1. For each scene, search using clipKeywords
2. Filter by:
   • Orientation (landscape for YouTube, square/vertical for social)
   • Duration (prefer clips ≥ scene duration)
   • Quality (HD minimum, 4K preferred)
3. Download top 2-3 options per scene for flexibility

Pexels search script: See scripts/search_pexels.py

3. Generate AI Clips with GenSpark (PREFERRED METHOD)

When to use GenSpark:

• Abstract concepts (faith, hope, spiritual themes)
• Scenes where stock footage doesn't match
• Unique/custom visuals not available in stock libraries
• Cinematic quality needed (better than stock footage)
• Full music video production (all clips AI-generated)

⚡ BATCH WORKFLOW (FAST - USE THIS!):

See full documentation: references/genspark-batch-workflow.md

1. Prepare all prompts in numbered list format:

   Generate [N] videos using PixVerse model, 16:9 aspect ratio, 4K resolution:
   
   1. [Detailed cinematic prompt for scene 1]
   2. [Detailed cinematic prompt for scene 2]
   ... etc
   

2. Submit to GenSpark:

   • Go to https://www.genspark.ai (main homepage)
   • Paste ENTIRE prompt list into main textbox
   • Press Enter

3. Confirm generation:

   • GenSpark will ask to confirm
   • Reply: "A) Proceed with all [N] videos now. Use 8 second duration, 16:9 aspect ratio."

4. Wait for completion:

   • PixVerse: ~30 seconds per video
   • 21 videos ≈ 15-20 minutes total
   • Videos generate in parallel

5. Download all clips when complete

Model: PixVerse (official/pixverse/v5) - fast, high quality Duration: 5s or 8s (prefer 8s for music videos) Aspect: 16:9 landscape, 9:16 for shorts

Prompt tips for cinematic quality:

• Include camera movement: "slow push-in", "overhead drift"
• Specify lighting: "golden hour", "soft window backlight"
• Add film aesthetic: "35mm film grain", "shallow depth of field"
• Describe mood: "contemplative", "nostalgic", "ethereal"

4. Organize Assets

Folder structure:

project-name/
├── assets/
│   ├── scene-01-sunrise-mountains.mp4
│   ├── scene-02-walking-forest.mp4
│   ├── scene-03-ai-faith-abstract.mp4
│   └── scene-04-ocean-waves.mp4
├── scene-plan.json
└── asset-manifest.json

Asset manifest:

{
  "projectName": "Song Title - Music Video",
  "createdAt": "2026-01-29",
  "assets": [
    {
      "sceneNumber": 1,
      "filename": "scene-01-sunrise-mountains.mp4",
      "source": "pexels",
      "pexelsId": "12345678",
      "duration": 18,
      "resolution": "1920x1080",
      "keywords": ["sunrise", "mountains", "golden hour"]
    },
    {
      "sceneNumber": 3,
      "filename": "scene-03-ai-faith-abstract.mp4",
      "source": "genspark",
      "prompt": "abstract light rays representing faith and hope",
      "duration": 10,
      "resolution": "1920x1080"
    }
  ]
}

5. Quality Check

Before passing to music-video-producer:

• All scenes have at least 1 clip sourced
• Clip durations ≥ scene duration (allow trimming)
• Resolution is consistent (1080p minimum)
• Files downloaded and playable
• Asset manifest generated
• Folder organized and labeled

Scripts

scripts/search_pexels.py

Search and download clips from Pexels:

python scripts/search_pexels.py \
  --scene-plan scene-plan.json \
  --output-dir assets/ \
  --api-key $PEXELS_API_KEY \
  --top-n 2

See scripts/search_pexels.py for implementation.

scripts/generate_genspark.py

Generate AI clips with GenSpark:

python scripts/generate_genspark.py \
  --scene-plan scene-plan.json \
  --scenes 3,5,7 \
  --output-dir assets/

See scripts/generate_genspark.py for implementation.

Reference Files

• references/pexels-api-docs.md - Pexels API usage and examples
• references/genspark-prompts.md - Effective prompts for AI video generation
• references/genspark-batch-workflow.md - Batch video generation process
• references/genspark-download-workflow.md - Downloading from AI Drive
• references/video-quality-standards.md - Resolution, format, codec requirements

Deliverables

1. Downloaded video clips - Organized in assets/ folder
2. Asset manifest JSON - Metadata for each clip
3. Coverage report - Which scenes have clips, which need alternatives

Error Handling

If Pexels search returns no results:

• Try alternate keywords (synonyms)
• Expand search to related concepts
• Flag scene for GenSpark AI generation

If clip quality is low:

• Search for HD/4K alternatives
• Consider upscaling with AI (Topaz Video AI)
• Flag for manual review

If API rate limit hit:

• Queue remaining searches
• Resume after cooldown period
• Report estimated completion time