Project Overview
Public demo Read only
MSc AI for Media · engineering dissertation · 2026

Reference-driven agentic video generation system

A purpose-built research system that decomposes reference structure and regenerates controlled short-form outputs using separate identity, look and scene packages.

READ-ONLY DEMO

Not a general AI video generator. This online version is an evidence viewer; generation and state-changing actions are disabled.

Suggested supervisor route · approximately five minutes

Six-stage dissertation evidence route

Implementation footprint · status separated

Implemented model and tool stack

The project integrates video analysis, visual generation, image-to-video synthesis, diagnostics and repair logging into one traceable dissertation prototype.

This is not a single prompt-to-video demo. Deterministic analysis, separated conditioning, per-shot keyframes, prompt-level I2V, post-hoc metrics and decision records form one inspectable workflow.

12named models and toolsintegrated across executed, diagnostic and extension paths
4logical operating modeswith deliberately different evidence maturity
5analysis tracks per shotframing · camera · character · timing · semantics
105linked media / report pathsdeclared across the read-only portfolio and appendix
AnalysisEXECUTED LOCAL

Reference video → structured observations

PySceneDetect, OpenCV, MediaPipe and librosa separate cuts, camera motion, pose availability, framing and timing before generation.

KeyframesEXECUTED EVIDENCE PATH

Reviewed visual anchors per shot

gpt-image-1 combines inspectable generation units with separate identity, look and scene packages.

VideoRETAINED OUTPUTS

Prompt-level I2V

Kling I2V clips are shown as existing evidence. Paid generation remains disabled in this public demo.

DiagnosticsPOST-HOC / DOCUMENTED

Metrics support review; they do not replace it

ArcFace / InsightFace, optical flow and the pose-mask audit expose identity, motion and control-signal limitations. Executed acceptance remained human-gated.

ExtensionPHASE 0 ONLY

Separate driving-video backend

DWPose, SAM3 and Wan2GP / Wan2.2 support the documented Mode C feasibility branch; full production was not validated.

Traceability

Every completed output is linked to inspected files, logs or evidence records. Tool integration does not imply that every branch is equally complete or fully automatic.

Logical modes · shared evidence core

Mode A–D System Map

A readable map of the four operating modes, the shared evidence core, separated conditioning inputs and the dissertation claim boundary.

Beach Mode A-1 · qualitative evidence path

Reference structure and retained output evidence

Three existing artefacts show how source structure becomes a reviewed keyframe and an assembled evidence video.

Beach reference source frame
01 · Structural source

Reference frame

Beach setting, shoulder framing and action intent.

Approved Beach Mode A-1 keyframe
02 · Reviewed anchor

Approved keyframe

Selected identity and look inside the retained beach scene.

03 · Assembled evidence

Final output video

Open the 20-second retained video from the corresponding opening-shot evidence.

Claim boundary. This is a qualitative evidence sequence. It demonstrates reference-scene preservation and reviewed assembly, not exact frame-level motion transfer.

Research argument

Research question, method and contributions

This project investigates whether reference-driven video generation becomes more controllable and auditable when structural, identity, look, scene and repair decisions are externalised as inspectable records, rather than embedded in a single opaque prompt-to-video process.

Research question

Controllability and auditability in reference-driven generation

The study evaluates the extent to which decomposed conditioning packages, shot-level generation units and explicitly logged repair decisions improve workflow traceability, while explicitly not claiming exact frame-level motion transfer or fully automatic metric-driven acceptance.

Engineering method

Structured units before generation

Reference analysis is decomposed into per-shot generation units, which are then combined with separately sourced identity, look and scene packages before keyframe-first I2V generation. Generation is therefore planned at shot level rather than treated as one opaque end-to-end process.

Evaluation position

Evidence status is part of the result

Completed runs, human-gated repairs, post-hoc diagnostics, feasibility extensions and archived negative results are reported under distinct evidence labels, so that the strength of each claim matches the maturity of its evidence.

Contribution 01

Inspectable generation units

Timing, framing, camera motion, character motion, scene intent and prompt blocks are exposed as inspectable per-shot records rather than hidden prompt state.

Evidence anchorReference analysis page + Mode A shot records.
Contribution 02

Separated conditioning packages

Reference structure, identity, look and scene conditioning retain distinct provenance, enabling failure diagnosis and separation of claims.

Evidence anchorMode A settings + looks/scenes + street scene-package run.
Contribution 03

Human-gated repair logging

Attempts, diagnoses, interventions and acceptance decisions are recorded in the decision log; human review remains the acceptance authority, and fully automatic Stage-4 execution is not claimed.

Evidence anchorDecision log + repair evidence page.
Claim boundary. The system preserves shot structure and action intent, but does not claim exact frame-level motion transfer. Pose/mask trials are diagnostic and did not drive the final outputs.

Read-only implementation status

The public site exposes inspectable implementation evidence while keeping generation and project mutation unavailable.

ONLINE_DEMO_READ_ONLY = True
GET /Portfolio interface

Curated academic explanation, modes, methods, evidence and limitations.

GET /media/…Evidence routes

Existing videos, images, reports and audit packages remain directly inspectable.

READ-ONLY RECORDSDecision and evaluation records

Attempts, diagnoses, repair actions, metrics and acceptance context remain browseable.

POST /api/… → 403Server-side safety boundary

Generation, upload, reset and state-mutation routes are disabled in the online demo.

DISABLED IN ONLINE DEMO

Dissertation and method sources

Direct links to the current dissertation PDFs, software repositories and cited papers.

Verified local / primary links
Mode A · Main dissertation pathway
MAIN DISSERTATION PATH

Mode A
Reference-video settings

Mode A is the dissertation’s primary reference-video pathway. It analyses a reference clip into shot structure, framing logic and action intent, then combines those records with selected identity, look and scene packages.

The implementation separates two settings: A-1 preserves the reference scene; A-2 tests cross-scene recomposition.

Mode A design settings

Two Mode A settings, two evidence boundaries

Mode A separates reference-video structure from identity, look and scene conditioning. A-1 is completed as reference-scene preservation; A-2 is reported conservatively as cross-scene recomposition / scene-package evidence.

A-1 · Completed setting
A-1COMPLETED EVIDENCE

Reference-scene preservation

The beach reference scene is preserved while the selected character/look is replaced. This is the completed main Mode A evidence.

4 analysed shots · 4 approved keyframes · 4 Kling I2V clips · final assembly
A-2 · Current evidence boundary
A-2DESIGNED / PARTIALLY TESTED

Cross-scene recomposition

The intended setting combines reference-derived shot/action logic with a new scene package. Current evidence is reported conservatively through the completed street scene-package run and the archived pose-guidance branch.

Street scene-package final · 4 approved keyframes · 4 clips · motion audit

Terminology note. Mode A-1 is the dissertation’s “reference-scene preservation” setting (§4.3–4.7); the dissertation itself does not use the A-1 label.

Academic rationale

Mode A-2 research objective

Mode A-2 asks whether reference-derived structure can be disentangled from reference-scene appearance and recombined with a different scene package. This is not simply a background swap: it tests whether shot logic, identity, styling and environment remain separable enough to be recomposed and diagnosed independently.

Research question

Can shot order, framing and action intent remain useful when the original environment is replaced?

Method idea

Reference analysis supplies structural records; the scene package supplies environment, viewpoint and lighting; identity and look remain separately traceable.

Current evidence

The completed street output reaches approved keyframes, Kling I2V clips and final assembly as a scene-package replacement / identity-and-scene stress test.

Unresolved boundary

The separate start/end pose-guidance branch tested direct reference-structure transfer and was archived because skeleton-image guidance was too weak for reliable hard control.

Research value. The combined positive and negative evidence identifies the boundary between prompt-level cross-scene recomposition and reliable reference-structure transfer, motivating stronger future pose-conditioning mechanisms.

Reporting boundary. Mode A-2 is supported as an intended design setting and partially evidenced. The completed street final is reported conservatively as scene-package evidence, not as a completed reference-video transfer result; exact reference-structure transfer remains future work.

Case Study 01 · Mode A-1 Beach Evidence

Completed reference-scene preservation evidence

The detailed record below follows the completed A-1 beach setting from four analysed shots through approved keyframes, I2V clips, human review and final assembly.

ScopeScope

The main Mode A reference-video pipeline and primary dissertation case study.

Research significanceResearch value

It tests whether reference structure can be decomposed and recomposed with separated identity and look controls.

Evidence presentedInspectable record

Four analysed shots, four approved keyframes, four I2V clips, final assembly and decision records.

Claim boundaryClaim boundary

Shot structure and action intent are preserved; exact frame-level motion transfer is not claimed.

4analysed shots
4approved keyframes
4Kling I2V clips
1assembled final
Research logic

Mode A as the primary dissertation pathway

Mode A starts from an analysed reference clip rather than a free-form prompt. The reference video supplies shot order, framing, timing cues, camera and character motion observations, and scene continuity. These observations are converted into per-shot generation units, then combined with the selected identity and look package to produce approved keyframes and I2V clips.

In the Mode A-1 setting, the reference scene is preserved while the character/look is replaced. The beach case therefore tests whether reference structure, scene continuity and character styling can remain separable instead of being collapsed into one opaque prompt.

Dissertation evidence basis

End-to-end and inspectable

This case demonstrates the implemented Mode A workflow: local reference analysis, shot-level structure records, identity/look conditioning, keyframe-first generation, prompt-level I2V, human-gated repair and final assembly. Each retained clip remains traceable to a shot, approved keyframe, prompt decision and review record.

Contribution boundary. The result demonstrates controlled recomposition: reference-scene structure and action intent are retained while the selected character/look is replaced. It does not claim exact frame-level motion transfer or fully automatic metric-driven acceptance; identity and pose metrics remain diagnostic.

Analysis-to-generation chain

Reference evidence and reviewed output

The prompts are assembled from structured shot observations and selected control packages rather than written from scratch.

  1. 01Analyse reference

    Detect four edited shots.

  2. 02Record observations

    Timing, framing, camera motion, character motion and scene.

  3. 03Create units

    Convert each shot record into a generation unit.

  4. 04Attach conditioning

    Add the selected identity and look package per shot.

  5. 05Assemble prompts

    Structure, scene, identity, look, camera and action blocks.

  6. 06Approve anchors

    Select one reviewed keyframe for each shot.

  7. 07Produce clips

    Convert approved keyframes into Kling I2V clips.

  8. 08Review and log

    Record human-gated diagnosis, repair and acceptance.

Method and retained evidence

One evidence record at every stage

Reference analysisFour-shot beach reference analysed
Generation unitsPer-shot timing, framing, camera/character motion and scene records
ConditioningSelected identity/look package attached to each shot
KeyframesFour approved visual anchors
Video generationFour Kling I2V clips
Review and repairHuman-gated diagnose-and-retry recorded in the decision log
Final output20-second assembled vertical video
Completed evidence · 20 seconds

Final assembled video

Four approved keyframes became four prompt-level Kling I2V clips and were assembled into the retained Beach Mode A-1 output.

Acceptance boundary. Human review remained the acceptance authority. Exact frame-level motion transfer and fully automatic metric-driven repair are not claimed.

Approved generation units

Four shots, one coherent visual system

The selected keyframe for each shot became the visual anchor for its corresponding I2V clip.

Decision log ↗Evaluation report ↗
Case Study 02 · Mode A-2 current evidence boundary

Street scene-package evidence

The record below follows the completed street scene-package run — the current evidence for the Mode A-2 setting — from four static scene references through approved keyframes, I2V clips and final assembly.

ScopeScope

Scene-package replacement completed using static street references, not a reference video.

Research significanceResearch value

Tests whether identity/look conditioning remains coherent when a scene package, rather than a reference video, supplies the environment.

Evidence presentedInspectable record

Four approved keyframes, four I2V clips, final assembly, motion audit and decision records.

Claim boundaryClaim boundary

reference_video = None; this is not a completed reference-video-driven Mode A-2 result.

4street scene references
4approved keyframes
4Kling I2V clips
1assembled final
Method and retained evidence

One evidence record at every stage

Structural sourceStatic street scene references — no reference video analysed
Generation unitsPer-shot scene, framing and action-intent records
ConditioningSelected identity/look package attached to each shot
KeyframesFour approved visual anchors
Video generationFour Kling I2V clips
Review and repairHuman-gated diagnose-and-retry; prompt-only motion repair on two shots
Final outputAssembled street scene-package video
Completed scene-package evidence

Final assembled video

Four approved street keyframes became four prompt-level Kling I2V clips and were assembled into the retained street scene-package output.

Acceptance boundary. The completed street final is not claimed as a fully completed reference-video-driven Mode A-2 output; it used reference_video = None.

Approved generation units

Four street shots, one coherent visual system

The selected keyframe for each shot became the visual anchor for its corresponding I2V clip.

Supported findings

