From 158d0fea1fa8e267f9e77aafc1f359ae37781beb Mon Sep 17 00:00:00 2001
From: ukimsanov <ularkimsanov7@gmail.com>
Date: Tue, 4 Aug 2026 11:33:52 -0700
Subject: [PATCH] docs: stop serving render masters as if they were
 deliverables
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Thirty-two published videos were the raw render output. One 20-second catalog
preview was 60 MB at 25 Mbps — Blu-ray bitrate for a screen capture in a docs
page. Nothing autoplays, so no page shipped that silently, but a reader who
pressed play paid for it.

Re-encoded at 1280 wide, CRF 28, faststart, keeping audio where it existed.
Measured PSNR against the originals at ~38.5 dB, which is visually identical —
the first check I ran returned nothing and I mistook that for a pass, so this
number comes from a filter that actually worked.

Worth correcting one thing I said earlier: the catalog is not systemically
over-encoded. 190 videos, 0.36 GB, about 1.9 MB each. Six were over 10 MB. I
found two monsters and generalised from them.

Pages carrying more than 8 MB of video: 26 before, and the heaviest went from
140 MB to under 15 MB.

The durable fix is in generate-catalog-previews.ts, which had no delivery encode
at all — it published the render master directly. It has a web pass now, so the
next preview is born small instead of being cleaned up later.
---
 docs/catalog/blocks/ios26-liquid-glass.mdx           |  2 +-
 docs/catalog/blocks/liquid-glass-media-controls.mdx  |  2 +-
 docs/catalog/blocks/liquid-glass-widgets.mdx         |  2 +-
 docs/catalog/blocks/macos-tahoe-liquid-glass.mdx     |  2 +-
 docs/catalog/blocks/vfx-liquid-background.mdx        |  2 +-
 docs/catalog/blocks/vfx-liquid-glass.mdx             |  2 +-
 docs/catalog/blocks/vfx-magnetic.mdx                 |  2 +-
 docs/catalog/blocks/vfx-text-cursor.mdx              |  2 +-
 docs/catalog/blocks/yt-lcd-background.mdx            |  2 +-
 docs/catalog/components/caption-blend-difference.mdx |  2 +-
 docs/developers/index.mdx                            |  2 +-
 docs/go-further.mdx                                  |  2 +-
 docs/guides/avatar-presenter.mdx                     |  2 +-
 docs/guides/music-to-video.mdx                       |  2 +-
 docs/introduction.mdx                                |  2 +-
 docs/prompting/capstone.mdx                          |  4 ++--
 docs/prompting/captions-and-talking-heads.mdx        |  2 +-
 docs/prompting/code-and-prs.mdx                      |  2 +-
 docs/prompting/color-grading.mdx                     |  4 ++--
 docs/prompting/examples.mdx                          | 10 +++++-----
 docs/prompting/explainers.mdx                        |  2 +-
 docs/prompting/music-and-slideshows.mdx              |  2 +-
 docs/prompting/overview.mdx                          |  6 +++---
 docs/prompting/product-launch.mdx                    |  4 ++--
 docs/prompting/recreating-references.mdx             |  2 +-
 docs/prompting/vfx-and-liquid-glass.mdx              |  2 +-
 docs/prompting/visual-specs.mdx                      |  2 +-
 docs/quickstart.mdx                                  |  2 +-
 docs/weekly-updates.mdx                              |  6 +++---
 29 files changed, 40 insertions(+), 40 deletions(-)

diff --git a/docs/catalog/blocks/ios26-liquid-glass.mdx b/docs/catalog/blocks/ios26-liquid-glass.mdx
index d7d574afc..c02c5a6c0 100644
--- a/docs/catalog/blocks/ios26-liquid-glass.mdx
+++ b/docs/catalog/blocks/ios26-liquid-glass.mdx
@@ -3,7 +3,7 @@ title: "iOS 26 Liquid Glass Home Screen"
 description: "3D iPhone with a normal iOS 26 home screen, liquid glass app icons, shader wallpaper, dock, and fluid glass notifications that drop from the status area onto a GLTF device model."
 ---
 
