Production Tutorial
How to Sync AI Video to Voiceover With a Timing Map
Film evidence
Measured time protects a quiet documentary rhythm
Listening to the Wood relies on patient gestures: touching bark, shaping timber, collecting shavings, and launching the finished boat. If those visuals were forced into arbitrary clip lengths, the portrait would feel hurried or padded.
The relevant evidence is not perfect lip sync or a technical guarantee. It is the way accepted audio duration gives the edit a stable budget for close detail, wider orientation, and silence, while the final sequence still receives human review.
Listening to the Wood · 01:00 · Portrait film. This is a finished first-party Onira production, not customer proof or archive footage.
View the full film and production notesWhat to watch for
- Craft actions complete instead of being cut mid-gesture
- Close-ups and wide shots receive different time budgets
- Silence and score have room around the spoken track
The safest way to sync AI video to voiceover is to stop treating the script as a clock. Approve the exact narration, measure it, and turn the recording into a timing map before generating the final picture sequence.
This tutorial is for narration-led documentaries, explainers, and faceless YouTube films. It produces one operational artifact: a table that tells every planned visual what it must communicate, when it starts, how long it has, and what happens if the audio changes.
The timing map at a glance
| Field | Example | Why it exists |
|---|---|---|
| Beat ID | act1_beat_03 | Gives the editorial idea a stable identity |
| Audio in/out | 00:18.240–00:25.880 | Defines the exact available time |
| Spoken text | Approved line only | Keeps review tied to the accepted take |
| Beat purpose | Reveal the scale of the harbor | States what the viewer must understand |
| Visual plan | Wide harbor, worker detail, loaded vessel | Allocates picture to meaning rather than intervals |
| Transition | Match cut from rope to coastline | Describes how the sequence changes state |
| Source or uncertainty | Port records; vessel count disputed | Prevents picture from implying unsupported certainty |
| Status | Planned, generated, accepted, replaced | Separates candidates from production truth |
The map is not a screenplay, prompt library, or edit decision list. It is the bridge between accepted sound and visual production.
Step 1: approve the words for the ear
Lock the factual and editorial meaning before synthesis or recording. Read the script aloud and remove phrases that are technically correct but difficult to follow at listening speed.
Review:
- names, places, dates, units, quotations, and borrowed words;
- sentence density and breath points;
- transitions that only work on the page;
- claims that still lack a source or uncertainty marker;
- visual language that promises evidence the production cannot show.
Create a pronunciation sheet for risky terms. A late correction to one proper noun can change cadence, segment duration, captions, music cues, and every shot planned against that line.
Step 2: accept the exact performance
Generate or record the complete narration. Listen to the actual file that could ship, not a short voice sample.
The accepted take needs:
- a version ID tied to the exact script revision;
- voice, language, and performance direction;
- approved pronunciation and cadence;
- no clipping, truncation, accidental silence, or missing line;
- an owner who explicitly accepted it.
Do not silently replace the audio later. A visually identical filename containing a different performance is still a new timing contract.
Step 3: measure audio, not word count
Decode the accepted file and record its real duration. Split it at editorial boundaries rather than every sentence.
Useful boundaries include:
- a new claim or example;
- a change of place, time, scale, or subject;
- a question and its answer;
- a planned pause;
- the beginning or end of an act;
- a transition where music or environmental sound temporarily carries the film.
Store timecodes with enough precision for the editor and renderer. If word-level alignment is available, preserve it for captions, but do not let automatic alignment choose the story beats. A beat is an editorial unit, not a punctuation artifact.
Step 4: write one purpose for every beat
Before listing shots, complete this sentence:
By the end of this beat, the viewer should understand, notice, or feel ______.
If the answer is vague, the picture will probably become decorative. A line about wartime logistics may need to show scale and constraint. A line about one craftsperson may need hands, material, and consequence. A pause after a difficult claim may need restraint rather than another impressive generation.
The purpose also creates a rejection test. A beautiful shot that does not perform the beat's job is not the right shot.
Step 5: allocate shots inside the measured duration
Now divide the beat into visual events. Do not assume one sentence equals one shot or that every shot should have the same length.
For an 11.6-second beat, a plan might be:
| Time | Visual job | Direction |
|---|---|---|
| 0.0–3.4 s | Orient | Wide view establishes geography and scale |
| 3.4–7.1 s | Make concrete | Human-scale detail shows the physical work |
| 7.1–11.6 s | Show consequence | Object state changes and prepares the next beat |
Cut when information, place, time, scale, action, or emotional pressure changes. Hold when the current image still has work to do. Measured timing creates a budget; it does not replace editorial judgment.
Step 6: separate appearance from motion
For each planned shot, write two directions.
Image direction defines what the shot looks like: subject, setting, composition, lens, light, period detail, wardrobe, object state, and visible evidence boundary.
Motion direction defines what changes: character action, camera behavior, environmental movement, performance, start state, and end state.
This separation makes failures diagnosable. The still may have the correct composition while the motion attempt breaks physics. The motion may be usable while the starting frame depicts the wrong object state. Review and repair the exact problem instead of rewriting one overloaded prompt.
Step 7: plan transitions and continuity
A timing map must explain how adjacent shots connect. Record:
- the accepted starting and ending state;
- screen direction and geography;
- wardrobe, weather, light, damage, and carried objects;
- whether action continues across the cut;
- whether the transition deliberately establishes a new time or place.
The final frame of an accepted shot is stronger continuity evidence than a prompt written before generation. Update later plans from what the film actually accepted, not from rejected candidates or whichever parallel render finished last.
Step 8: let finishing consume the same clock
Captions, music, sound effects, and the final render should all use the accepted audio and timing map.
- Captions align to the spoken performance, not the draft script.
- Music follows real act lengths and transitions.
- Sound effects occupy available space without masking words.
- Shot trims and native audio stems share the same accepted in/out range.
- The final timeline points to one canonical audio version.
Review the mix on ordinary speakers as well as headphones. A score that sounds balanced in a studio headset can still bury narration on a phone.
Step 9: control revisions explicitly
When the narration changes, calculate the affected scope before generating anything else.
| Change | Minimum review |
|---|---|
| Pronunciation only, same measured duration | Audio acceptance, captions, local sync |
| Different duration inside one beat | Beat timing, shots, trims, captions, music and SFX |
| Claim added or removed | Source record, neighboring beats, picture implication, timing and captions |
| Act reordered | Downstream continuity, score structure, transitions and full sequence review |
Invalidate dependent work visibly. Hidden drift between script, voice, shots, captions, and edit is more expensive than a controlled rebuild.
Final QA checklist
Before picture fan-out:
- the exact narration file is accepted and versioned;
- every risky pronunciation is approved in context;
- every beat has precise audio in/out points;
- every beat has one written viewer outcome;
- shots fit the measured duration without arbitrary padding;
- image and motion directions are separate;
- sources and uncertainty survive the visual plan;
- transitions and continuity boundaries are explicit;
- revision ownership is documented.
After assembly, watch the complete film once without pausing. Then inspect timing defects at their exact beat IDs. The first pass tests whether the sequence works for a viewer; the second tells production what to repair.
For the underlying production principle, read Audio-First Is the Hidden Architecture of AI Documentaries. For the wider operating decision, use the audio-first filmmaking guide, and for the complete chain see the AI film production workflow.