Completed scene-package evidence

  • Scene-package replacement reaches keyframes, I2V clips and final assembly.
  • Selected Look 3 remains broadly coherent in a new street environment.
  • Motion prompts can be revised for selected weak shots.
Excluded claims

Bounded claims

  • It does not prove a completed reference-video-driven Mode A-2 run.
  • It does not prove exact frame-level motion transfer.
  • It does not prove fully automatic metric-driven acceptance.
Decision log ↗Evaluation report ↗

Why there is no reference video here. Mode A-1's completed evidence preserves an analysed reference scene; Mode A-2's completed evidence instead used static scene references with reference_video = None — that is the setting boundary itself, not a missing asset. Direct reference-structure transfer was attempted separately in an archived pose-guidance branch.

DissertationA-1 evidence §4.3–4.7 · A-2 evidence §4.12
Case study 02 · Identity-and-scene stress test
COMPLETED SCENE-PACKAGE EVIDENCE

Street Scene-Package Run

A completed scene-package replacement and identity/scene stress test using static street references and reference_video = None.

This case tests whether the selected Look 3 character can remain visually coherent when regenerated and assembled in a new environment, without using a reference video as the structural input.

Research logic

Research role of the street case

The street run was built to test scene-package conditioning separately from reference-video structure. Unlike Mode A-1, which preserves the beach reference scene, this case replaces the environment with static street scene references. It therefore acts as an identity-and-scene stress test: the system must keep the selected character/look coherent while changing location, viewpoint and scene texture.

This distinction is important for the dissertation claim boundary. The completed street final demonstrates scene-package replacement and final assembly, but it is not reported as a fully completed reference-video-driven Mode A-2 result.

ScopeScene-package replacement

Completed using static street references.

Research valueSeparated conditioning

Tests identity/look coherence in a changed environment.

EvidenceInspectable chain

4 keyframes, 4 clips, final, motion audit and prompt repair.

BoundaryNot structure transfer

reference_video = None; exact transfer is not claimed.

Evidence chain

One run, six inspectable stages

The page follows the street run as an evidence chain rather than presenting a single output video.

  1. 01Street scene package
  2. 02Four approved keyframes
  3. 03Four Kling I2V clips
  4. 04Assembled final
  5. 05Motion audit
  6. 06Prompt-only repair
Approved visual anchors

Four approved street keyframes

Each approved keyframe acts as the visual anchor for one generated I2V clip. The set tests whether Look 3 remains coherent across close-up, back-view, feet-detail and profile-walk shots.

Post-hoc motion audit · dissertation §4.13

Motion-energy audit rationale

Motion audit asks a different question from visual quality. It measures visible optical-flow energy relative to the reference-motion target. The result is diagnostic, not proof of semantic correctness or exact structure transfer.

Headline finding (dissertation §4.13). Across all four shots the generated clips reproduce only 14–64% of the reference's per-frame motion energy (shot_001 14%, shot_003 19%, shot_004 64%); both beach and street generations under-animate relative to the reference. The prompt-only repair below acts on the two weakest shots.

Shot 00114% → 51%prompt-repaired
Shot 00237%retained
Shot 00319% → 47%prompt-repaired
Shot 00464%retained

Targeted action. Prompt-only repair addressed the two weakest shots rather than regenerating the full sequence. Values are retained from the run decision log.

Shot 001 · optical-flow filmstrip

Post-hoc diagnostic
Street shot 001 optical-flow filmstrip

Visible motion energy across ten sampled frames.

Shot 003 · optical-flow filmstrip

Post-hoc diagnostic
Street shot 003 optical-flow filmstrip

The second targeted prompt-only motion repair.

Supported findings

Completed scene-package evidence

  • Scene-package replacement reaches keyframes, I2V clips and final assembly.
  • Selected Look 3 remains broadly coherent in a new street environment.
  • Motion prompts can be revised for selected weak shots.
Excluded claims

Bounded claims

  • It does not prove a completed reference-video-driven Mode A-2 run.
  • It does not prove exact frame-level motion transfer.
  • It does not prove fully automatic metric-driven acceptance.
Decision log ↗Motion audit ↗Evaluation report ↗

Archived-log terminology. “Real footage” in the archived audit log is shorthand for the motion-target role. The reference clip is the author-created AI-generated beach performance clip (dissertation §5.3); the logs are preserved unedited.

DissertationScene-package run §4.12 · motion audit §4.13
Control-signal trials · negative and diagnostic evidence

Control extraction was investigated, measured and bounded

These are development findings within the engineering dissertation. They explain why pose and mask signals remained diagnostic/candidate controls rather than being promoted as the final Mode A generation path.

TESTED + DOCUMENTED CONTROL-SIGNAL TRIAL
ScopeScope

Documented pose/mask candidates plus an archived start/end skeleton-guidance branch.

Research significanceResearch value

Negative and partial findings explain why these signals were not selected as final hard controls.

Evidence presentedInspectable record

Twelve samples across four shots; nine pose/mask candidates; shot 003 unavailable in all samples.

Claim boundaryClaim boundary

Diagnostic/candidate evidence only; these controls did not generate the final beach or street outputs.

Street start/end pose-guidance branch

Attempted beach-to-street reference-structure transfer. Skeleton-image guidance was too weak, so the branch was archived as a negative result and did not produce the final street video.

Local pose/mask extraction audit

Four shots × start/mid/end produced 12 inspectable samples. Pose and pose-seeded mask candidates were available for 9 samples; the three feet-detail samples remained unavailable.

Archived start/end branch

Individual skeleton controls

Displaying the individual controls avoids the unreadable black margins in the original archival contact sheet.

Tested + archived negative result
Shot 002 start skeleton
Shot 002 · start
Shot 002 end skeleton
Shot 002 · end
Shot 004 start skeleton
Shot 004 · start
Shot 004 end skeleton
Shot 004 · end

Finding. Start/end images did not provide sufficiently strong temporal conditioning for reliable structure transfer. This is a backend/control limitation, not the final street result.

Representative mid samples

Reliability changes with shot type

Each card shows reference frame, pose diagnostic and mask candidate. Shot 003 is intentionally retained as unavailable evidence.

shot_001 · Close-up / shoulder framing

Candidate
Shot 1 midShot 1 mid poseShot 1 mid mask overlay

Partial-body coverage and weaker boundaries make this unsuitable as production-ready hard control.

shot_002 · Full-body back view

Candidate
Shot 2 midShot 2 mid poseShot 2 mid mask overlay

The strongest case: full-body visibility supported stable pose and a plausible foreground candidate.

shot_003 · Feet detail

No pose seed
Shot 3 midShot 3 mid poseShot 3 mid mask overlay

All three samples lacked reliable pose. Mask output was left unavailable rather than invented.

shot_004 · Side-profile walk

Candidate
Shot 4 midShot 4 mid poseShot 4 mid mask overlay

Available for analysis, but not evidence that pose/mask control drove final Mode A outputs.

DissertationPose/mask audit §4.11.1 · archived skeleton branch §4.12
Feasibility extension · separate driving-video backend

Mode C · Driving performance replacement

Mode C tests a separate control paradigm from the Mode A/B keyframe-first pipeline. Instead of converting a reference video into prompt-level generation units, it uses a driving/control video, person mask, reference images and pose/body conditioning to perform replacement inside the person region.

The newest evidence is a 7.0-second Wan2.2 Animate replacement window. It extends the earlier short Phase-0 evidence retained below, but it does not replace the main Mode A evidence and does not validate full 27-second production generation.

Research boundary. This branch distinguishes driving-video replacement from prompt-level reference-guided regeneration. It is not part of the Mode A keyframe/Kling path and did not produce the final beach or street outputs.

EXTENDED WINDOW TEST · QUALITY WIP
ScopeScope

A separate driving-video person-replacement backend outside the Mode A/B keyframe-first core.

Research significanceResearch value

It tests whether a masked driving-performance video can provide stronger body-motion control than prompt-level I2V, while exposing the compute and identity-consistency limits of this backend.

Evidence presentedInspectable record

Privacy-redacted control display, person mask, generated 7-second replacement, complete run metadata and earlier Phase-0 evidence.

Claim boundaryClaim boundary

Quality remains WIP. This is a 7-second window, not a full 27-second production run; identity, body proportions, temporal consistency and compute cost remain unresolved.

Newest Mode C evidence · 4 August 2026

Mode C — Wan2.2 Animate 7s Replacement Test

This is a longer 7.0-second Mode C replacement window generated with Wan2.2 Animate 14B. The retained local run used a consented driving/control recording that is not served publicly, together with a person mask video, reference images and OpenPose/BBox/face-movement conditioning inside the mask. The retained run produced a 544×960 portrait output of 209 frames at 30 fps using seed 630814980.

The result extends the earlier short Phase-0 evidence, but it is not presented as a full production pipeline. Generation took 2h 55m 14s, showing that this backend is computationally heavy compared with the Mode A/B keyframe-first workflow. It is therefore reported as extended feasibility evidence, not as a completed or interactive production mode.

EXTENDED WINDOW TEST · QUALITY WIP

Control video

Privacy-redacted display · 209 frames

Privacy-safe display copy: the participant's full head is covered by an expanded coarse mosaic. The original driving performance and audio evidence remains preserved locally.

Person mask

Inside-mask conditioning evidence

Person-region mask used with face movement, BBox and OpenPose processing.

Generated replacement

Wan2.2 Animate 14B · seed 630814980

Retained 544×960 portrait replacement output.

Recorded run configuration

Generation metadata

Values are transcribed from the completed local run record; no generation is triggered by this page.

Open metadata JSON ↗
ModelWan2.2 Animate 14B
Resolution544×960 portrait
Duration7.0s · 209 frames · 30fps
WindowNo. 3
Seed630814980
Guidance5
Shift scale7
Steps60
Samplerunipc
Generation time2h 55m 14s
ConditioningControl Video · Mask Video · Reference Images
Inside-mask processFace Movements · BBox · Open Pose
AudioControl Video Audio Track · 1 track
Known failure cases — reported, not hidden

Three concrete failure/limitation cases are part of the Mode C record and are surfaced here rather than left only in the raw run folders. (1) Extreme-pose identity and body-proportion distortion, observed in both the Phase-0 test and the newer 7 s window — the character's proportions and facial identity become unreliable on fast or extreme poses. (2) A session-ending GPU driver fault on the remote RTX 4080 host (nvidia-smi: No devices were found) occurred immediately after the 7 s run completed, halting further Mode C generation; this is recorded as an operational risk of running a 14B model on a 16GB GPU. (3) The 7 s run's three sliding-window stages did not each independently reach full length — only the final 209-frame stage matches the full driving clip; the two earlier-timestamped files are partial intermediate outputs of the same run, not three separately completed replacements.

What still held despite these limits

Across both runs, the backend executed end to end without crashing mid-generation, driving motion was followed, and background outside the person mask was preserved. These failure cases bound the branch's production readiness; they do not indicate that the pipeline failed to run.

Historical feasibility evidence

Earlier Mode C Phase 0

The earlier short Phase-0 segment established that the backend could run end to end on the documented remote RTX 4080 setup. The new 7-second window extends this evidence, but both remain feasibility tests rather than full production validation.

PHASE 0 PASSED · QUALITY WIP

Driving input

Documented Phase-0 control

Privacy-safe display copy derived from the documented Phase-0 control; the collaborator's full head is covered by an expanded coarse mosaic and audio is removed. The original evidence remains unchanged and local.

Person mask

SAM3 evidence

Replacement output

Short Phase-0 segment
Verified feasibility configuration

Runtime and compute constraints

Phase 0 was intentionally configured as a low-cost feasibility check for the 16GB RTX 4080 backend. Its purpose was to verify that masked person replacement could run end to end with motion following and background preservation—not to establish final duration or production quality.

Comparison boundary. The newer 7-second test uses 209 frames and 60 inference steps. This historical Phase-0 output used 81 frames and 30 steps, so the two results document different maturity levels rather than an equal-setting quality comparison.

BackendWan2GP · Wan2.2 Animate 14B
ComputeRTX 4080 · 16GB VRAM
Memory pathint8 quantisation · mmgp CPU-offload · SDPA attention
Control / mask media512×912 · 4.0s · 120 frames · 30fps
Generated output480×848 · 2.709s · 81 frames · 30fps
Inference steps30
Test roleShort low-resolution feasibility window
Observed passBackend ran end to end; driving motion followed; background outside the mask was retained
Observed limitationIdentity and body proportions distorted on extreme poses
Seed / guidance / samplerNOT PRESERVED IN CURRENT PHASE-0 PACKAGE
Generation wall-timeNOT PRESERVED IN CURRENT PHASE-0 PACKAGE
Executed evidence

The earlier short Phase-0 segment ran end to end on the documented remote RTX 4080 setup, followed the driving performance and established backend feasibility. The newer 7-second window extends duration evidence without turning either test into full production validation.

Unresolved limitations

Identity and proportions distort on extreme poses; full 27-second generation and production quality were not validated.