-<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/ios26-liquid-glass.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/ios26-liquid-glass.png" autoPlay muted loop playsInline />
+<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/ios26-liquid-glass-v2.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/ios26-liquid-glass.png" autoPlay muted loop playsInline />
 
 ## Install
 
diff --git a/docs/catalog/blocks/liquid-glass-media-controls.mdx b/docs/catalog/blocks/liquid-glass-media-controls.mdx
index 5a9717a22..43e537e48 100644
--- a/docs/catalog/blocks/liquid-glass-media-controls.mdx
+++ b/docs/catalog/blocks/liquid-glass-media-controls.mdx
@@ -3,7 +3,7 @@ title: "Liquid Glass Media Controls"
 description: "Frosted glass media control panels spreading over an aurora shader background"
 ---
 
-<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/liquid-glass-media-controls.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/liquid-glass-media-controls.png" autoPlay muted loop playsInline />
+<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/liquid-glass-media-controls-v2.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/liquid-glass-media-controls.png" autoPlay muted loop playsInline />
 
 ## Install
 
diff --git a/docs/catalog/blocks/liquid-glass-widgets.mdx b/docs/catalog/blocks/liquid-glass-widgets.mdx
index a78c969a3..de40611ed 100644
--- a/docs/catalog/blocks/liquid-glass-widgets.mdx
+++ b/docs/catalog/blocks/liquid-glass-widgets.mdx
@@ -3,7 +3,7 @@ title: "Liquid Glass Widgets"
 description: "Frosted glass stat cards, showcase panel and pill chips over an aurora shader background"
 ---
 
-<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/liquid-glass-widgets.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/liquid-glass-widgets.png" autoPlay muted loop playsInline />
+<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/liquid-glass-widgets-v2.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/liquid-glass-widgets.png" autoPlay muted loop playsInline />
 
 ## Install
 
diff --git a/docs/catalog/blocks/macos-tahoe-liquid-glass.mdx b/docs/catalog/blocks/macos-tahoe-liquid-glass.mdx
index 8855852b2..b682daf07 100644
--- a/docs/catalog/blocks/macos-tahoe-liquid-glass.mdx
+++ b/docs/catalog/blocks/macos-tahoe-liquid-glass.mdx
@@ -3,7 +3,7 @@ title: "macOS Tahoe Liquid Glass Desktop"
 description: "3D MacBook with a macOS Tahoe-style desktop, glass menu bar, Finder window, dock, and cinematic device camera move."
 ---
 
-<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/macos-tahoe-liquid-glass.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/macos-tahoe-liquid-glass.png" autoPlay muted loop playsInline />
+<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/macos-tahoe-liquid-glass-v2.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/macos-tahoe-liquid-glass.png" autoPlay muted loop playsInline />
 
 ## Install
 
diff --git a/docs/catalog/blocks/vfx-liquid-background.mdx b/docs/catalog/blocks/vfx-liquid-background.mdx
index 0feda3266..d26bd8b08 100644
--- a/docs/catalog/blocks/vfx-liquid-background.mdx
+++ b/docs/catalog/blocks/vfx-liquid-background.mdx
@@ -3,7 +3,7 @@ title: "Liquid Background"
 description: "Organic liquid simulation with vertex displacement on a subdivided plane. HTML content floats above rippling fluid surface with real-time wave dynamics."
 ---
 
-<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-liquid-background.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-liquid-background.png" autoPlay muted loop playsInline />
+<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-liquid-background-v2.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-liquid-background.png" autoPlay muted loop playsInline />
 
 ## Install
 
diff --git a/docs/catalog/blocks/vfx-liquid-glass.mdx b/docs/catalog/blocks/vfx-liquid-glass.mdx
index 017b9a016..189584315 100644
--- a/docs/catalog/blocks/vfx-liquid-glass.mdx
+++ b/docs/catalog/blocks/vfx-liquid-glass.mdx
@@ -3,7 +3,7 @@ title: "Liquid Glass"
 description: "VFX composition block"
 ---
 
-<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-liquid-glass.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-liquid-glass.png" autoPlay muted loop playsInline />
+<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-liquid-glass-v2.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-liquid-glass.png" autoPlay muted loop playsInline />
 
 ## Install
 
