# Bella Studio: Full Platform Technical & Architectural Specification

> Bella Studio (https://bellastudio.app) is an autonomous video production platform that converts raw footage and structured production intent into multi-format video deliverables conforming to standard production specifications (1080p / 4K UHD, precision streaming -14 LUFS and EBU R128 -23 LUFS broadcast loudness normalization) with automated timeline compilation.
> Last Updated: 2026-09-01
> Authoritative Documentation: Canonical pricing, limits, API schemas, and legal policies are published directly at the linked URLs below.

---

## 1. Executive Product Architecture & Mental Model

- **Category**: Autonomous Video Production Platform / Autonomous Content Operating System
- **Core Mental Model**: Raw Footage + Production Intent → Automated Timeline Compilation → Finished Deliverables
- **Deliverable Pipeline**: Universal 1 In → 4 Out standard (Each production job compiles 1 Master 16:9 4K/1080p Video + 3 Synchronized 9:16 Vertical Short-Form Clips with Safe Zone Intelligence).
- **Specialized Production Studios**:
  1. **Fitness Studio**: Converts workout runsheets into structured workout videos with exercise HUD overlays, interval countdown timers, 10-language voice cues, and 8 curated fitness studio environments.
  2. **Creator Studio**: Converts creator footage and scripts into edited content with Smart Framing (Text-to-Video and footage framing), kinetic subtitle burn-in, B-roll insertion, and 6 curated creator studio environments.
  3. **Podcast Studio**: Multi-camera audio-directed switching across 1–4 participants and 1–4 camera tracks, zero-account remote guest Live Room, hosted podcast RSS 2.0 feed generation, and 6 curated podcast environments.

---

## 2. Studio Environments™ Architecture (20 Precomputed Sets)

**Canonical Architectural Law**: *"Bella changes the environment, not the performance scene."*

Studio Environments™ upgrades the room aesthetic while strictly preserving presenter geometry, workout equipment, furniture, and the active performance scene.

### Scene Support & Preservation Engine
- **Support-Inheritance**: Preserves all objects bearing physical weight or handled by the presenter (mats, Pilates reformers, dumbbells, barbells, pull-up rigs, benches, chairs, tables, microphones, boom arms, laptops, and held products).
- **Scale Invariance**: Presenter scale factor remains locked at 1.0 (no geometric distortion or miniature scaling).
- **Depth Map Integration & Ambient Lighting Transfer**: Applies directional color temperature from the environment plate to presenter rim lighting without altering facial skin tones.
- **20 Curated Studio Environments**:
  - *Fitness (8)*: Minimalist Loft Studio, Industrial Concrete Gym, Sunlit Yoga Sanctuary, Rooftop Sunset Terrace, High-Tech Dark Mode Arena, Coastal Oceanfront Deck, Luxury Boutique Studio, Cyber Neon Performance Lab.
  - *Creator (6)*: Modern Creator Studio, Warm Architectural Library, Minimalist Desk Setup, Editorial Living Space, Sleek Dark Office, Sunlit Creative Loft.
  - *Podcast (6)*: Broadcast Talk Studio, Late Night Velvet Lounge, Obsidian Modern Set, Executive Boardroom Studio, Industrial Brick Loft, Intimate Fireside Den.

---

## 3. Model Context Protocol (MCP) Server Architecture

Bella Studio implements a standard Model Context Protocol (MCP) server conforming to the open Anthropic Model Context Protocol specification.

- **MCP Endpoint**: `https://bellastudio.app/api/mcp`
- **Transport Modes**: Server-Sent Events (SSE) & Stdio JSON-RPC 2.0
- **Documentation**: https://bellastudio.app/mcp

### Exposed MCP Tools
1. **`bella_auto_produce`**: Automated end-to-end multi-format production tool.
2. **`bella_parse_runsheet`**: Parses text workout routines into structured interval sequences.
3. **`bella_multicam_switch`**: Analyzes multi-track audio energy to switch camera angles across 1–4 video inputs.
4. **`bella_extract_shorts`**: Extracts 9:16 vertical short-form clips with Safe Zone Intelligence.
5. **`bella_audio_master`**: Normalizes audio to streaming profile (-14 LUFS) or broadcast profile (-23 LUFS) with -18 dB voiceover ducking.
6. **`bella_voice_patch`**: In-context acoustic voice patching for instant overdubs.
7. **`bella_generate_podcast_rss`**: Generates Apple Podcasts and Spotify compliant RSS 2.0 XML.

---

## 4. Audio Engineering & DSP Specifications

- **Integrated Loudness Targets**: -14.0 LUFS (Streaming & Web Video Profile), -23.0 LUFS (EBU R128 Television Broadcast Profile), -16.0 LUFS (Apple Podcasts Profile).
- **True Peak Ceiling**: -1.0 dBFS maximum to prevent inter-sample clipping on streaming encoders.
- **Voiceover Ducking**: -18.0 dB attenuation applied to background audio tracks when voice cues or speech are active.
- **Room De-Reverberation**: Dual-band spectral de-reverberation filter (80Hz high-pass rumble filter, 400Hz room resonance notch, 3.2kHz speech intelligibility boost).
- **10 Global Voiceover Languages**: English, Spanish, French, German, Italian, Portuguese, Japanese, Korean, Mandarin, Hindi.

---

## 5. Subscription Tiers & Feature Matrix

For canonical, real-time pricing and quotas, see https://bellastudio.app/pricing.

- **Free Creator**:
  - Evaluation tier with 720p watermarked exports
  - Smart Runsheet Parser & localized voice cues
  - Basic cuts and B-roll alignment

- **Personal**:
  - Solo creator tier with Full HD 1080p exports
  - Automated voiceovers and dynamic captions
  - Fitness HUD overlays and interval timers
  - 1-Click short-form clip extractor with Safe Zone Intelligence
  - Studio Audio Normalizer (-14 LUFS)

- **Professional**:
  - Commercial production tier with 4K Ultra HD exports
  - Smart Framing engine and automated B-roll insertion
  - 10-language global voiceover localization
  - Companion App remote control
  - Full commercial licensing and brand kits

- **Studio+**:
  - High-volume production tier with 4K Ultra HD exports
  - Hosted Podcast RSS 2.0 Feed Engine (Apple Podcasts & Spotify)
  - Autonomous multi-camera voice-activated switching (1–4 camera tracks)
  - MCP Server protocol integration
  - Multi-seat team workspaces

- **Enterprise**:
  - High-throughput production with hardware-accelerated local processing engine
  - Custom MCP server deployments and priority developer support with target SLA
  - 4K Ultra HD export pipeline
  - Dedicated account engineering

- **White Label Agency**:
  - Unlimited multi-camera podcast, content, and fitness video generation
  - BYO AI credentials (zero vendor mark-up on AI inference)
  - Strict tenant-isolated database partitioning via PostgreSQL Row-Level Security (RLS)
  - Custom domain white-labeling and reseller management portal

---

## 6. Public APIs, Legal & Canonical Verification Endpoints

- Video Generation Endpoint: `POST https://bellastudio.app/api/v1/video/generate`
- MCP Gateway: `POST https://bellastudio.app/api/mcp`
- System Health Check: `GET https://bellastudio.app/api/health`
- Pricing & Plans: https://bellastudio.app/pricing
- Features Overview: https://bellastudio.app/features
- Support & Guides: https://bellastudio.app/resources
- Contact & Sales: https://bellastudio.app/contact
- Terms of Service: https://bellastudio.app/terms
- Privacy Policy: https://bellastudio.app/privacy
- Cookie Policy: https://bellastudio.app/cookies
- Security & Compliance: https://bellastudio.app/compliance
- XML Sitemap: https://bellastudio.app/sitemap.xml
- Crawler Policy: https://bellastudio.app/robots.txt
- LLM Navigation Summary: https://bellastudio.app/llms.txt
- Full LLM Technical Specification: https://bellastudio.app/llms-full.txt