Hosted-service comparison is reported under Mode D

The wan.video and Viggle material is exploratory hosted-service demo content, not Mode C evidence. Mode C retains the documented local Wan2GP / Wan2.2 Phase-0 and 7-second feasibility runs.

Dissertation§3.10 · §4.17
System mode D · hosted deployment question
PLANNED EXTENSION

Mode D · Planned online-backend extension

Mode D is the planned fourth pathway: delegating driving-video replacement to hosted online backends instead of the local Wan2GP setup used in Mode C. It is designed but not implemented. The material on this page consists of exploratory online-service demos only; none of it is dissertation evidence.

AI-generated black velvet gown identity and vintage dressing-room scene reference Reference input · 4 Aug 2026
MODE D · PLANNED EXTENSION
Reference input evidence

Reference image

AI-generated reference image created 4 Aug 2026. It defines the intended identity, black velvet gown look and vintage dressing-room scene for the planned hosted-service replacement tests.

Research role

Mode D asks whether the Mode C control paradigm — driving video plus reference identity — can be delegated to hosted services when local GPU capacity is the bottleneck. It is therefore a capacity and deployment question, not a new control paradigm.

Capacity context. A completed 7-second local Wan2.2-Animate window required approximately 2 h 55 m on the 16 GB RTX 4080 host, while GPU driver faults interrupted further local runs. Local execution was possible, but marginal and unreliable.

Created
4 Aug 2026
Input type
Reference image
Use
Identity · look · scene
Status
Planned extension

Two services × two scene conditions

The four demos form a two-service × two-condition grid mirroring the Mode A-1 / A-2 distinction: same driving motion, same AI-generated reference image, with the scene either preserved or replaced.

ONLINE DEMO — NOT DISSERTATION EVIDENCE

Viggle · scene preserved

Hosted character replacement on viggle.ai; the original room background from the driving clip is retained. 7.0 s, 718×1280, 25 fps. Provenance: viggle.ai watermark embedded in frame.

Service parameters not fully recorded; treated as demo per archiving rules.
ONLINE DEMO — NOT DISSERTATION EVIDENCE

Viggle · scene replaced

Hosted character replacement on viggle.ai; the environment is replaced with the dressing-room scene from the reference image. 7.0 s, 720×1280, 25 fps. Provenance: viggle.ai watermark embedded in frame.

Service parameters not fully recorded; treated as demo per archiving rules.
ONLINE DEMO — NOT DISSERTATION EVIDENCE

wan.video Transfer · scene preserved

Hosted video-to-video transfer (driving video + reference image); the character is replaced while the original room background is retained. 4.0 s, 720×1280, 30 fps.

Service parameters not fully recorded; treated as demo per archiving rules.
ONLINE DEMO — NOT DISSERTATION EVIDENCE

wan.video Edit · scene replaced (pose/motion transfer only)

Hosted edit transferring only pose and body motion from the driving video into the reference image's dressing-room scene. 4.8 s, 718×1280, 30 fps. Provenance: Wan watermark embedded in frame.

Service parameters not fully recorded; treated as demo per archiving rules.

Comparison boundary. These demos informally replicate the dissertation's scene-preservation versus scene-replacement distinction (Mode A-1 vs A-2) on hosted backends. They are exploratory demos only; no parameter records were retained, so they carry no evidential weight.

CONTROL TRADE-OFF · HOSTED DEMOS VS MODE A

Hosted demos vs Mode A: speed, control and evidence boundaries

QUALITATIVE HUMAN REVIEW · NO METRICS COMPUTED

The hosted replacement demos were reviewed qualitatively against the completed Mode A evidence. They are useful for fast exploration, but they expose control limitations that the Mode A pipeline is designed to make inspectable and repairable.

01 · Reference control

Identity control

The hosted services accept a single reference image and offer no identity-anchor control. Across the four demos the generated character drifts from the reference identity, and the two services produce visibly different interpretations of the same reference.

Mode A uses a locked multi-view anchor set and per-shot human-gated repair, making identity drift inspectable and allowing it to be addressed at shot level. This does not imply that Mode A solves every identity issue.

02 · Frame integration

Whole-frame coherence

In the scene-preserved demos the replaced character is not consistently relit to match the driving environment: the subject can read as composited, with lighting direction and colour temperature inconsistent with the room.

Mode A generates each shot as a whole frame from an approved keyframe, so subject and environment are reviewed within one lighting solution. The comparison remains qualitative.

03 · Evidence traceability

Reproducibility

Hosted services provide fast visual feedback, but the internal model version, preprocessing, identity handling and repair logic are usually not fully inspectable. This makes the output harder to reproduce or diagnose compared with the Mode A pipeline, where prompts, keyframes, decision logs and retained media are preserved as evidence.

04 · Targeted intervention

Repairability

When a hosted result fails, the main available action is usually to rerun or change the prompt. In Mode A, failure can be localised to a shot, keyframe, identity anchor, scene package or motion prompt. This makes repair more targeted and the reason for each revision more inspectable.

The comparison supports the dissertation’s core argument: a slower, inspectable Mode A pipeline provides stronger provenance, identity control and repair visibility than faster one-shot hosted replacement demos.

Limitation

Mode D remains a planned extension. Online services were only exercised as undocumented demos; prompts, seeds and parameters were not fully recorded.

Current evidence

Four short online-service demo clips and one reference image, retained without full parameter records. They illustrate feasibility of hosted replacement but carry no evidential weight.

Next step

Re-run selected demos with recorded settings (screenshot of settings page, prompt, visible parameters, site/date/mode) so future runs can be archived under the standard outputs/runs/ rules and reported honestly.

Hosted-demo README ↗
Research governance · public display boundary

Ethics & Consent

Public-display rules for synthetic references, consented driving material and read-only evidence access.

01
Material boundary

Synthetic reference material

The beach reference clip and identity/look/scene images used in the public evidence are author-created AI-generated materials. They are used as structural or visual research assets and are not presented as real people.

02
Consent scope

Real-person driving material

The real-person driving/control recordings used for Mode C and related planned extension tests were recorded with informed consent for research use. Public display uses identity-replaced, redacted or processed views rather than exposing the raw private recording.

03
Route policy

Public-display safeguard

The online dashboard is a read-only evidence viewer. It serves curated outputs, redacted display copies, generated replacements, masks, reports and audit packages. Raw control recordings and private working files are not publicly routed.

04
Identity boundary

No public-figure likeness

No real public figure likeness is intentionally used in the system inputs or outputs. Synthetic identity references are treated as generated research assets.

05
Access control

Data minimisation

Only the minimum material needed to explain the method and evidence is shown publicly. Raw control recordings and private working files remain local and are not exposed as downloadable public evidence.

Evaluation evidence · status-separated

Evaluation Metrics — Automatic Analysis Status

LOCAL / POST-HOC / DESIGNED STATUS

This page separates executed local diagnostics, post-hoc metrics and designed-but-not-fully-executed automatic scoring. Evaluation evidence supports review and repair decisions, but the final dissertation evidence remains human-gated rather than fully automatic.

01

Executed local analysis

Shot detection, camera motion, timing extraction and reference-side pose availability were produced locally from existing inputs.

02

Post-hoc and human-coded diagnostics

ArcFace, optical flow, the pose/mask audit and visual framing review inspect retained outputs after generation.

03

Designed / pending automation

Generated-side pose similarity, formal beat alignment and fully automatic Stage-4 acceptance were not fully executed.

Executed diagnostic values

Measured evidence, not acceptance authority

The values below are retained diagnostics. A low or unavailable metric does not silently become a failed or passed shot; human review remains explicit.

POST-HOC DIAGNOSTIChigher = closer

ArcFace cosine similarity

Beach approved keyframes compared with the Look 3 front anchor. The metric is diagnostic only and was not used as a hard automatic acceptance threshold.

0.374shot_001 · face visible
0.227shot_004 · profile
n/ashot_002 / 003 · no face
0.301mean · face-visible shots
Open dry-run summary ↗
POST-HOC MOTION DIAGNOSTICdecision-log values

Optical-flow motion energy

Visible motion energy relative to the reference. It does not prove semantic correctness, pose correspondence or exact frame-level transfer.

14% → 51%street shot_001 · v1 → promoted v2
19% → 47%street shot_003 · v1 → promoted v2
37%street shot_002 · retained
64%street shot_004 · retained
Open motion audit ↗

Pose / mask control-signal audit

TESTED + DOCUMENTED TRIAL

12 samples; 9 pose detections and mask candidates. Shot 003 had no reliable pose seed and is marked unavailable_no_pose_seed. Useful as diagnostic evidence and candidate control signals, not production-ready hard control and not used to generate final beach/street outputs. Manifest ↗

Framing review

HUMAN-CODED / PARTIAL

Framing and shot composition were reviewed visually against reference shot intent. The retained records contain framing labels, but formal fully automatic framing accuracy remains partial/pending.

Timing / duration audit

LOCAL TIMING AUDIT

Reference durations compared with the nominal fixed 5.00-second I2V target. Shot order and action intent are retained; exact beat timing and shot duration are not.

+2.60s001 · 2.40s → 5.00s
+2.73s002 · 2.27s → 5.00s
+2.87s003 · 2.13s → 5.00s
+3.90s004 · 1.10s → 5.00s

Beat alignment / generated pose similarity

PENDING / NOT COMPUTED

Formal beat-boundary alignment and generated-side pose similarity are not available as complete metrics. Reference pose availability is not equivalent to a generated-versus-reference pose score.

DESIGNED · NOT FULLY EXECUTED

Automatic Stage-4 scoring loop

The metric-driven Stage-4 loop was designed and partially instrumented. A safe local dry-run harness reads existing outputs, assigns pending/not-applicable states and proposes repairs without executing regeneration. Completed dissertation evidence instead uses human-gated review and decision logs.

execute_repair = falsepaid calls attempted = falsegeneration modules imported = falseacceptance = human review
Open dry-run report ↗
Metric status and claim boundary
MetricStatusEvidenceLimitation
Reference / shot analysisExecuted local analysis3 retained test clips; 1/1/4 detected shotsStructured observations, not motion copying
ArcFace identityPost-hoc diagnostic0.374 / 0.227; mean 0.301Not an in-loop threshold; no-face shots n/a
Optical-flow motionPost-hoc diagnosticStreet v1 and promoted v2 valuesEnergy only; not semantics or alignment
Pose / maskDocumented control trial9 of 12 candidatesShot-type dependent; did not drive finals
FramingHuman-coded / partialVisual review and framing labelsNo complete automatic accuracy score
TimingLocal duration auditReference durations vs nominal 5s clipsNot a formal beat-lock scorer
Automatic Stage-4Designed · not fully executedDry-run harness and repair plansNo automatic paid retry or acceptance loop
Claim boundaryAutomatic/local analysis supports diagnosis and evidence reporting. It does not mean that final outputs were accepted by a fully automatic scoring system. ArcFace was not an in-loop acceptance threshold; optical flow does not prove transfer; pose/mask did not drive the final outputs; formal beat alignment remains pending.
Dissertation§4.8.1 · §4.11.1 · §4.13–4.15
Evaluation · concise evidence map

Completed evidence and supported claims

Status is separated from interpretation so feasibility, completed evidence and future work are not conflated.

ScopeScope

A status map separating completed evidence, human review, diagnostics, pending metrics and future work.

Research significanceResearch value

It prevents feasibility tests and partial instrumentation from being read as fully executed evaluation.

Evidence presentedInspectable record

Beach, street, repair, motion, archived control, Mode C and Stage-4 status records.

Claim boundaryClaim boundary

Missing metrics remain pending or not applicable; no value is invented to complete the table.

Beach Mode A-1

Completed evidence

Reference-scene preservation with four reviewed shots and an assembled final.

Exact frame-level motion transfer is not claimed.

Street scene package

Completed scene-package evidence

Identity-and-scene stress test with static street references.

reference_video = None; not structure transfer.

Human-gated repair

Human-gated repair evidence

Failures, diagnoses, retries and promoted results are logged per shot.

Human review remained the acceptance authority.

Motion-energy audit

Post-hoc diagnostic

Prompt repair raised visible motion energy for selected street shots.

Optical flow does not prove motion transfer.

Structure-transfer branch

Tested + archived negative result

Start/end skeleton guidance was tested and retained as a documented failure.

Guidance was too weak for reliable transfer.

Mode C Phase 0

Phase 0 passed · quality WIP

A short driving-performance replacement ran via Wan2GP.

Full 27-second production was not validated.

Automatic Stage-4

Designed · not fully executed

A dry-run scoring/repair structure was designed and partially instrumented.

No claim of fully automatic production acceptance.
POST-HOC DIAGNOSTIC

