Lux Studio

AI-powered cinematography suite for professional image and video generation. Combines physics-based prompt engineering with Google's Imagen 3 and Veo 3.1 APIs.

Features

Image Generation (Imagen 3)

• Cinematographer's Toolkit: 40+ lighting presets, 8 camera bodies, 10 lens profiles
• Physics-Based Prompts: AI enhances prompts with real camera/lens characteristics
• Reference Images: Style transfer with up to 14 reference images
• Iterative Editing: Refine images with natural language

Video Generation (Veo 3.1)

• Text-to-Video & Image-to-Video: Generate from prompts or reference frames
• AI Prompt Optimizer: Intelligent inference of camera movement and subject action
• Native Audio: Veo 3's built-in audio generation with dialogue support
• Frame Extraction: Pull stills from generated videos

Project Management

• Project-First Workflow: Organize generations into projects
• Local Storage: IndexedDB-based, no server required
• Cross-Tab Usage: Use generated images as video reference frames

Tech Stack

• Frontend: React + Vite + Tailwind CSS
• Backend: PHP 7.4+
• AI Models:
  • Google Imagen 3 (image generation)
  • Google Veo 3.1 (video generation)
  • Google Gemini (prompt optimization)

Installation

1. Clone & Install

git clone git@bitbucket.org:zlalani/cinema-studio-pro.git
cd cinema-studio-pro/Prompt_Studio
npm install

2. Configure API Keys

Copy the example config and add your Google AI API key:

cp config.example.php config.php

Edit config.php:

define('GEMINI_API_KEY', 'your-api-key-here');

For the frontend, create Prompt_Studio/.env:

VITE_GEMINI_API_KEY=your-api-key-here

Get your API key from Google AI Studio.

3. Start Development Servers

Terminal 1 - PHP Backend:

php -S localhost:8000

Terminal 2 - Vite Frontend:

cd Prompt_Studio
npm run dev

Visit: http://localhost:5173

Usage

Image Generation

1. Select a project (or create one)
2. Go to Image Gen tab
3. Choose Application/Lighting preset (auto-configures camera + lens)
4. Enter scene description
5. Click Optimize then Generate Image

The AI adds physics-based characteristics:

• Camera sensor behavior (grain, dynamic range)
• Lens optical traits (bokeh, flares, aberrations)
• Lighting setup from preset

Video Generation

1. Select a project
2. Go to Video Gen tab
3. Enter scene description
4. Optionally add:
   • Reference images (first frame for I2V)
   • Dialogue (Veo 3 native audio)
5. Click Optimize - AI infers missing cinematography in [brackets]
6. Edit suggestions if needed, then Generate Video

Example prompt optimization:

Input: "Woman crosses street"
Output: "Woman crosses a street. [Camera: tracking, follows woman] (Sound: [footsteps, distant traffic])"

Project Workflow

• Projects tab is the landing page
• Create/select a project before generating
• All generations auto-save to active project
• Extract video frames and add to project
• Use project images as video reference frames

File Structure

lux-studio/
├── Prompt_Studio/           # React frontend
│   ├── src/
│   │   ├── components/
│   │   │   ├── CinePromptStudio.jsx  # Image generation
│   │   │   ├── VideoGenTab.jsx       # Video generation
│   │   │   ├── ProjectsTab.jsx       # Project management
│   │   │   └── VideoPlayer.jsx       # Video playback + frame extraction
│   │   └── hooks/
│   │       └── useProjects.js        # IndexedDB project storage
│   └── public/
├── api.php                  # Image generation API
├── video_api.php            # Video generation API
├── stream_video.php         # Video streaming with Range support
├── config.example.php       # Config template
└── LOGO/                    # Brand assets

API Pricing (approximate)

Imagen 3

• 1K/2K images: ~$0.03 per image
• 4K images: ~$0.06 per image

Veo 3.1

• 4s video: ~$0.20
• 6s video: ~$0.30
• 8s video: ~$0.40

Camera & Lens Profiles

Cameras

• Arri Alexa 35 (Hollywood standard)
• Sony Venice 2 (low-light king)
• Red V-Raptor (hyper-real action)
• Arriflex 416 (Super 16 film)
• Arricam LT (35mm film)
• Fujifilm GFX 100 (medium format)
• Phantom Flex4K (high-speed)
• Blackmagic URSA Cine 12K

Lenses

• Panavision C-Series (anamorphic)
• Cooke S7/i (the "Cooke Look")
• Canon K-35 (vintage glow)
• Arri Signature (modern clean)
• Zeiss Super Speed (16mm classic)
• Helios 44-2 (swirly bokeh)
• And more...

Security

Files excluded from repository:

• config.php - contains API key
• .env files
• uploads/ - user sessions
• generated_videos/ - generated content

Never commit API keys. Use config.example.php as reference.

License

MIT