Back to Blog

Editor Tutorial

Master Editor Mode — material library, image & video generation, timeline editing, and lip sync.

Classic mode tutorial

To create a Editor Mode project:

  1. Visit https://beatviz.ai/create-custom
  2. Upload your audio file
  3. Enter a project name
  4. Click Create Task
Task creation interface

Editor Mode Interface Overview

The Editor Mode interface is divided into two main sections:

  • Left Panel: Image and video generation workspace
  • Right Panel: Audio timeline (track) workspace

The goal is to generate visual content on the left and align it precisely with your audio on the right.

Custom Mode interface overview

Left Panel: Generation Workspace

The left panel contains three core functional areas:

  1. First-Frame Image Generation
  2. Video Generation
  3. Audio Analysis (reference only, no auto-generation)
  • The bottom section is the generator, where you input prompts and settings
  • The top section displays generated images and videos

This panel is where all visual assets are created before being placed on the timeline.

Right Panel: Audio Timeline

The right panel is centered around the audio timeline at the bottom.

Here you can:

  • Drag generated videos from the left panel onto the timeline
  • Align video clips with specific segments of your audio
  • Rearrange video order freely after placement

First-Frame Image Generation in Editor Mode

To generate a first-frame image:

  1. In the generator area, select Image
  2. Choose your preferred image model
  3. Enter your prompt
  4. Optionally upload a reference image
  5. Click Generate

First-frame images can later be reused to guide video generation.

Video Generation in Editor Mode

Video generation follows a similar workflow:

  1. Enter your video prompt
  2. Select a video model
  3. Optionally choose a first-frame image
  4. Generate the video

About First-Frame Images

A first-frame image defines the visual starting point of a video clip.

It strongly influences:

  • Composition
  • Character appearance
  • Overall visual direction

Using a well-designed first frame can significantly improve video consistency and quality.

First-frame image selection for video generation

Applying Videos to the Audio Timeline

Once your video clips are generated:

  1. Drag them from the left panel into the timeline
  2. Align each clip with the desired audio segment

You can also:

  • Change clip order at any time
  • Replace or remove clips freely

Lip Sync Feature in Editor Mode

LipSync uses the selected timeline clip and the audio under it. Clips longer than 15 seconds cannot be lipsynced (20 credits per second, partial seconds round up).

First put a video on the timeline. Trim it to 15 seconds or less if needed.

Two ways to LipSync

1. From the left panel

Click the clip on the timeline, turn on LipSync in the left panel, then generate. Audio is taken from the same time range automatically.

2. From the timeline

Right-click the clip and choose LipSync. This runs the same job as the left panel — no extra setup.

While LipSync is running, the clip is locked. When it finishes, the clip is replaced in place.

Chat mode tutorial

Chat uses the same Editor project as Classic. You describe the shot. BeatViz prepares the prompt, shows a card, and generates only after you confirm. Classic is still there when you want to drive the timeline yourself.

  1. Create the project the same way as Classic: upload the song, name it, and choose the aspect ratio. That ratio is used for every image and video in the project.
  2. On a computer or tablet, use Create Mode at the top. Classic is the timeline editor. Chat is the new mode. Both open the same project. The note beside the switch says chat-guided creation is new.
  3. On a phone, Editor opens Chat. There is no Classic / Chat switch.

The first time you open Editor on a phone or tablet, a note suggests using a computer. Close it once and it stays closed in both modes.

The Chat screen

Chat keeps the preview and the timeline. What changes is where the materials and the conversation sit.

  1. On a computer, materials sit next to the preview, the timeline runs along the bottom, and chat is the column on the right.
  2. On a tablet, chat is narrower so the preview gets more of the width. Materials stay beside the preview.
  3. On a phone, the preview and timeline stay on screen. Library and Chat are buttons on the bottom bar. Each opens a panel from the bottom. The chat panel is the taller one. If a shot is still generating and the library is closed, Library blinks.
The Chat screen

Describe a shot

The box under the conversation is where you ask for a shot.

  1. Enter sends the message. On a Mac, Command + Enter starts a new line. On Windows, Ctrl + Enter starts a new line. Shift + Enter also starts a new line.
  2. If you already wrote the subject, the action, and the camera, light, or style, Chat uses that text as the prompt. It is not rewritten.
  3. If you only wrote an idea, Chat turns it into a generation prompt and shows that prompt on the confirmation card. You still confirm once. Writing the prompt does not spend credits.
  4. The first time a project has no messages, BeatViz writes a short welcome. Wait until it finishes, then type.
  5. Replies follow the language of your message.

Image, video, and reference photos

The switches on the left of the box decide what the next message generates.

  1. Image keeps the image model. You can attach up to four reference photos.
  2. If the project has a character photo, Image mode places it in the first slot. Delete it when this shot should not use the character. It will not come back in this project, including in Classic.
  3. Video allows one reference photo. Choose the video model, then the duration and resolution. Each row shows its credit cost.
  4. Drag a photo from the library, or a file from your computer, onto the box. The thumbnail stays until you remove it. The confirmation card shows the reference that will be used. If you remove it, that message has no reference.

Confirm before credits are spent

Nothing is generated, and no credits are spent, until you confirm the card.

  1. The card shows the prompt, the reference photo if there is one, the model, and for video the duration and resolution.
  2. Confirm starts the job. Decline discards the card and does not charge you.
  3. If the balance is too low, the pricing window opens instead.
Confirm before credits are spent

While it generates, and when it finishes

After you confirm, you can keep typing. Chat does not lock the box while it tells you the job started, finished, or failed.

  1. When the job is submitted, Chat says it has started and is still generating.
  2. When it succeeds, the file appears in the library. On a phone, open Library to see it. Tapping a finished video plays it in the preview and closes the library.
  3. When it fails, Chat tells you the reason and whether the credits were returned.
While it generates, and when it finishes

Add a video to the timeline

Still images stay in the library. Only a finished video can go on the timeline.

  1. On a computer or tablet, drag a finished video from the library onto the timeline.
  2. On a phone, tap + to the right of the last clip. The library opens on videos. Tap a finished video and it is added at the end.
  3. Lip sync for a clip already on the timeline is in section 2.8.

Lip sync in Chat

Chat lip sync uses the same generation as Classic. On the timeline, just left of the scissors, there is a switch labeled Lipsync.

  1. Put a finished video on the timeline first. Trim it if it is longer than 15 seconds, and keep playback at 1x.
  2. Slide the Lipsync switch to the right. Every video clip on the timeline waits for you to choose one. Slide it back to the left to leave.
  3. Click that clip. The window shows the credit cost: 20 credits per second, rounded up, with a maximum of 15 seconds. Confirm starts it. Cancel closes the window and does not charge you.
  4. The clip switches to Lipsyncing and stays locked. When it finishes, that same clip is replaced by the lip-synced video. A new video also appears in the library. If it fails, the credits come back and the original clip stays.
BeatViz Editor Tutorial — Master Editor Mode