Identity diagnostic — executed post-hoc (dissertation §4.8.1). ArcFace (buffalo_l) cosine similarity of each approved beach keyframe to the Look 3 front anchor: shot_001 = 0.374, shot_004 = 0.227 (mean 0.301); shot_002 (back view) and shot_003 (feet detail) = not applicable, no face. All four keyframes were accepted as the same character at human review. The low similarities are evidence that a single face-embedding metric is mis-calibrated for a synthetic, stylised character — this is why human review, not ArcFace, is the acceptance authority.

Values are cosine similarity, not distance.
Metric boundary. ArcFace and optical flow are post-hoc diagnostics. Framing is human-coded, generated-side pose remains unavailable or pending where not computed, and formal beat-alignment scoring remains pending.
Implementation status

Implementation and evaluation status

This matrix separates completed system evidence from post-hoc diagnostics, feasibility extensions and planned architecture.

ComponentStatusEvidenceLimitation
Reference analysisEXECUTED LOCALtest_01, test_02 and test_03Produces structured observations; no exact motion-copy claim
Keyframe generationEXECUTEDFour approved beach and four approved street keyframesHuman-reviewed visual anchors
Kling I2VEXECUTEDFour beach clips and four street clipsPrompt-level fixed-duration I2V
Human-gated repairEXECUTEDDecision log, retained attempts and promoted resultsHuman review is the acceptance authority
ArcFace identityPOST-HOCshot_001 = 0.374; shot_004 = 0.227Cosine similarity diagnostic, not an in-loop threshold
Optical-flow motionPOST-HOCStreet audit; repair values 14→51% and 19→47%Visible motion energy, not semantic or frame alignment
Pose / mask auditDOCUMENTED TRIAL12 samples; 9 pose/mask candidatesDid not drive final beach or street outputs
Automatic Stage-4DESIGNED · NOT FULLY EXECUTEDSafe dry-run harness and repair plansNo fully automatic acceptance or paid retry loop
Mode CPHASE 0 ONLYShort driving replacement, mask and outputFull 27-second production not validated
Mode DPLANNEDArchitecture definition onlyNot implemented
DissertationArcFace diagnostic §4.8.1
Pipeline stage 01 · local / $0 evidence

Reference Analysis — From Video to Generation Units

This page shows how the system turns reference videos into structured generation evidence before any generation step. The analysis stage separates shot structure, camera motion, character motion, framing and timing so downstream prompts and keyframes are grounded in inspectable observations rather than free-form guessing.

EXECUTED LOCAL ANALYSIS
Test 03 · main Mode A-1 source

Four-shot beach reference

Purpose: validate multi-shot cut detection and generation-unit creation. The edited source produced four detected shots, and those four records became the structural basis of the completed Mode A-1 beach evidence.

Expected · 4 shotsDetected · 4 shots7.9 secondsUsed for Mode A-1
Reference evidence · 4 shots
Detected shot structure (test_03)
ShotTimingCamera motionFraming
shot_0010.00–2.40spush_inmedium
shot_0022.40–4.67sstaticwide
shot_0034.67–6.80shandheldunknown
shot_0046.80–7.90shandheldwide
Test 01 · subject motion

Static camera,
moving subject

Validates single-take fallback and subject-motion analysis while the camera remains static.

Purpose
Separate character movement from a stationary camera
Expected
One continuous shot
Result
One shot detected
Use
Analysis smoke test
Test 02 · camera motion

Moving camera,
limited subject motion

Validates camera-motion analysis and the separation between camera motion and character motion.

Purpose
Extract the dominant push/pan camera profile independently
Expected
One continuous shot
Result
One shot detected; push/pan camera-motion profile extracted
Use
Camera-motion smoke test
Analysis pipeline

Reference-analysis outputs

The output of analysis is not a copied video. It is an inspectable set of observations passed into downstream generation-unit and prompt construction.

01

Reference video

Authorised single-take or edited structural input.

02

Shot detection

Cut boundaries create one record per detected shot.

03

Camera motion

Static, push, pan and other camera cues are recorded separately.

04

Character motion / pose

Subject action and pose availability are recorded where locally available.

05

Framing + timing

Shot size, duration and beat-related timing remain explicit.

06

Generation units

Each shot becomes a structured record rather than a free-form guess.

07

Prompt blocks

Analysis fields combine with selected identity, look and scene packages.

08

Keyframes

A reviewed visual anchor is produced per shot before prompt-level I2V.

Analysis-to-prompt transition

Analysis-to-prompt transformation

Each shot record stores timing, framing, camera motion, character motion and scene description. The generation unit then assembles these observations with selected control packages.

01

Identity block

Selected subject identity and view-specific reference material.

02

Look block

Outfit, hair and styling constraints kept separate from identity.

03

Scene block

Preserved reference scene or selected static scene-package evidence.

04

Camera / framing block

Shot size, viewpoint and camera-motion observations from analysis.

05

Action / motion block

Character action intent and prompt-level motion direction.

06

Negative prompt

Shot-specific exclusions and consistency constraints.

Reference-driven prompt constructionPrompts are not written from scratch: they are assembled from structured analysis records and selected identity, look and scene packages. The six blocks become a keyframe prompt plus a shot-specific I2V motion prompt; approved keyframes then anchor the per-shot clips.
ILLUSTRATIVE SCHEMA · NOT A NEW RESULT

Inspectable generation unit

A generation unit is the hand-off between analysis and generation. It keeps the source observation, selected packages, prompt blocks and review status attached to one shot. This simplified example shows the schema shape; the run record remains the evidence authority.

{
  "shot_id": "shot_001",
  "timing": "0.00–2.40s",
  "framing": "over-shoulder close-up",
  "camera_motion": "static / slight motion",
  "character_motion": "turn / look",
  "scene": "beach sunset",
  "look_package": "Look 3",
  "prompt_blocks": {
    "identity": "…",
    "look": "…",
    "scene": "…",
    "camera_framing": "…",
    "action_motion": "…",
    "negative": "…"
  },
  "evaluation_status":
    "accepted_by_human_review"
}
Retained analysis inputs and detected structure
ClipPurposeExpected structureDetected resultDownstream use
test_01Subject-motion analysisSingle shot1 shotAnalysis smoke test
test_02Camera-motion analysisSingle shot1 shot; push/pan profileCamera-motion smoke test
test_03Edited reference structure4 shots4 shotsMode A-1 beach run
Claim boundaryThe analysis stage produces structured observations and prompt inputs. It does not claim exact frame-level motion transfer. The first two clips are local analysis tests, not paid generation evidence; only test_03 proceeds into the completed Mode A-1 run. Pose availability is reported only where it exists and is not presented as fully automated acceptance.
DissertationReference analysis and generation units · §3.2–3.4
Method · nine inspectable stages

Reference input and final assembly

The executed pipeline is keyframe-first and human-gated. It preserves shot structure and action intent without claiming exact frame-level motion transfer.

ScopeScope

The nine-stage method from structural input to final assembly.

Research significanceResearch value

It shows where control, human approval, evaluation and provenance enter the implementation.

Evidence presentedInspectable record

Analysis fields, generation units, packages, keyframes, clips, review, repair log and assembly.

Claim boundaryClaim boundary

The executed path is keyframe-first and prompt-level, not exact frame-by-frame motion copying.

Architecture mapping. These nine inspectable stages are a finer-grained view of the dissertation's four-stage architecture (§3.2): stages 01–03 = Reference Analysis + Template Builder, 04–06 = IP-Conditioned Generation, 07–09 = Evaluation & Repair + assembly.

01

Reference input

An authorised clip or scene package defines the structural starting point.

02

Shot / beat / pose analysis

Local analysis records cuts, timing, framing and pose evidence.

03

Generation units

Each shot becomes a structured unit with explicit fields.

04

Identity / look / scene

Reference packages remain separated by function.

05

Approved keyframes

One human-reviewed still anchors each generated clip.

06

Prompt-level I2V

Existing approved keyframes were animated per shot.

07

Evaluation

Human review is primary; metrics are diagnostic or post-hoc.

08

Repair log

Observed issues lead to a targeted retry and recorded decision.

09

Final assembly

Accepted clips are ordered into the final evidence video.

Automation boundary. Human-gated diagnose-and-retry was executed. The automatic metric-driven Stage-4 loop remains designed and not fully executed.
DissertationFour-stage architecture §3.2
Qualitative comparison

Source, generated anchor and final output

These comparisons help a reviewer inspect scene, framing and identity changes. They are not measurements of exact motion transfer.

ScopeScope

A qualitative comparison of source/reference material, approved anchors and completed outputs.

Research significanceResearch value

It lets a supervisor inspect visual continuity and deliberate scene replacement directly.

Evidence presentedInspectable record

Beach source/keyframe/final and street scene package/keyframe/final using existing media.

Claim boundaryClaim boundary

This is visual evidence, not a quantitative proof of exact motion transfer.

Beach source

Structural input
Shot 1 best

Approved keyframe

Generated anchor
Shot 1 keyframe look3 preserve scene test

Final beach video

Assembled evidence

Street scene reference

Static package
Main

Approved keyframe

Generated anchor
Shot 1 keyframe look3 street

Final street video

Scene-package evidence
How to read this page. Beach is the completed reference-scene preservation case. Street is a separate completed scene-package stress test using reference_video = None.
Human-gated repair evidence
HUMAN-GATED REPAIR EVIDENCE

Observed issue → diagnosis → targeted repair

This page shows the agentic part of the workflow. The system does not treat generation as a one-shot output. Instead, each shot is reviewed, diagnosed and revised through a recorded decision process. The evidence is therefore not only the final video, but the trace from observed issue → diagnosis → repair action → retained result.

WHY THIS MATTERS

Beyond a linear prompt-to-video workflow

A linear workflow would generate all clips once and accept or reject the final assembly as a whole. This system records per-shot failures and allows the failed unit to be revised without rebuilding the entire sequence. That makes the workflow traceable, modular and auditable.

EXECUTED EVIDENCE VS DESIGNED AUTOMATION

Human-gated execution, bounded automation claim

Human review identifies whether a shot is acceptable, while the decision log records the observed failure, repair action and retained output. The automatic Stage-4 loop is not presented as fully executed metric-driven acceptance.

Episode 01 · identity-anchor repair

Reference priority as a repair decision

QUALITATIVE HUMAN-REVIEW EVIDENCE
Street identity anchor repair comparison

Identity-anchor repair (dissertation §4.12, Figure 4.3). Left: front and profile identity anchors. Middle: earlier street keyframes that kept outfit and scene but drifted to a generic face. Right: after the reference-ordering policy promoted the identity anchor for face-visible shots. Qualitative human-review evidence; identity is improved, not solved.

Repair-loop interpretation

First attempt versus retained outcome

Reconstructed from eight logged attempts across four shots (1/2/2/3 attempts per shot).

Reconstructed from the decision log: first-attempt acceptance 25% (1 of 4 shots) → 100% after human-gated repair, across 8 logged attempts (1/2/2/3 per shot). This is a log reconstruction, not a controlled ablation (dissertation §4.9).

LOOP OFFFirst attempts only
1 / 4 25% accepted
LOOP ONHuman-gated repair included
4 / 4 100% accepted
Decision-log evidence

Repair decisions remain inspectable

Each repair attempt is recorded as a structured decision event. The log stores the shot identifier, attempt number, observed issue, diagnosis, repair action, prompt or keyframe change, review result and whether the output was promoted or archived. This makes the repair process explicit rather than implicit.

shot_idattempt_idobserved_issuediagnosisrepair_actionreview_statusretained_output
Repair taxonomy

Repair types observed

Four bounded intervention types organise the completed and archived evidence.

01

Identity repair

When the generated character drifted, the repair prioritised identity anchors and reduced competing references.

02

Motion repair

When visible movement was too weak, the repair changed motion wording while retaining the approved keyframe.

03

Control-signal boundary

When skeleton/start-end guidance was unreliable, the branch was archived rather than forced into the final output.

04

Automation boundary

When automatic scoring was not fully executed, it was labelled as designed future work rather than completed automation.

Failure-to-evidence chain

Observed issue → diagnosis → intervention → evidence

Observed issueDiagnosisIntervention / decisionEvidence status
ISSUE 01Identity drift

Reference priorities conflicted.

Identity anchor priority revised.

Keyframe consistency improved
ISSUE 02Weak visible motion

Motion wording damped movement.

Prompt-only motion repair.

Shots 001 and 003 improved
ISSUE 03Weak skeleton guidance

Start/end control was unreliable.

Branch archived.

Negative result retained
ISSUE 04Automatic scoring incomplete

Instrumentation did not equal execution.

Labelled future work.

No overclaim
Selected motion repairs

Prompt-only changes, retained versions

The approved keyframe was retained; only the motion prompt was revised for the two weakest street clips.

POST-HOC DIAGNOSTIC
STREET SHOT

001

14% → 51%
Before repair · v1
After prompt-only repair · v2

Visible motion-energy ratioRetained v1 → promoted v2

STREET SHOT

003

19% → 47%
Before repair · v1
After prompt-only repair · v2

