File size: 2,077 Bytes
4d893f9 5f62ec5 dc81965 66710f8 4d893f9 5f62ec5 dc81965 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 |
---
title: StoryLens
emoji: 🎬
colorFrom: green
colorTo: blue
sdk: streamlit
sdk_version: 1.53.0
app_file: app.py
pinned: false
license: apache-2.0
---
# 🎬 StoryLens
Professional video ad narrative structure analyzer powered by AI. Diagnose your ad's storytelling effectiveness in 60 seconds.
## ✨ Features
- **Multi-source Input**: Upload video files (MP4, MOV, AVI, WebM) or paste YouTube URL
- **AI-Powered Analysis**: MiniMax Vision for frame analysis, OpenAI Whisper for transcription
- **Functional Role Classification**: 21 roles across 5 categories (Opening, Problem, Product, Persuasive, Closure)
- **Story Arc Detection**: Identifies patterns like AIDA, PAS, HFBA, and more
- **Industry Benchmarks**: Recommendations based on Meta research (WWW 2026)
- **Actionable Insights**: Prioritized recommendations with expected performance uplift
## 🚀 Quick Start
1. Configure API keys in sidebar:
- **MiniMax API Key** + Group ID (for vision & LLM)
- **OpenAI API Key** (for Whisper transcription)
2. Select your **Industry** and **Campaign Goal**
3. Upload video file or paste YouTube URL
4. Click **"Analyze"**
5. Review narrative timeline, story arc, and recommendations
## 🔑 API Keys Required
- **MiniMax**: Get from [MiniMax Platform](https://platform.minimax.io/)
- **OpenAI**: Get from [OpenAI Platform](https://platform.openai.com/)
## 📊 Supported Industries
- Apparel & Accessories
- Beauty
- Food
- Beverages
- Other
## 🎯 Campaign Goals
- Retention (Dwell Rate)
- Click-Through (CTR)
- Conversions (CVR)
## 📚 Based On
Research paper: *MLLM-VADStory: Domain Knowledge-Driven Multimodal LLMs for Video Ad Storyline Insights* (Meta, WWW 2026)
## 🛡️ Privacy
- API keys never stored permanently
- Videos processed temporarily only
- No data retention
## 📄 License
Licensed under **Apache License 2.0**
## 👨💻 Author
**Marek Staniszewski**
**Heuristica**
🌐 [www.heuristica.pl](https://www.heuristica.pl)
📧 staniszewski@heuristica.pl
For questions, suggestions, or support, please contact the author. |