diff --git a/docs/catalog/blocks/vfx-magnetic.mdx b/docs/catalog/blocks/vfx-magnetic.mdx
index 8cfc47969..61caf4101 100644
--- a/docs/catalog/blocks/vfx-magnetic.mdx
+++ b/docs/catalog/blocks/vfx-magnetic.mdx
@@ -3,7 +3,7 @@ title: "Magnetic"
 description: "VFX composition block"
 ---
 
-<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-magnetic.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-magnetic.png" autoPlay muted loop playsInline />
+<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-magnetic-v2.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-magnetic.png" autoPlay muted loop playsInline />
 
 ## Install
 
diff --git a/docs/catalog/blocks/vfx-text-cursor.mdx b/docs/catalog/blocks/vfx-text-cursor.mdx
index 908af3755..2162fd26e 100644
--- a/docs/catalog/blocks/vfx-text-cursor.mdx
+++ b/docs/catalog/blocks/vfx-text-cursor.mdx
@@ -3,7 +3,7 @@ title: "VFX Text Cursor"
 description: "Dramatic text reveal with cursor glow, chromatic shadow rays, and directional lighting on a black stage. Canvas-based shader post-processing with spectral color edges."
 ---
 
-<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-text-cursor.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-text-cursor.png" autoPlay muted loop playsInline />
+<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-text-cursor-v2.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vfx-text-cursor.png" autoPlay muted loop playsInline />
 
 ## Install
 
diff --git a/docs/catalog/blocks/yt-lcd-background.mdx b/docs/catalog/blocks/yt-lcd-background.mdx
index 14d1a7a99..3c39bebb7 100644
--- a/docs/catalog/blocks/yt-lcd-background.mdx
+++ b/docs/catalog/blocks/yt-lcd-background.mdx
@@ -3,7 +3,7 @@ title: "Scanline Board Background"
 description: "Textured paper board: scanlines with slow drift, optional pixel grid, static grain, and display text with a blur-focus entrance and chromatic-fringe title"
 ---
 
-<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/yt-lcd-background.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/yt-lcd-background.png" autoPlay muted loop playsInline />
+<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/yt-lcd-background-v2.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/yt-lcd-background.png" autoPlay muted loop playsInline />
 
 ## Install
 
diff --git a/docs/catalog/components/caption-blend-difference.mdx b/docs/catalog/components/caption-blend-difference.mdx
index 3b54f4220..69b23951e 100644
--- a/docs/catalog/components/caption-blend-difference.mdx
+++ b/docs/catalog/components/caption-blend-difference.mdx
@@ -3,7 +3,7 @@ title: "Blend Difference"
 description: "Auto-inverting text using mix-blend-mode: difference — flips between white and black per-pixel against the background"
 ---
 
-<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/components/caption-blend-difference.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/components/caption-blend-difference.png" autoPlay muted loop playsInline />
+<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/components/caption-blend-difference-v2.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/components/caption-blend-difference.png" autoPlay muted loop playsInline />
 
 ## Install
 
diff --git a/docs/developers/index.mdx b/docs/developers/index.mdx
index 60dd10874..247fa2bf4 100644
--- a/docs/developers/index.mdx
+++ b/docs/developers/index.mdx
@@ -9,7 +9,7 @@ import { DocsVideo } from "/snippets/docs-video.jsx";
 <div className="hf-docs-video-frame">
   <DocsVideo
     title="A HyperFrames composition shown through the CLI, SDK, Player, and rendering infrastructure."
-    src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-developers-v3.mp4"
+    src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-developers-v3-v2.mp4"
     poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-developers-v3.jpg"
   />
 </div>
diff --git a/docs/go-further.mdx b/docs/go-further.mdx
index e74504bed..9722f11fe 100644
--- a/docs/go-further.mdx
+++ b/docs/go-further.mdx
@@ -10,7 +10,7 @@ import { DocsVideo } from "/snippets/docs-video.jsx";
 <div className="hf-docs-video-frame">
   <DocsVideo
     title="An existing HyperFrames project is revised with an agent, edited in Studio, enriched, checked, and rendered."
-    src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-go-further-v3.mp4"
+    src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-go-further-v3-v2.mp4"
     poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-go-further-v3.jpg"
   />
 </div>