Visible motion-energy ratioRetained v1 → promoted v2

WHAT THIS PAGE DEMONSTRATES

Traceable, targeted repair

This page demonstrates the system’s repair logic at workflow level: failed shots are identified, diagnosed, revised and either promoted or archived. It supports the dissertation claim that the workflow is agentic through traceable decision-making and targeted repair.

  • Shot-level failure diagnosis
  • Targeted prompt/keyframe repair decisions
  • Retained version comparison
  • Decision-log accountability
WHAT IT DOES NOT DEMONSTRATE

Bounded acceptance claim

It does not demonstrate fully automatic Stage-4 acceptance, exact frame-level motion transfer or an independent equal-budget ablation. Human review remains the final acceptance authority in the completed evidence.

  • No fully automatic acceptance claim
  • No equal-budget ablation claim
  • No exact motion-transfer claim
Dissertation§4.9 · §4.14
Transparent reporting · unresolved boundary + next research step

Limitations & Future Work

Each limitation is connected to the evidence that exposes it and a concrete next engineering step.

ScopeKnown boundaries

Unresolved research and engineering constraints.

Research significanceClaim discipline

Prototype feasibility is kept separate from production claims.

Evidence presentedTraceable findings

Executed cases, diagnostics and archived trials.

Next stepEngineering next steps

Each finding leads to a specific future action.

Six bounded research areas

Evidence → limitation → next step

POST-HOC DIAGNOSTIC

Identity consistency

Limitation
Identity consistency remains difficult across view changes, profile shots and synthetic characters.
Current evidence
ArcFace was used as a post-hoc diagnostic only; human review remained the acceptance authority.
Next step
Use stronger view-aware identity references, calibrated identity thresholds and more robust multi-view evaluation.
DOCUMENTED CONTROL TRIAL

Pose / mask control

Limitation
Pose and mask reliability varies by shot type. Full-body shots are more usable, while close-up and feet-detail shots are weaker.
Current evidence
The pose/mask audit produced 9 usable candidates from 12 samples; Shot 003 had no reliable pose seed.
Next step
Use stronger temporal segmentation, tracking and ControlNet-style or backend-native pose conditioning.
TIMING LIMITATION

Timing and duration

Limitation
Fixed 5-second I2V clips do not preserve exact reference shot durations or beat timing.
Current evidence
Generated clips preserve shot order and action intent, but duration-aware generation or assembly repair remains future work.
Next step
Add duration-aware clip generation, beat-aligned trimming and assembly-level timing repair.
DESIGNED · NOT FULLY EXECUTED

Automatic Stage-4 scoring

Limitation
The fully automatic metric-driven Stage-4 loop was designed and partially instrumented, but not fully executed.
Current evidence
Human-gated review and decision logging were executed; ArcFace and optical flow were used as post-hoc diagnostics.
Next step
Connect metric outputs to automatic repair planning under explicit thresholds and rerun with equal-budget baselines.
EXTENDED WINDOW · QUALITY WIP

Mode C production scope

Limitation
Mode C remains an extended feasibility branch, not a full production pipeline, and includes documented failure cases rather than only passing results.
Current evidence
A 7.0-second Wan2.2 Animate replacement window (generated across 3 sliding-window stages, only the final stage reaching full length) extends the earlier short Phase-0 evidence. Known failure cases: identity and body-proportion distortion on extreme poses in both the Phase-0 and 7 s runs, and a session-ending GPU driver fault immediately after the 7 s run completed. Full 27-second production was not validated.
Next step
Evaluate identity stability, body proportions, temporal consistency and compute cost across longer windows before treating Mode C as production-ready.
GENERALISATION BOUNDARY

Generalisation beyond current cases

Limitation
Completed evidence is concentrated on selected beach and street cases.
Current evidence
The system demonstrates one main Mode A case, one scene-package stress test and bounded Mode C feasibility evidence.
Next step
Test additional scenes, character looks and reference-video structures using the same decision-log and metric framework.
Research boundary

Boundaries define the next engineering work.

These limitations define the next engineering steps rather than invalidating the completed evidence. The current contribution is a traceable reference-driven workflow with clear evidence boundaries.

No exact frame-level motion transfer, fully automatic Stage-4 execution, full 27-second Mode C production or pose/mask-driven final output is claimed.

Dissertation§4.15
Evidence inventory

One index, no duplicated claims

Use this page to locate artefacts; use the case studies to understand their meaning.

ScopeScope

A direct inventory of the website's evidence stories and retained artefacts.

Research significanceResearch value

It provides a fast route from a research claim to the files that support or limit it.

Evidence presentedInspectable record

Completed runs, repair records, audits, archived branches, Phase 0 and Stage-4 design status.

Claim boundaryClaim boundary

The index locates evidence; interpretation remains on the associated case-study page.

Mode A–D system map

SYSTEM OVERVIEW

SVG architecture map

Shows mode logic, shared core and claim boundaries; explanatory, not an additional experiment.

Evaluation metrics and diagnostics

POST-HOC / PARTIAL / DESIGNED

ArcFace, optical flow, pose/mask audit, framing review and timing audit

Shows how outputs were inspected and diagnosed; full automatic Stage-4 scoring was not fully executed.

Reference video analysis

EXECUTED LOCAL ANALYSIS

test_01, test_02, test_03 and shot/camera/pose/framing records

Shows how reference videos become generation units; exact frame-level motion transfer is not claimed.

Mode B storyboard-driven ComfyUI branch

EXECUTED · SEPARATE COMFYUI PATH

Authored prompt, storyboard/visual assets, separate ComfyUI generation and 71.6 s edited final video

Completed creative extension; not routed through shared generation units and has no per-shot decision-log / repair instrumentation.

Beach Mode A-1

Completed evidence

Source frames, 4 keyframes, 4 clips, final video, logs

Proves reference-scene preservation; exact motion transfer not claimed.

Mode A-2 cross-scene recomposition

DESIGNED / PARTIALLY TESTED

Street scene-package run + archived pose-guidance branch

Explains the intended scene-replacement setting; the completed street final is not reference-video-driven.

Street scene package

Completed scene-package evidence

Scene refs, 4 keyframes, 4 clips, final, motion audit

Identity/scene stress test; reference_video = None.

Human-gated repair

HUMAN-GATED REPAIR EVIDENCE

Decision logs, retained iterations, v1/v2 clips

Documents diagnosis and retry decisions, not full automation.

Pose / mask audit

TESTED + DOCUMENTED CONTROL-SIGNAL TRIAL

12 samples, contact sheet, manifest, ZIP

9/12 candidates; diagnostic, not production hard control.

Structure-transfer branch

TESTED + ARCHIVED NEGATIVE RESULT

Start/end preview and limitation report

Guidance strength was insufficient.

Mode C Wan2.2 Animate 7s replacement test

EXTENDED WINDOW TEST · QUALITY WIP

Privacy-redacted control display, mask video, generated replacement and metadata

Shows longer-window driving-video replacement feasibility; full 27-second production not validated.

Mode C Phase 0

PHASE 0 PASSED · QUALITY WIP

Driving input, mask, short replacement output

Full 27 seconds not validated.

Automatic Stage-4

Designed · not fully executed

Dry-run design and partial instrumentation

No claim of fully automatic acceptance or regeneration.

LoRA identity experiment (ComfyUI)

SIDE EXPERIMENT · QUALITATIVE ONLY

ChatGPT-generated dataset sample, ComfyUI-trained face LoRA, 4 generated output samples

Independent of the Mode A/B/C pipeline; qualitative stability comparison only, no metric computed.
Secondary research extension · separate creative path

Mode B — Storyboard Prompt Extension

Storyboard-driven ComfyUI branch and completed edited final

EXECUTED · SEPARATE COMFYUI PATH

Mode B was executed end-to-end as a storyboard-driven branch: authored story prompt, storyboard panels and visual planning assets were taken through ComfyUI generation and assembled into a 71.6-second edited final video (3840×2160, 30 fps, 4 Aug 2026). This demonstrates the second structure-source pathway in practice. However, this branch ran on a separate ComfyUI path rather than through the shared generation-unit pipeline, and it was not instrumented with per-shot decision logging or human-gated repair records. It is therefore reported as a completed creative extension, not at the same evidence maturity as the Mode A beach run.

Research role. Mode B constructs sequence structure from an authored prompt, storyboard panels and visual planning assets rather than extracting it from a reference video. Its completed final demonstrates that alternate structure-source path in practice without claiming validation of the shared Mode A generation-unit workflow.

Source
Authored story prompt, storyboard panels and visual planning assets
Generation path
Separate ComfyUI branch
Retained output
71.6 s edited final · 3840×2160 · 30 fps · 4 Aug 2026
Evidence boundary
No per-shot decision-log or human-gated repair instrumentation; not at Mode A evidence maturity
Curated asset record

Visual planning evidence for the Mode B branch

Character, environment, storyboard and VFX material are grouped by their planning role. Every item below is an existing file copied without regeneration.

READ ONLY

Evidence boundary. Mode B completed an end-to-end creative path on ComfyUI, but it did not run through the shared generation-unit, evaluation and repair path. It has no per-shot decision-log or human-gated repair evidence, and is therefore not reported at the same evidence maturity as the completed Mode A beach run.

Side experiment · independent of the Mode A/B/C pipeline

LoRA identity experiment — Olivia Face LoRA (ComfyUI)

A locally trained face LoRA, tested against the ChatGPT-generated dataset it was trained on

SIDE EXPERIMENT · QUALITATIVE ONLY

This page documents a separate, author-run experiment: training a face LoRA in ComfyUI on a synthetic identity, then comparing the LoRA's own generations back against the dataset that trained it. The training images were not photographs of a real person — they were generated by the author using ChatGPT image generation, then curated down to a training set. This experiment sits outside the dissertation's reference-driven pipeline; it does not feed Mode A, Mode B or Mode C, and no claim is made that it was used to produce any of the beach, street or Mode C evidence elsewhere on this site.

Research role. The question this experiment asks is narrow: once a synthetic identity exists only as a set of ChatGPT-generated images, can a locally trained LoRA reproduce that identity as reliably as the model that generated the training set in the first place? The comparison below is a qualitative, human-reviewed one — no identity-similarity metric (ArcFace or otherwise) was computed across the LoRA outputs, so no quantitative stability score is claimed.

Dataset source
64 portraits generated by the author with ChatGPT image generation; 40 curated for training
Training
Face LoRA trained locally in ComfyUI on the 40-image curated set
Retained output shown here
4 author-selected LoRA generations (not an exhaustive or systematically sampled output set)
Evidence boundary
Qualitative comparison only; independent of the Mode A/B/C evidence chain; not reported in the dissertation
40curated training images
4generated evaluation samples
Curated asset record

Dataset sample vs. LoRA output

The dataset row shows the ChatGPT-generated training images the LoRA was built from. The generated row shows the LoRA's own output when run in ComfyUI after training.

READ ONLY

What this shows. Reviewed side by side, the LoRA's own generations track the trained identity's general look (hair, colouring, styling) but are visibly less consistent than the ChatGPT dataset that trained them — facial structure, lighting character and likeness drift more from image to image. This is reported as a human-observed qualitative comparison on a small, author-selected sample, not a measured stability score.

What this does not show. This experiment does not validate a production-ready identity LoRA, was not used anywhere in the Mode A, Mode B or Mode C evidence chain, and is not reported as dissertation evidence — it is retained here only as dashboard-level context on identity-consistency work attempted outside the main pipeline.

Research architecture · implemented prototype and bounded extensions

System architecture

The dissertation contribution is a traceable orchestration system. The architecture is separated into an implemented evidence path, a logical modes map and four conditioning inputs.

Engineering dissertation
ScopeScope

The implemented orchestration architecture and bounded A–D mode taxonomy.

Research significanceResearch value

Separating structure, identity, look, scene, review and logs makes claims and failures traceable.

Evidence presentedInspectable record

Code-native system diagram, five-track schema, model/tool stack and evaluation boundary.

Claim boundaryClaim boundary

Logical modes do not imply equal maturity; Mode D is planned and automatic Stage-4 is incomplete.

Project structure · logical modes and shared core

Mode A–D project structure

The reorganised figure separates mode maturity from the shared evidence workflow, conditioning inputs and claim boundaries. It is an explanatory system map, not an additional experiment.

Mode A to D project structure diagram
Mode letters classify control logic, not equal evidence maturity. Mode B completed a separate ComfyUI path; Mode D remains planned, with exploratory hosted demos only.Open full-size project structure SVG ↗
Architecture in three viewsImplemented core · logical modes · conditioning inputs
01 · Implemented evidence path

Core Evidence Pipeline

The completed cases use a readable, shot-level path from a structural or scene input to reviewed final assembly.

Stage 101

Understand

Reference / Scene InputGeneration Units

The system converts a reference structure or scene package into inspectable shot-level records.

Stage 202

Condition

