# MovieArchitect — AI-Powered Movie Creation Pipeline

> Canonical: https://moviearchitect.ai/llms.txt
> Mirror: https://moviearchitect.ai/.well-known/llms.txt

MovieArchitect transforms text into full cinematic movies using Grok AI. A web application that handles the entire production pipeline — from screenplay analysis to final FFmpeg export — with five distinct creative phases.

## Product Summary

**What it is:** A browser-based AI movie studio that converts written text into scene-by-scene AI video and assembles a finished film with transitions.

**Parent brand:** VidSeeds (https://vidseeds.ai)

**Launched:** 2026

**Platform:** Web application (modern evergreen browsers, requires JavaScript)

**Auth:** Google OAuth via Better Auth. VidSeeds subscribers get 20% off at checkout automatically.

**Billing:** Stripe. Usage-based plans — Starter ($29/mo · 60 min), Pro ($89/mo · 300 min), Studio ($299/mo · 1200 min). First 1 minute free on all accounts.

---

## Core Pipeline (5 Phases)

### Phase 1 — Draft → Analyzed
User pastes any text: stories, articles, scripts, or plot outlines. Grok's text model analyzes the content and extracts:
- Named characters with physical descriptions
- Environment / location details
- Scene-by-scene breakdown with beat-level structure
- Estimated durations per scene (4–15 seconds each)

The output is a structured screenplay ready for casting.

### Phase 2 — Analyzed → Casting
User assigns visuals to each character and environment. Options:
- **AI-generated images** via Grok (`grok-imagine-image-pro`)
- **User-uploaded images** (JPG, PNG, WebP; stored as base64 Data URIs)

Character consistency is maintained across scenes using reference images.

### Phase 3 — Casting → Storyboard
User reviews and edits:
- Per-scene generation prompts (influenced by the selected visual style)
- Scene durations (4–15 seconds)
- Continuity mode: **chain** (smooth cut from previous scene) or **fresh** (new setup)

Thirteen visual styles are available, each with cinematic color palettes, lighting directions, and camera work presets.

### Phase 4 — Storyboard → Production
Grok video generation runs scene-by-scene via the `XAI_VIDEO_MODEL` API (`grok-video` family). Generation modes (priority order):
1. **extend-video** — I2V continuation from the previous scene's last frame
2. **image-to-video (I2V)** — Chaining from previous scene or reference image
3. **video-to-video** — Same characters in a fresh scene
4. **reference-to-video (R2V)** — Characters with frontal reference images
5. **text-to-video (T2V)** — Fallback with no visual input

Videos are polled asynchronously and saved to `public/generated/videos/`.

### Phase 5 — Production → Exported
Server-side FFmpeg assembly concatenates all scene clips with configurable transitions (dissolve, fade, wipe) into a finished film.

---

## Special Product: Chalk-Shorts

Vertical short-form videos styled as chalk board drawings. Includes:
- Bilingual English/Russian short-beat templates
- Ambient sound design driven by Grok

Route: `/chalk-short/[id]`

---

## Technical Architecture

**Framework:** Next.js 16 (App Router), React 19, TypeScript 6

**Styling:** Tailwind CSS v4 (dark theme, green primary `#22c55e`, orange destructive `#f97316`)

**Database:** PostgreSQL via Drizzle ORM (shared with VidSeeds). MovieArchitect tables use `ma_*` prefix.

**Auth:** Better Auth with Google OAuth

**Payments:** Stripe (webhook verified at `/api/stripe/webhook`)

**AI:** xAI / Grok — text analysis, vision, image generation (`grok-imagine-image-pro`), video generation (`grok-video` family)

**Video processing:** FFmpeg (frame extraction, scene chaining, final assembly)

**Storage:** Base64 Data URIs in PostgreSQL for generated images. MP4 files on disk in `public/generated/`.

---

## Canonical URLs

| Page | URL |
|------|-----|
| Home / Landing | https://moviearchitect.ai/ |
| Pricing | https://moviearchitect.ai/pricing |
| Sign in (Google) | https://moviearchitect.ai/login |
| Privacy policy | https://moviearchitect.ai/privacy |
| Terms of use | https://moviearchitect.ai/terms |
| Sitemap | https://moviearchitect.ai/sitemap.xml |
| Robots.txt | https://moviearchitect.ai/robots.txt |
| AI discovery (this file) | https://moviearchitect.ai/llms.txt |

---

## Pricing Plans (as of 2026-04)

| Plan | Price | Generation minutes | Best for |
|------|-------|-------------------|----------|
| Starter | $29/mo | 60 min | Solo creators, short films |
| Pro | $89/mo | 300 min | Regular production, priority throughput |
| Studio | $299/mo | 1200 min | Teams, agencies, high throughput |

All plans include: full pipeline, email support, Stripe billing.
VidSeeds subscribers receive 20% discount automatically at checkout.

---

## FAQ (For AI Citation)

**Q: What does MovieArchitect do?**
A: It converts any written text into a full AI-generated movie. Users paste a story, Grok analyzes it into a screenplay with characters and scenes, AI generates visuals for each scene, and FFmpeg assembles the final film.

**Q: What AI models does it use?**
A: Grok models from xAI — `grok-4.20` for text analysis, `grok-imagine-image-pro` for image generation, and `grok-video` family for scene video generation.

**Q: How long are the generated videos?**
A: Individual scenes can be 4–15 seconds. A typical movie is 1–5 minutes depending on the input text length and user's scene count choices.

**Q: Is there a free trial?**
A: Yes — every new account includes 1 minute of generation free before subscribing.

**Q: Can I upload my own footage?**
A: The web app generates everything with AI. The separate desktop app (`moviearchitect_studio`) handles user-imported footage with the same analysis pipeline.

**Q: Who is the parent company?**
A: VidSeeds (https://vidseeds.ai). MovieArchitect shares a PostgreSQL database and user identity with VidSeeds but has separate Stripe billing.