diff --git a/docs/guides/avatar-presenter.mdx b/docs/guides/avatar-presenter.mdx
index 801833663..41ff85e1b 100644
--- a/docs/guides/avatar-presenter.mdx
+++ b/docs/guides/avatar-presenter.mdx
@@ -13,7 +13,7 @@ music, and the final composition.
 <Frame caption="A presenter clip remains the source footage while HyperFrames adds the caption rail and emphasis layer around it.">
   <DocsVideo
     title="Presenter footage with a readable caption rail and an emphasis moment"
-    src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/captions-anchor-rail.mp4#t=0.1"
+    src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/captions-anchor-rail-v2.mp4#t=0.1"
     poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/avatar-presenter-caption-rail-v1.jpg"
   />
 </Frame>
diff --git a/docs/guides/music-to-video.mdx b/docs/guides/music-to-video.mdx
index 068a4250d..94b1c00a9 100644
--- a/docs/guides/music-to-video.mdx
+++ b/docs/guides/music-to-video.mdx
@@ -11,7 +11,7 @@ Start with a music file—or a video whose audio should control the edit. Narrat
 <Frame caption="A complete music-driven film. Its sections, visual treatments, and cuts follow the track.">
   <DocsVideo
     title="A complete music-driven film"
-    src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/full-music.mp4"
+    src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/full-music-v2.mp4"
     poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/wfv2-music.jpg"
   />
 </Frame>
diff --git a/docs/introduction.mdx b/docs/introduction.mdx
index e05660e4b..8c406b950 100644
--- a/docs/introduction.mdx
+++ b/docs/introduction.mdx
@@ -9,7 +9,7 @@ import { DocsVideo, ShowcaseWall } from "/snippets/docs-video.jsx";
 <div className="hf-docs-video-frame">
   <DocsVideo
     title="What is HyperFrames?"
-    src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-introduction-v5.mp4"
+    src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-introduction-v5-v2.mp4"
     poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-introduction-v5.jpg"
   />
 </div>
diff --git a/docs/prompting/capstone.mdx b/docs/prompting/capstone.mdx
index b821c1ea7..4c38cacf1 100644
--- a/docs/prompting/capstone.mdx
+++ b/docs/prompting/capstone.mdx
@@ -3,7 +3,7 @@ title: Capstone — every technique, one journey
 description: "One prompt, one unbroken camera move, and every technique in this guide joined into a single 62-second film."
 ---
 
-<video controls muted loop playsinline preload="metadata" src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/capstone-timeline-default.mp4#t=0.1" style={{ borderRadius: "0.5rem", marginTop: "0.75rem" }}></video>
+<video controls muted loop playsinline preload="metadata" src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/capstone-timeline-default-v2.mp4#t=0.1" style={{ borderRadius: "0.5rem", marginTop: "0.75rem" }}></video>
 *"The Timeline" — 1920x1080, ~62 seconds, one prompt, one unbroken camera move, unedited.*
 
 One prompt made this. Nothing was cut or stitched together afterward. The prompt asked for about 60 seconds. The render came back at 1:02, because the closing lockup holds for a two-second breath.