Identity + Look + Scene PackagesKeyframe Generation

Each shot is regenerated from separated identity, styling and scene evidence, with one reviewed visual anchor per shot. Keyframe-first follows the pose-to-pose principle of classical animation (dissertation §2.1): a short-form clip is a few readable key poses joined by beat-timed cuts, so the pipeline fixes the pose first and delegates in-betweens to I2V.

Stage 303

Produce + Review

Kling I2VReview + Decision LogFinal Video

Approved keyframes become prompt-level I2V clips. Human-gated review and repair records are logged before final assembly.

The implemented evidence preserves shot structure and action intent, not exact frame-level motion transfer.

02 · Logical classification

System Modes Map

Mode describes how the system operates. It does not imply that every branch has the same evidence maturity.

A

Reference video pipeline

Primary dissertation path. Mode A-1 is completed; Mode A-2 is designed and partially tested.

A-1 completed · A-2 partial
B

Storyboard prompt extension

Executed end-to-end on a separate ComfyUI path and assembled into a 71.6 s edited final. No shared generation-unit or per-shot repair instrumentation.

EXECUTED · SEPARATE COMFYUI PATH
C

Driving-video backend

Separate backend. Not part of the Mode A/B keyframe-first core.

Phase 0 + 7s window · quality WIP

A 7-second local window completed on 4 Aug 2026; full 27-second production remains unvalidated.

D

Planned extension

Person + background replacement concept. Hosted-service demos were exercised on 4 Aug, but carry no evidential weight; no local implementation exists.

PLANNED · HOSTED DEMOS ONLY
03 · Provenance model

Separated Conditioning Inputs

Each source has one clear responsibility, so a failure can be diagnosed against the correct control signal.

Structure

Reference structure

Shot order · framing · action intent

Identity

IP identity

Subject identity and view-specific reference material

Styling

Look package

Outfit · hair · styling

Environment

Scene package

Environment · viewpoint · lighting

Keeping these inputs separate makes provenance clearer and allows each failure to be diagnosed against the correct control signal. The street scene-package case used reference_video = None.

Anchor system · dissertation §3.2.1 and §3.5.2

View-aware anchors and locked reference order

The anchor design separates structural, identity, styling and scene responsibilities so each shot can promote the evidence most relevant to its view.

Multi-view anchor set (dissertation §3.2.1)

Identity is anchored per view

The Look 3 identity is not one image but a purpose-built anchor set: a front-facing facial anchor, a side/profile anchor and outfit references — each authored to control a specific axis of appearance. Identity is anchored per view, so a profile shot is conditioned by the profile anchor rather than a stretched frontal reference.

Look 3 front-facing identity anchor
Front-facing identity anchor
Look 3 profile identity anchor
Profile identity anchor
Locked slot order (dissertation §3.5.2)

Reference order is explicit

Keyframe generation supplies four reference images in a locked slot order: slot [0] the source frame (primary structural anchor for framing, body scale and camera distance), then identity anchor, look reference and scene reference. Slot priority is shot-type-specific: face-visible shots promote the identity anchor; back-view and feet-detail shots promote the scene/source references. This ordering is a tested heuristic, not a model guarantee.

  1. 0Source frame
  2. 1Identity anchor
  3. 2Look reference
  4. 3Scene reference
Shot representation

Five fields make each generation unit inspectable

A shot is recorded as structured evidence rather than treated as one opaque prompt. Each field supports a different diagnostic question.

01Camera motion

Pan, tilt, push, pull, tracking direction, intensity and stability.

02Character motion

Action intent, body displacement, direction and visible motion requirement.

03Framing

Shot size, subject placement, orientation and camera relationship.

04Timing

Source start/end, duration, beat position and assembly relationship.

05Scene

Preserve/replace policy, environment lineage, lighting and viewpoint.

The five-track record is the hand-off between analysis, keyframe creation, I2V, review and repair. It does not claim exact motion copying.

Model and tool stack

One role per component

The stack is grouped by research responsibility and evidence status, avoiding a dense implementation table.

Analysis

OpenCV + MediaPipe

Shot structure, timing, pose availability and post-hoc optical-flow diagnostics.

Executed in Mode A
Keyframes

gpt-image-1

Creates a visual anchor from separated identity, look, scene and structural references.

Completed evidence
Video

Kling I2V

Animates approved keyframes with prompt-level motion instructions and fixed clip duration.

Completed evidence
Review

Human + diagnostics

Human acceptance supported by ArcFace and optical-flow post-hoc evidence.

Human-gated
Mode C

Wan2GP backend

DWPose and SAM3 support the separate short driving-video feasibility branch.

Phase 0 only
Evaluation boundary

Review, diagnosis and future automation are separate

The public page shows what was executed without using the old automatic-loop wiring diagram as completed evidence.

Executed

Human review

Human review remained the acceptance authority for promoted keyframes, repaired clips and final assembly.

Human-gated repair evidence
Recorded

Decision log

Attempts, observed failures, diagnoses, selected repair actions and promoted results remain inspectable.

Browseable evidence
Bounded future work

Automatic Stage-4

Metric-driven scoring and paid retry orchestration were designed and partially instrumented, but not fully executed.

Designed · not fully executed

ArcFace and optical flow are post-hoc diagnostics; framing is human-coded, generated-side pose may be pending, and formal beat alignment remains pending.

The original engineering diagrams remain preserved in the project’s paper-export artefacts; they are no longer used as the primary public explanation.

Dissertation§3.2–3.7
Reusable control packages · existing project assets

Look and scene library

The prototype separates identity-adjacent styling references from environment references. This makes it possible to preserve a reference scene, or deliberately replace it with a static scene package, without confusing the two experiments.

Read-only asset evidence
ScopeScope

Reusable identity-adjacent look packages and static multi-view scene packages.

Research significanceResearch value

Separated provenance lets the system distinguish source preservation from deliberate scene replacement.

Evidence presentedInspectable record

Three look sheets, two scene packages and the preserved beach source scene.

Claim boundaryClaim boundary

These references condition approved keyframes; they are not proof of hard pose or motion control.

Structure

Reference structure

Shot order · framing · action intent

Identity

IP identity

Subject identity and view-specific reference material

Styling

Look package

Outfit · hair · styling

Environment

Scene package

Environment · viewpoint · lighting

Keeping these inputs separate makes provenance clearer and allows each failure to be diagnosed against the correct control signal.

Look packages

Three reusable styling systems

These sheets are existing reference packages in the project. Look 3 is the styling package used in the completed beach and street evidence shown on this website.

Look 1 Active Self reference sheet

Look 1 · The Active Self

Fitted activewear and a movement-oriented silhouette intended for dynamic full-body and studio shots.

Motion stability · highBuilt-in package
Look 2 Darkening Self reference sheet

Look 2 · The Darkening Self

Black velvet, organza structure and polished editorial styling designed for controlled dramatic scenes.

Motion stability · mediumBuilt-in package
Look 3 Tailored Self reference sheet

Look 3 · The Tailored Self

Charcoal tailoring, wide denim and natural styling. This is the selected look for both completed case studies.

Used in completed evidenceMotion stability · high
Scene packages · interactive read-only inspection

Environment references are explicit, multi-view inputs

Select an existing viewpoint to inspect each package. The street run uses the Parisian Street package with no reference video; the beach run preserves the scene from its source clip.

Select a view, then click to enlarge
Reference-scene preservation

The beach is a structural source, not a replacement package

This distinction is central to the dissertation claim: Mode A-1 preserves the source environment, whereas the street stress test replaces the environment using a static package.

Completed evidence
Beach source reference frame

Author-created beach reference clip

The source frame supplies beach setting, framing logic and action intent. The approved Look 3 keyframes replace the selected character/look while maintaining that scene context.

Mode A-1 structural sourceNot a scene-package run
Demonstrated separation

Beach keeps source-scene structure while replacing character/look. Street uses a static scene package with reference_video = None.

Control boundary

Look and scene references guide approved keyframes. Pose/mask extraction was diagnostic and did not act as production-ready hard control for the final outputs.

Dissertation§3.2.1 · §3.5.1
— No active run —
Run Stage 1 to begin.
Shots
Passed
Failed
Needs Human
Attempts
Click a shot to preview media

State JSON Display only

Current project_state.json — the pipeline's central source of truth.

Project State Summary
Human-in-the-Loop Events 0
No human events recorded yet.
Shot States 0
No shots in state yet.
Evaluation Thresholds
Identity (ArcFace)≥ 0.80 Pose (keypoint)≥ 0.85 Framing≥ 0.75 Beat timing≤ 250 ms Max retries3 per shot Terminal stateneeds_human
Danger Zone
Resetting the state will clear current run status, all shot attempts and evaluation results.

Decision Log Display · evidence

Per-shot attempt records (scores, verdict, diagnosis, repair) and human-in-the-loop confirmation events.

Look Library

Choose a character look for this run. Identity stays fixed. Look controls outfit, hair, makeup and visual mood.

Look Library Mode B

Two built-in 3D animated character looks. Select the one you want for this run — it becomes the IP identity anchor for all generated panels.

Girl A 3D
Girl A 3D
Black velvet mermaid gown · opera gloves · tulle ruffle shoulder · amber necklace · dark upswept hair · expressive Disney-style eyes
Highly stylized 3D cartoon · hero pose + turnaround + expressions
Girl B 3D
Girl B 3D
Grey blazer · olive tie · wide-leg jeans · dark wavy hair · expressive Disney-style eyes · casual smart style
Highly stylized 3D cartoon · hero pose + turnaround + expressions
Click a card to select · ⤢ to view full character sheet. Selected look is carried into MB1 automatically.

Run Configuration Mode A

Set the six run parameters before starting the pipeline: identity (IP character), look (outfit & styling), scene (target environment), mood / scene prompt, replacement scope, and output settings. Then run pre-flight to confirm readiness.

1 · Reference Video
🎬
Drag reference video here
or click to browse
MP4 · MOV · AVI · 9:16 recommended
Reference is analysed for structure only — shot timing, framing, pose and rhythm. Never reproduced in output.
2 · Reference Source & Copyright

Confirm usage rights before analysis. Reference is analysed for formal structure, not reproduced.

Reference source
Allowed use
Reference use: The video will only be used to extract shot timing, framing, pose and rhythm. The original footage and audio will not appear in the generated output.
3 · IP Identity not locked
front · 3/4 · profile · full body
The Four Selves / IP 01
Used for: ArcFace similarity target · IP keyframe conditioning
Identity must be loaded and locked before generation. Pre-flight will fail if not set.
4 · Selected Look not selected

Look package controls hair, makeup, outfit, shoes, silhouette and styling. Select or change look in Look Library.

5 · Scene Package Not selected

Choose the target environment. The reference video controls pose/timing/framing — the scene package controls location, lighting and background.

Thumbnail
Dark Dressing Room
Vanity mirror · velvet sofa · amber lighting
Best for: close-ups · dramatic editorial
Compatible: Look 2 · The Darkening Self
Thumbnail
Modern Street
Cobblestone · limestone facades · soft daylight
Best for: walking · full body · motion
Compatible: Look 1 · The Tailored Self
5b · Scene Mode Preserve Reference

Controls whether the source video's environment is preserved or replaced by the selected scene package.

✓ Preserve Reference Scene — background and lighting will be kept from the source video.
6 · Character Mode

This prototype supports one primary IP character per run. If the reference contains multiple people, the system selects one primary subject for structure extraction. Background people are ignored and will not be regenerated.

Single IP Character Active
One fixed IP character per run. The selected subject provides pose, framing and motion structure. Background people are treated as scene context and are not reproduced.
Multi-character Scene Coming later
Separate identity tracks, interaction logic and multi-subject evaluation are outside the current prototype scope.
Primary Subject Policy
Default selectionLargest central person in the reference video Background peopleIgnored — treated as scene context, never regenerated Multiple active performersFlag for manual subject selection before analysis Two-person interactionMark reference as out of scope for this prototype
Single subject only Background people ignored Manual selection if needed
7 · Replacement Scope Full Subject

The reference video provides pose, timing, framing and camera structure. The selected identity, look and scene packages control what is regenerated.

Preserved from reference
pose · timing · framing · camera structure
Regenerated from packages
identity · hair · makeup · outfit · shoes · body appearance · scene
Select a look and scene to see compatibility check.
8 · Pre-flight Check

Verify all prerequisites before running the pipeline. Blocked items must be resolved. Warnings allow proceeding with reduced reliability.

Reference video loaded Copyright status confirmed Reference type selected IP identity loaded Identity locked Character look selected Scene package selected Look / scene compatibility Replacement scope set Output folders available OpenAI API key found Kling API key found
9 · Human Review — Setup Confirmation
Confirm all six run parameters — identity, look, scene, mood/scene prompt, replacement scope, and output settings — before starting the pipeline.

Analyze Reference Video Mode A

