Reactor class (model name longlive-v2), send named commands, and
receive events. LongLive-2.0’s surface adds commands for shots, cuts, scheduling, changing the seed,
and playback control. Generation is text-driven, there is no reference-image input in this release.
At a glance
| Spec | Value |
|---|---|
| Model name | longlive-v2 |
| Pricing | |
| Resolution | 1280 × 704 |
| Frame rate | 24 fps |
| Chunk size | 29 frames (~1.2s) |
| Scene limit | 48 chunks (~58s) per scene |
| Transitions | shots (soft) · cuts (hard) |
| Input | Text only (no reference image) |
new Reactor({ modelName: "longlive-v2" }). See Pricing & Billing for how
billing works.
Key features
Multi-shot generation
One continuous session spanning many scenes: change shots and cut to new scenes without
reconnecting.
Soft shots & hard cuts
A soft
set_shot keeps the world and continuity; a hard scene_cut breaks cleanly to a new
scene.Storyboard scheduling
Schedule shots and cuts at exact chunk indices to compose a whole sequence before you press
start.
Chunks, scenes, and length
LongLive-2.0 generates video one chunk at a time. A chunk is 29 frames, about 1.2 seconds at 24fps. Everychunk_complete event carries two counters that track your position:
chunk_index: chunks since the current scene began. Resets to 0 on everyscene_cut.session_chunk: cumulative chunks sincestart. Never resets. This is the clock that scheduled prompts fire against.
- A
scene_cutends the current scene and starts a fresh one with a new 48-chunk budget, so cuts are how you extend a video. A session that keeps cutting can run indefinitely; one that never cuts stops at ~58 seconds. - A
set_shotstays in the current scene (keeping its memory) and spends from the same budget. Use it to evolve a scene, not to lengthen it.
Quick start
The fastest path to a working LongLive-2.0 app is thecreate-reactor-app CLI, which scaffolds a
runnable project. You can also clone the
open-source reference frontend
directly, or follow the tutorial for a guided
walkthrough.
- npm
- pnpm
@reactor-models/longlive-v2, with named methods (setShot,
sceneCut, start, …) and React hooks. See Typed Model SDKs.
How it works
On connect the model is live but idle. Set an opening shot withset_shot, call start, and frames
begin streaming on the main_video track. From there you drive the session in real time: send a
set_shot or scene_cut to transition at the next chunk boundary, schedule_shot /
schedule_scene_cut to plant prompts ahead, pause / resume between chunks, and reset
to clear everything and begin a new sequence.
See the schema for every command and event, and the
prompt guide for how to compose multi-shot
sequences.