@@ -139,7 +139,7 @@ The new wrinkle is the world. It is one wide scene space that a camera transform
 hyperframes render --variables '{"ground":"#0d1420","ink":"#c8ff3d"}' --strict-variables
 ```
 
-<video controls muted loop playsinline preload="metadata" src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/capstone-timeline-reskin.mp4#t=0.1" style={{ borderRadius: "0.5rem", marginTop: "0.75rem" }}></video>
+<video controls muted loop playsinline preload="metadata" src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/capstone-timeline-reskin-v2.mp4#t=0.1" style={{ borderRadius: "0.5rem", marginTop: "0.75rem" }}></video>
 *The same composition, navy and acid green — the wire, ruler, chart, map, glass, and even the generated mural all follow the override.*
 
 The mural trick from the previous capstone carries over. The artwork is generated in grayscale, then duotoned live by CSS layers driven by the `ground` and `ink` variables. Even the raster re-skins. Keep color in CSS and shapes in the raster whenever a template frame needs to survive a re-skin.
diff --git a/docs/prompting/captions-and-talking-heads.mdx b/docs/prompting/captions-and-talking-heads.mdx
index dd3b983ca..33e582311 100644
--- a/docs/prompting/captions-and-talking-heads.mdx
+++ b/docs/prompting/captions-and-talking-heads.mdx
@@ -17,7 +17,7 @@ Captions route by **identity**, not by mode. You pick one look from the catalog;
 
 <DocsVideo
   title="HyperFrames video: Captions Anchor Rail"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/captions-anchor-rail.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/captions-anchor-rail-v2.mp4#t=0.1"
   loop
 />
 *Rendered from the prompt above on generated avatar footage, unedited — one earned embed behind the speaker, everything else on the rail.*
diff --git a/docs/prompting/code-and-prs.mdx b/docs/prompting/code-and-prs.mdx
index 8486012ff..7da9af3b9 100644
--- a/docs/prompting/code-and-prs.mdx
+++ b/docs/prompting/code-and-prs.mdx
@@ -17,7 +17,7 @@ Verified, from the [examples](/prompting/examples) page — a 30-second feature
 
 <DocsVideo
   title="HyperFrames video: Example Pr Video"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-pr-video.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-pr-video-v2.mp4#t=0.1"
   loop
 />
 *Rendered from the prompt above, unedited.*
diff --git a/docs/prompting/color-grading.mdx b/docs/prompting/color-grading.mdx
index c5993ed3c..b1f13428c 100644
--- a/docs/prompting/color-grading.mdx
+++ b/docs/prompting/color-grading.mdx
@@ -107,7 +107,7 @@ Three ways to take the image apart, each saying something different. Pixelation
 
 <DocsVideo
   title="HyperFrames video: Grade Painterly Ffd5c0f9"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/grade-painterly-ffd5c0f9.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/grade-painterly-ffd5c0f9-v2.mp4#t=0.1"
   loop
 />
 *Kuwahara at full strength, on a subject with enough edges to be worth preserving.*
@@ -122,7 +122,7 @@ Three ways to take the image apart, each saying something different. Pixelation
 
 <DocsVideo
   title="HyperFrames video: Grade Two Ink Press 3c5662f1"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/grade-two-ink-press-3c5662f1.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/grade-two-ink-press-3c5662f1-v2.mp4#t=0.1"
   loop
 />
 *Ten hue families collapsing to three. Dense type is the harshest test of a two-ink reduction.*
diff --git a/docs/prompting/examples.mdx b/docs/prompting/examples.mdx
index 381f69f08..d48f48904 100644
--- a/docs/prompting/examples.mdx
+++ b/docs/prompting/examples.mdx
@@ -62,7 +62,7 @@ Every prompt below has been run end-to-end and one-shots a finished video that p
 
       <DocsVideo
         title="HyperFrames video: Example Product Launch"
-        src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-product-launch.mp4#t=0.1"
+        src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-product-launch-v2.mp4#t=0.1"
         loop
       />
     *Rendered from the prompt above, unedited.*
@@ -73,7 +73,7 @@ Every prompt below has been run end-to-end and one-shots a finished video that p
     With a verbatim script, final duration follows the narration — ask for "~60 seconds", not exactly 60.
       <DocsVideo
         title="HyperFrames video: Example Explainer"
-        src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-explainer.mp4#t=0.1"
+        src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-explainer-v2.mp4#t=0.1"
         portrait
         loop
       />
@@ -84,7 +84,7 @@ Every prompt below has been run end-to-end and one-shots a finished video that p
 
       <DocsVideo
         title="HyperFrames video: Example Pr Video"
-        src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-pr-video.mp4#t=0.1"
+        src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-pr-video-v2.mp4#t=0.1"
         loop
       />
     *Rendered from the prompt above, unedited.*
@@ -94,7 +94,7 @@ Every prompt below has been run end-to-end and one-shots a finished video that p
 
       <DocsVideo
         title="HyperFrames video: Example Music Slideshow"
-        src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-music-slideshow.mp4#t=0.1"
+        src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-music-slideshow-v2.mp4#t=0.1"
         loop
       />
     *Rendered from the prompt above, unedited.*
@@ -109,7 +109,7 @@ Every prompt below has been run end-to-end and one-shots a finished video that p
 
       <DocsVideo
         title="HyperFrames video: Example Kinetic Quote"
-        src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-kinetic-quote.mp4#t=0.1"
+        src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-kinetic-quote-v2.mp4#t=0.1"
         loop
       />
     *Rendered from the prompt above, unedited.*
diff --git a/docs/prompting/explainers.mdx b/docs/prompting/explainers.mdx
index 4ad4756f9..1863f12bc 100644
--- a/docs/prompting/explainers.mdx
+++ b/docs/prompting/explainers.mdx
@@ -17,7 +17,7 @@ Verified, from the [examples](/prompting/examples) page — a ~60-second vertica
 
 <DocsVideo
   title="HyperFrames video: Example Explainer"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-explainer.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-explainer-v2.mp4#t=0.1"
   portrait
   loop
 />
diff --git a/docs/prompting/music-and-slideshows.mdx b/docs/prompting/music-and-slideshows.mdx
index d5b1eed36..34d485443 100644
--- a/docs/prompting/music-and-slideshows.mdx
+++ b/docs/prompting/music-and-slideshows.mdx
@@ -17,7 +17,7 @@ The verified starting point: photos cut to a track, exported to a square MP4.
 
 <DocsVideo
   title="HyperFrames video: Example Music Slideshow"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-music-slideshow.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-music-slideshow-v2.mp4#t=0.1"
   loop
 />
 *Rendered from the prompt above, unedited.*
diff --git a/docs/prompting/overview.mdx b/docs/prompting/overview.mdx
index cb8d6e229..b413c2e1c 100644
--- a/docs/prompting/overview.mdx
+++ b/docs/prompting/overview.mdx
@@ -7,7 +7,7 @@ import { DocsVideo } from "/snippets/docs-video.jsx";
 
 <DocsVideo
   title="HyperFrames video: Capstone Timeline Default"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/capstone-timeline-default.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/capstone-timeline-default-v2.mp4#t=0.1"
   loop
 />
 *By the end of this guide, you can build this with a prompt.*
@@ -155,7 +155,7 @@ Three prompts from this guide and their unedited renders — one workflow warm s
 
 <DocsVideo
   title="HyperFrames video: Example Product Launch"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-product-launch.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-product-launch-v2.mp4#t=0.1"
   loop
 />
 *Rendered from the prompt above, unedited.*
@@ -173,7 +173,7 @@ And at the far end of the [specification dial](/prompting/specification-dial), a
 
 <DocsVideo
   title="HyperFrames video: Recreate Globe Oneshot"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/recreate-globe-oneshot.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/recreate-globe-oneshot-v2.mp4#t=0.1"
   loop
 />
 *One-shot render from the distilled spec, no iteration.*
diff --git a/docs/prompting/product-launch.mdx b/docs/prompting/product-launch.mdx
index 38e95d3dd..f28dee125 100644
--- a/docs/prompting/product-launch.mdx
+++ b/docs/prompting/product-launch.mdx
@@ -17,7 +17,7 @@ Verified, from the [examples](/prompting/examples) page — a 45-second launch f
 
 <DocsVideo
   title="HyperFrames video: Example Product Launch"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-product-launch.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-product-launch-v2.mp4#t=0.1"
   loop
 />
 *Rendered from the prompt above, unedited.*
@@ -70,7 +70,7 @@ What you can already steer from the prompt, before you've learned any technique.
 
 <DocsVideo
   title="HyperFrames video: Variant Launch Script"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/variant-launch-script.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/variant-launch-script-v2.mp4#t=0.1"
   loop
 />
 *Rendered from this prompt shape with a different, longer script (78 words, fictional dev-tool "Relay"), unedited — it ran 35.5s because the words set the length.*
diff --git a/docs/prompting/recreating-references.mdx b/docs/prompting/recreating-references.mdx
index 385cf9a98..568d16711 100644
--- a/docs/prompting/recreating-references.mdx
+++ b/docs/prompting/recreating-references.mdx
@@ -38,7 +38,7 @@ A distilled spec that one-shots a broadcast-style animated globe:
 
     <DocsVideo
       title="HyperFrames video: Recreate Globe Oneshot"
-      src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/recreate-globe-oneshot.mp4#t=0.1"
+      src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/recreate-globe-oneshot-v2.mp4#t=0.1"
       loop
     />
     *The one-shot render produced by this exact spec on a fresh build — no iteration.*
diff --git a/docs/prompting/vfx-and-liquid-glass.mdx b/docs/prompting/vfx-and-liquid-glass.mdx
index e9ca8b11a..010722cf2 100644
--- a/docs/prompting/vfx-and-liquid-glass.mdx
+++ b/docs/prompting/vfx-and-liquid-glass.mdx
@@ -104,7 +104,7 @@ These are the ambient layer of the [motion grammar](/prompting/motion): grain an
 
 <DocsVideo
   title="HyperFrames video: Logo Polish"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/logo-polish.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/logo-polish-v2.mp4#t=0.1"
   loop
 />
 *Rendered from the prompt above, unedited — the "hold" stays alive on grain, a 3% push, and one shimmer pass.*
diff --git a/docs/prompting/visual-specs.mdx b/docs/prompting/visual-specs.mdx
index 3dd93d806..7848fde87 100644
--- a/docs/prompting/visual-specs.mdx
+++ b/docs/prompting/visual-specs.mdx
@@ -11,7 +11,7 @@ This is the dial's third setting, [full visual spec](/prompting/specification-di
 
 <DocsVideo
   title="HyperFrames video: Spec Showreel"
-  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/spec-showreel.mp4#t=0.1"
+  src="https://static.heygen.ai/hyperframes-oss/docs/images/prompting/spec-showreel-v2.mp4#t=0.1"
   loop
 />
 *Rendered from the spec above, unedited.*
diff --git a/docs/quickstart.mdx b/docs/quickstart.mdx
index d878ddc6d..6ee172655 100644
--- a/docs/quickstart.mdx
+++ b/docs/quickstart.mdx
@@ -9,7 +9,7 @@ import { DocsVideo } from "/snippets/docs-video.jsx";
 <div className="hf-docs-video-frame">
   <DocsVideo
     title="A beginner creates a first HyperFrames video from one short request, then continues with an agent, Studio, or the CLI."
-    src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-quickstart-v5.mp4"
+    src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-quickstart-v5-v2.mp4"
     poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/journey-quickstart-v5.jpg"
   />
 </div>
diff --git a/docs/weekly-updates.mdx b/docs/weekly-updates.mdx
index fea7cfb4a..c5cadc5a2 100644
--- a/docs/weekly-updates.mdx
+++ b/docs/weekly-updates.mdx
@@ -21,7 +21,7 @@ For exact versioned release notes, see the [Changelog](/changelog).
 <Frame>
   <DocsVideo
     title="HyperFrames video: Weekly Changelog 2026 07 27 2026 08 03"
-    src="https://static.heygen.ai/hyperframes/changelog-videos/weekly-changelog-2026-07-27-2026-08-03.mp4"
+    src="https://static.heygen.ai/hyperframes/changelog-videos/weekly-changelog-2026-07-27-2026-08-03-v2.mp4"
   />
 </Frame>
 
@@ -83,7 +83,7 @@ For exact versioned release notes, see the [Changelog](/changelog).
 <Frame>
   <DocsVideo
     title="HyperFrames video: Weekly Changelog 2026 07 20 2026 07 27"
-    src="https://static.heygen.ai/hyperframes/changelog-videos/weekly-changelog-2026-07-20-2026-07-27.mp4"
+    src="https://static.heygen.ai/hyperframes/changelog-videos/weekly-changelog-2026-07-20-2026-07-27-v2.mp4"
   />
 </Frame>
 
@@ -138,7 +138,7 @@ For exact versioned release notes, see the [Changelog](/changelog).
 <Frame>
   <DocsVideo
     title="HyperFrames video: Weekly Changelog Jul13 20"
-    src="https://static.heygen.ai/hyperframes/changelog-videos/weekly-changelog-jul13-20.mp4"
+    src="https://static.heygen.ai/hyperframes/changelog-videos/weekly-changelog-jul13-20-v2.mp4"
   />
 </Frame>