Decompose the reference video into a structured source frame storyboard. Shows per shot: source frame · pose overlay · camera motion (optical flow) · character motion · framing · timing · 5-track status. Tools: PySceneDetect (cuts) · librosa (beats) · MediaPipe (pose) · optical flow (camera motion) · GPT-4o Vision (semantic enrichment).

Reference video default template
Currently analyzing: test_03_multishot_edit_4shots.mp4
Beach reference — 4 shots, audio present. The pipeline decomposes it into shot cuts, beats, pose and framing. Only its structure is reused; its pixels, scene and audio never appear in the outputs.
Switching the video changes what “Analyze Video” decomposes. Beach is the default template; an uploaded clip replaces it until you switch back. A single-take or silent clip will correctly yield 1 shot / 0 beats.
Reference Test Set structural-analysis smoke test · PySceneDetect · click a row to play
Three reference videos were analysed to verify that shot segmentation correctly separates single-take from multi-shot footage. PySceneDetect (ContentDetector, threshold 27) results — click any row to play the original clip:
Reference videoTypeResolutionDurationDetected shots
▶ test_01_static_camera_subject_move.mp4single-take · static camera1080×19209.3 s1 shot
▶ test_02_camera_push_pan.mp4single-take · push / pan1920×10807.8 s1 shot
▶ test_03_multishot_edit_4shots.mp4 main runmulti-shot edit1916×10807.9 s4 shots
The single-take clips return 0 hard cuts → 1 shot (single_take fallback); the multi-shot clip returns 3 cuts → 4 shots. This confirms segmentation correctly distinguishes single-take from multi-shot. test_03 (the 4-shot beach clip) is the reference behind all completed evidence; test_01 / test_02 are single-take smoke tests. Verified with PySceneDetect ContentDetector (threshold 27).
① Reference Strategy Router
Select strategy before analyzing — controls which tools run and how generation units are built.
Multi-shot Storyboard — reference has clear edit cuts. PySceneDetect extracts N shots; each gets one best keyframe. Best for: music videos with cuts, fashion shoots with scene changes.
Tools: PySceneDetect (shot cuts) · MediaPipe (pose) · librosa (beats) · GPT-4o Vision (semantic enrichment)
Executable · $0Local tools only — PySceneDetect · librosa · MediaPipe. Deterministic. Re-running overwrites the reference-analysis fields in project_state.json.
Ready
Executable · $0Local optical-flow camera/subject classifier. Deterministic, no API call.
Recommended for full 5-track mode  ·  separates background camera motion from subject motion via optical flow. If skipped, camera_motion uses semantic fallback (confidence: low, 5-track completeness: partial).

Source Frame Storyboard Mode A

Build the source frame storyboard from analysis results — one extracted frame per detected shot, with framing, pose, timing, and beat labels. Human reviews this before exporting the structured JSON.

Outputs
1. Source Frame Storyboard — extracted reference frame per shot, labeled with framing · pose confidence · timing · beat alignment · camera motion
2. Storyboard JSON — structured representation (generation_units) used by all downstream stages: IP Keyframes → Kling I2V → Evaluate → Repair
Executable · $0Local beat / pose / shot-cut alignment into the storyboard JSON. Deterministic, no API.
Ready

Generate IP Keyframes Mode A

Redraw each reference panel as an IP-consistent keyframe (gpt-image-1). Preserves framing, camera angle, body orientation.

PAID / EXTERNAL · NEEDS CONFIRMATIONRuns the generic stage3 / api_gen keyframe backend — NOT the tuned scripts/generation/generate_street_run.py that produced the completed street keyframes. Costs money (gpt-image-1) and may not reproduce the shown evidence.
Ready
~$0.08–0.13 per keyframe

Kling I2V — Animate Shots Mode A

Animate each IP keyframe with Kling image-to-video. Generated per-shot, never as one continuous video.

PAID / EXTERNAL · NEEDS CONFIRMATIONRuns the generic stage3 clip backend — NOT scripts/generation/run_kling_i2v.py / the tuned street script behind the completed clips. Costs money (Kling) per clip.
Ready
~$0.28 per clip

Evaluate Mode A

Scores each shot at the keyframe / image level — identity (ArcFace cosine), pose (keypoint distance), framing, beat alignment on the still keyframe. This is not full video-level temporal evaluation. For reference-vs-generated video motion, see Evaluation Report → Reference vs Generated Video Audit.

Evaluation Thresholds
Identity (ArcFace)
≥ 0.80
warn < 0.65
Pose (keypoint Δ)
≥ 0.85
warn < 0.65
Framing accuracy
≥ 0.75
warn < 0.50
Beat alignment
≤ 250 ms
warn > 500 ms
DESIGNED · NOT FULLY EXECUTEDArcFace / pose scoring is partially instrumented but was NOT the evaluation behind the completed runs. Completed evidence used human visual review; automated scores are diagnostic only.
Ready

Repair Failed Shots Mode A

Diagnose failure reason per shot → apply targeted repair → re-evaluate. Max 3 attempts. Terminal state → needs_human.

Repair Planner — Diagnosis Rules
Failure TypeDiagnosis SignalRepair ActionObserved Change
Identity drift ArcFace score < 0.80 Re-draw keyframe with raised LoRA weight Keyframe regenerated; video re-run
Pose mismatch Pose score < 0.85 Strengthen pose conditioning (increase ControlNet weight) Keyframe reused; video re-run with stronger pose
Framing error Framing score < 0.75 Rewrite framing prompt (add explicit composition instructions) Prompt updated; keyframe + video regenerated
Beat drift Beat error > 250 ms Adjust cut timing to nearest beat within snap distance Assembly timing adjusted; no regeneration
Multiple failures ≥2 metrics fail Prioritise identity fix first, then pose Sequential repair attempts
PAID / EXTERNAL · NEEDS CONFIRMATIONBase-layer repair only (seed / prompt tweak → regenerate) through the generic pipeline. Triggers paid generation; it is not the executed human-gated dissertation evidence.
Max retries:
Ready

Final Assembly Mode A

Assemble approved shot clips into a 9:16 vertical short video. Add audio and export.

Shot Timeline

Approved shots ready for assembly. Shots with status needs_human are excluded.

Audio Track
Audio source for final video (must be royalty-free or original)
Reference audio is used for beat analysis only and is never included in output. Only royalty-free or original audio may appear in the final video.
Export Settings
Resolution
Output filename
Transition
Executable · $0Local ffmpeg concat of existing approved clips. No API call.
Ready to assemble

Evaluation Report Display · evidence

Completed evidence uses human-gated diagnose-and-retry with a decision log. Automatic Stage-4 comparison is designed and partially instrumented, but not fully executed.

Mode A-1 Beach · Reference-Scene Preservation

COMPLETED EVIDENCEHUMAN-GATED REPAIR EVIDENCElive_test_03_4shots
Mode A-1 — Reference-Scene Preservation. The original beach reference video was decomposed into four shots. The output preserves the beach scene and shot structure while replacing the character with the selected Look 3 identity / outfit. Pipeline: reference analysis → generation units → keyframes (gpt-image-1) → Kling I2V → assembly, with a decision log.
final_look3_reference_driven_demo.mp4 · Look 3 · beach scene · 4 shots · 9:16.
Attempts per shot: shot_001×1, shot_002×2, shot_003×2, shot_004×3 — all approved on human review. This real attempt log is the source of the Loop OFF vs Loop ON comparison below.
Repair-loop evidence (from the real attempt log): Loop OFF first-attempt pass rate 25% → Loop ON final accepted pass rate 100%. Human-reviewed, not fully automated ArcFace / DWPose scoring.
keyframe_contact_sheet.png · the four approved keyframes
Keyframe contact sheet

Completed street scene-package run / identity-and-scene stress test

COMPLETED SCENE-PACKAGE EVIDENCElive_test_04_street_look3

The completed street run used the static street scene package with reference_video = None. It produced four approved keyframes, four Kling clips and final_look3_street_demo.mp4, with human review and a decision log. shot_001 & shot_003 received a motion_v2 prompt-level repair and were promoted into the final. This is positive identity-and-scene stress-test evidence, not a completed reference-video-driven structure-transfer result.

Static street scene package
completed run input · reference_video = None
The completed output was conditioned by scene-package/static street references. The beach clip was not the structural source for this run. Beach-vs-street motion analysis shown below is a post-hoc audit, not evidence that the completed street run transferred reference-video structure.
4 / 4
keyframes approved
1
final video
14→51%
shot_001 motion v1→v2
tested
start/end · not selected
1
Approved street keyframes
4 shots
2
Final video & motion-v2 preview
final_look3_street_demo.mp4 · approved
motion_v2 · 001+003 repaired · promoted
Left — the approved 4-shot final (Look 3, Parisian street), 2:3 vertical.
Right — the motion-v2 clips for shot_001 & shot_003 (re-prompted for stronger motion, 14→51% / 19→47% optical-flow energy), now promoted into the final on the left. v1 clips kept as backups.
3
Clip review sheet
dense · 10 frames/shot + optical flow
4
Motion audit — optical-flow capture vs reference
shotv1v2status
shot_00114%51%repaired · energetic head turn
shot_00237%kept · reference itself calm
shot_00319%47%repaired · clearer step cycle
shot_00464%kept
Reference vs street dense filmstrip
reference_vs_street_dense_filmstrip.png
Full metrics: final/motion_audit/reference_vs_street_motion_report.md · street_motion_metrics.json
5
Look 3 identity anchors
front · profile
Street reference-structure branch — TESTED + ARCHIVED NEGATIVE RESULT: this separate start/end pose-guidance attempt tried to transfer beach reference structure into the street scene. Skeleton-image guidance was too weak, so it was archived and is not the final street output.
Stage Details click any stage to expand for implementation detail
Mode A — Reference Video
A1
Reference Analysis
Shot detection · Beat tracking · Pose extraction · False-cut merge · VLM description
PySceneDetect librosa MediaPipe GPT-4o
A2
Storyboard JSON
Beat alignment · VLM enrichment · Production blueprint per shot · Schema v0.2
Beat snap GPT-4o vision 6-layer schema
Mode B — Animated Storyboard
B1
Character Look + Story Prompt
Select 3D character look · write natural language story prompt
3 looks · 1 template
B2
LLM Panel Plan
GPT-4o converts story + template → structured panel JSON (action, pose, mood per panel)
GPT-4o ~$0.01
B3
Storyboard Sheet
Generates a 4-panel animated storyboard contact sheet from the panel plan.
gpt-image-1
B4
Panel Review
Human reviews sheet · approve panels → auto-crop to Storyboard JSON format
Human-in-loop
Shared output: Storyboard JSON / generation_units
Shared pipeline
03
IP Keyframes
Redraw each source panel as the fixed IP character · gpt-image-1 · LoRA / pose conditioning
gpt-image-1 IP conditioning Phase 0
04
Video Shots (I2V)
Keyframe → short clip · Kling AI image-to-video · per-shot, beat-aligned
Kling AI I2V 9:16
05
Evaluation
Identity · Pose · Framing · Beat alignment · Per-shot decision log
ArcFace MediaPipe InsightFace
06
Repair Loop
Fail → diagnose → targeted fix → retry · max N attempts · terminal state needs_human
Rule planner Agentic loop

The Evaluation ↔ Repair loop (05→06→03) is what makes this system agentic.

Mode A vs Mode B
Aspect Mode A Mode B
Starting pointReference videoNatural language story prompt
Character sourceFixed IP identity + selectable look packageBuilt-in 3D animated character look
Storyboard sourceExtracted from videoGenerated from panel plan
Structure sourceDetected cuts and beats4-panel animated storyboard template
Source panelsExtracted keyframesGenerated storyboard panels
OutputSame Storyboard JSONSame Storyboard JSON

Both modes are converted into the same storyboard JSON. From the keyframe stage onward, they use the same generation, evaluation and repair process.

Models and Tools
Step Tool Used for
Story plannerGPT-4oConverts story prompt into panel_plan.json
Storyboard sheetgpt-image-1Generates 4-panel animated storyboard contact sheet
Panel reviewHuman reviewApproves or edits panels before JSON export
Shot cutsPySceneDetectFinding shot boundaries
BeatslibrosaReading rhythm and beat timing
PoseMediaPipeExtracting body keypoints
FramingBounding boxesChecking face and body placement
KeyframesOpenAI image backendWhole-person IP regeneration (face, hair, outfit, shoes, body)
VideoKling APITurning keyframes into short clips
IdentityArcFace / InsightFaceFace embedding cosine similarity vs IP references
Look evalGPT-4o visionHair, outfit, shoes and palette consistency check
RepairRule-based plannerTargeted fix per failure type (identity, pose, framing, look)
Evaluation and Repair Loop agentic evidence
Generate attempt
Create a keyframe or video shot.
Check result
Measure identity, framing, pose and timing.
Accept or repair
✓ Pass — keep the shot
✗ Fail — record the reason
Choose repair action
Identity issue → redraw keyframe
Framing issue → rewrite framing prompt
Motion issue → rerun video only
Timing issue → adjust cut timing
Try again
Only the failed shot is regenerated. After the retry limit, the shot is marked needs human.
Evaluation Metrics
Face match
ArcFace / InsightFace cosine similarity
threshold ≥ 0.80
Pose match
Keypoint distance from the source pose
threshold ≥ 0.85
Framing match
Face and body placement inside the vertical frame
threshold ≥ 0.75
Beat timing
Cut timing compared with detected beats
threshold ≤ 250ms
Repair success
How often a failed shot passes after retry
experiment metric
Human review
How many shots need manual intervention
decision log count
Log quality
Whether each attempt records scores, verdict and repair action
dissertation evidence
Mode C Phase 0 Evidence PHASE 0 PASSED · QUALITY WIP
Mode C Phase 0 was executed on the verified remote GPU host w33108 using Wan2GP with int8 / offload settings. The test demonstrates that the replacement pipeline can run on 16 GB VRAM for a short 4 s segment. The result is evidence of technical feasibility, not final production quality.
driving_segment_test2 (input)
phase0_mask (SAM3 person)
phase0_replacement_v1 (output)
Hostw33108 (remote)
GPUNVIDIA RTX 4080 · 16 GB VRAM
Envmodec · Python 3.10.20 · torch 2.6.0+cu124
RuntimeWan2GP · int8 quant + CPU offload · SDPA
StatusPhase 0 passed
Limitationquality WIP · full 27 s not validated · identity / background preservation still under evaluation
Wan2GP selection rationale: the Phase 0 execution used Wan2GP because the official Wan2.2-Animate 14B repo had dependency / ABI friction (flash-attn build), and the 16 GB VRAM budget required low-memory execution (int8 + offload). Wan2GP provides that path via SDPA attention without flash-attn.
Reference vs Generated Video Audit SAFE DISPLAY · VIDEO-LEVEL AUDIT

Post-hoc comparison only: generated street clips are compared with the beach clip using Farnebäck optical flow at a common height, native aspect preserved. Because the completed street run used reference_video = None, this audit does not establish reference-video structure transfer. It reports motion-energy / amplitude differences, not exact frame alignment or pixel-level correspondence.

shotreference avg (%h/frame)generated (street)motion recoveredreference motion character
shot_0010.336 (pk 1.48)0.04714%energetic head-turn toward camera
shot_0020.119 (pk 0.49)0.04437%calm slow walk away (calmest reference shot)
shot_0030.753 (pk 2.57)0.14119%most active — stepping feet + turn
shot_0040.273 (pk 0.83)0.17564%lateral walk with camera movement
"Motion recovered" = generated per-frame optical flow ÷ reference per-frame optical flow, for the matching shot. Single-still I2V cannot reach 100% of real-footage motion energy; the residual is a quantified, honest limitation.
Dense filmstrip — reference vs generated (per shot)
Reference vs street dense filmstrip
v1 vs v2 motion repair — shot_001 & shot_003 promoted to official run

shot_001 and shot_003 were re-prompted (damping words removed, motion cues named) and have been promoted into the official street run — the final now uses the v2 clips for these two shots (14→51% / 19→47% motion-energy recovery). The v1 clips are retained as backups.

Clip review sheet motion v2 preview
↗ full motion report (.md)↗ metrics (.csv)

Archived-log terminology. “Real footage” in the archived audit log is shorthand for the motion-target role. The reference clip is the author-created AI-generated beach performance clip (dissertation §5.3); the logs are preserved unedited.

Experiment Design

Future-work ablation design: compare Loop OFF and Loop ON under identical conditions. It has not been fully executed and is not presented as dissertation result evidence here.

Loop OFF — Ablation Baseline

Designed one-shot baseline with repair disabled. DISPLAY ONLY · FUTURE WORK.

Loop ON — Automatic Stage-4 Design

Proposed metric-driven diagnosis and retry framework. DESIGNED · NOT FULLY EXECUTED.

Human-gated attempt-log reconstruction HUMAN-GATED REPAIR EVIDENCE
Display of verified attempt-log evidence only.
Automatic Stage-4 scoring loop DESIGNED · NOT FULLY EXECUTED
No complete automatic Stage-4 experiment data found. Completed evidence uses the human-gated decision-log workflow.
Metrics Comparison
MetricLoop OFFLoop ONΔBetter
Formal automatic ablation not fully executed. Simulated records are excluded from dissertation evidence.
Derived from the beach run's real attempt log (keyframe approval = human review). Loop OFF = first attempt only; Loop ON = with the evaluate→repair loop. Identity was measured post-hoc with ArcFace (buffalo_l) on the Loop-ON keyframes: avg 0.30 cosine over the 2/4 shots with a detectable face (shot_002 back-view, shot_003 feet-insert — no face). The value is low because ArcFace is calibrated for real faces, not synthetic IP characters — which is exactly why human review was the acceptance signal, not a hard 0.80 threshold. Loop-OFF identity is unavailable (first-attempt keyframes were not retained). Pose / framing / beat were not recorded for this run.
Shot-by-Shot Comparison ↑ = improved vs OFF
Only verified human-gated attempt-log records may appear here.

Mode C — Driving Performance Video PHASE 0 PASSED · RUNS ON 16GB QUALITY WIP

Person replacement driven by a performance video (Condition A: replace the performer, preserve the original background, camera, duration and timing). Phase 0 passed — a short low-res single segment ran end-to-end on the 16 GB GPU (via Wan2GP, int8 + CPU-offload), producing a background-preserving character replacement that follows the driving motion. Quality (proportions/identity on extreme poses) and the full 27 s loop are still WIP.

Backend status Phase 0 passed
Environment
Status
Detail
Local host (this dashboard)
blocked
No GPU / CUDA / torch. Cannot run generation.
Remote GPU host w33108
env verified
RTX 4080 · 16 GB · CUDA 12.9 · Python 3.10.20 · torch 2.6.0+cu124 · cuda True (tensor test passed) · ffmpeg/git · cv2/numpy/PIL/imageio/moviepy/tqdm OK · GPU memory clear · conda env modec
Wan-Animate backend
Phase 0 executed
Phase 0 was executed via Wan2GP (int8 quant + mmgp CPU-offload, SDPA attention). The official 14B repo hit flash-attn ABI issues on this torch build; Wan2GP was the working low-VRAM path. SAM3 mask + DWPose pose were generated on-device.
Full Mode C generation (27 s)
not validated
Phase 0 passed; full 27 s generation remains future work and is not claimed as ready.

Phase 0 result: PASSED. A ~4 s low-res (480×832, 81 frames, int8) single segment ran end-to-end on the 16 GB RTX 4080 via Wan2GP. Outcome: it runs on 16 GB ✓, the generated character follows the driving motion ✓ (squat sequence transferred), the original background is preserved ✓ (room/floor unchanged outside the person mask), and identity/proportions distort on extreme poses (the deep-squat frame) — a quality limitation, not a feasibility failure. Full 27 s generation and quality tuning (more steps/res, relighting) remain WIP.

Phase 0 已通过:约 4 秒低分辨率单段在 16GB RTX 4080 上(经 Wan2GP,int8+offload)端到端跑通 —— 能替换人物、保留原背景、跟随动作;极端姿势下比例/身份会漂移(质量问题,非可行性问题)。完整 27 秒与画质优化仍在进行中。

Phase 0 evidence runs · background preserved

Driving performance (control) → SAM3 person mask (white = replace, black = keep) → Wan-Animate replacement with the Look reference. This preserves action intent + background, not exact frame-level transfer.

driving segment (input)
SAM3 person mask
replacement output (v1)
Findings
✓ Runs on 16 GB (Wan2GP int8 + mmgp offload)
✓ Motion follows the driving performance
✓ Background preserved outside the person mask
⚠ Identity / proportions distort on extreme poses (deep squat) — quality WIP
Wan2GP · Wan2.2-Animate-14B int8 · SDPA · 480×832 · 81f · 30 steps. Not the official 14B repo (flash-attn ABI). Full 27 s = future work.
Conditions
Condition A — Replace Character, Preserve Original Scene Phase 0 passed · quality WIP
Backend: Wan2.2-Animate Replacement Mode, run via Wan2GP on w33108. Phase 0 (short low-res segment) passed — see evidence above. Quality tuning + the full 27 s loop are next; the in-dashboard full-generation button stays disabled (generation runs on the GPU host, not here).
Condition B — Replace Character and Scene planned
Not started. Disabled.
Reference material on file

Driving video mode_c.MP4 (27 s, ~30 fps) is on file; the remote GPU host was verified and Phase 0 was executed there. No generation runs from this dashboard host. Full repository audit + phase plan: docs/MODE_C_CONDITION_A_AUDIT.md.

Experiment: Loop OFF Baseline DISPLAY ONLY FUTURE WORK

Designed one-shot baseline with repair disabled. This page does not run or create dissertation evidence.

DESIGNED · NOT FULLY EXECUTED. Simulated experiment records are excluded from dissertation evidence.
Experiment Config
ModeLoop OFF (evaluate only, no repair) Max attempts per shot1 Result keyexperiments.loop_off
DISPLAY ONLY · FUTURE WORK

Experiment: Automatic Stage-4 Scoring Loop DESIGNED · NOT FULLY EXECUTED

Designed experiment for metric-driven evaluation and repair. It is partially instrumented, but it is not the executed evaluation of record for the completed evidence.

DISPLAY ONLY · FUTURE WORK. The executed evidence is the human-gated diagnose-and-retry log.
Experiment Config
ModeAutomatic Stage-4 scoring (designed · not fully executed) Max attempts per shot retries Result keyexperiments.loop_on
DESIGNED · NOT FULLY EXECUTED

Comparison Design DISPLAY ONLY FUTURE WORK

Planned Loop OFF vs Loop ON comparison schema. Simulated records are not shown as dissertation evidence.

DESIGNED · NOT FULLY EXECUTED. No executable experiment action is available from this page.
Aggregate Comparison
MetricLoop OFFLoop ONImprovement
No data yet
Shot-level Comparison
No data yet.

3D Animated Storyboard Prompt Mode B Experimental branch

Choose your 3D character, describe your animated idea, then generate a storyboard contact sheet.

A Choose Your Character — one active per run
Girl A 3D
Girl A 3D
Black gown · opera gloves · formal
Highly stylized 3D cartoon · character sheet included
Girl B 3D
Girl B 3D
Grey blazer · olive tie · casual
Highly stylized 3D cartoon · character sheet included
B Your Story

One sentence is enough — click 🎬 Expand to let the director AI build the full arc. Or write it yourself.

One sentence → 8-beat director's brief
Prompts:
C Storyboard Template
3D Animated 8-Panel Short
8 panels · 10 seconds · 1.25s per panel · director-driven emotional arc
Active
WS
①Hook
world revealed
MS
②Setup
character enters
MCU
③Inciting
something shifts
CU
④Build
tension rises
MS
⑤Escalation
peak action
WS
⑥Peak
frozen at top
MCU
⑦Reversal
emotional turn
CU
⑧Button
held on feeling

Generate Storyboard Sheet Mode B

Generate an 8-panel director's plan with GPT-4o, then draw the 4×2 contact sheet with gpt-image-1.

PAID / EXTERNAL · NEEDS CONFIRMATIONPanel-plan and storyboard-sheet generation call paid OpenAI services. Local upload and crop actions are separate.
Complete Step ① first
A Generate Panel Plan — GPT-4o director · story → 8-panel JSON with expression arc + video prompts
Complete Step ① first
~$0.01 · ~10s · GPT-4o · produces video_prompt_pack per panel
B Generate Storyboard Sheet — gpt-image-1 · 4×2 contact sheet (8 panels)

Uses panel_plan.json to draw all 8 panels as a single previs contact sheet (1536×1024).

Generate Panel Plan (Step A) first
~$0.04 · ~30s · gpt-image-1
C Crop into Panels — auto 4×2 grid for 8 panels
Generate a sheet first

Panel Review Mode B

Review each panel: beat role, action, camera, expression, and start / middle / end video prompts.

Generate panel plan in Step ② first.

Storyboard JSON Mode B

Compile annotated panels into structured JSON. Each panel becomes an animated_panel generation_unit — same schema as Mode A, shared downstream from here.

Annotate panels in Step ④ first

Run Core Pipeline Mode B

Experimental storyboard JSON → paid keyframe generation → paid Kling I2V → partially instrumented evaluation / repair design.

PAID / EXTERNAL · NEEDS CONFIRMATION. Mode B shares pipeline concepts with Mode A, but full automatic Stage-4 execution is DESIGNED · NOT FULLY EXECUTED.
Runs: IP Keyframes → Kling I2V → Evaluate → Repair (in sequence)
— or run individual stages below —
Ready
gpt-image-1 panel redraw
Run keyframes first
Ready
Run evaluation first

→ View results in Overview