XMAX X2.1 overview

XMAX X2.1 edits video as you stream it. Publish a webcam, a video clip, or a still image as video. Use a prompt to describe the edit, a reference image to supply appearance, and drag points to guide motion. This reference has four pages: this overview, the schema, the prompt guide, and the tutorial. The base Reactor client connects with reactor/xmax-x2-1 and sends named commands. The typed SDK, @reactor-models/xmax-x2-1, provides the same commands as named methods and React hooks. See Typed Model SDKs.

At a glance

Spec	Value
Model name	`reactor/xmax-x2-1`
Pricing
Input	Source video, a text prompt, an optional reference image, and optional drag points
Output	Edited video
Drag points	Up to eight

Use the full model name when you open a session. The CLI and pricing catalog use the short slug xmax-x2-1. See Pricing & Billing.

Key features

Edit a live source

Publish video on source and receive the edited video on main_video. Change the prompt during a run.

Supply a reference

Upload a character or object image for a swap or insertion. Replace it during a run to change the reference in the stream.

Guide motion

Send drag positions for each frame in a four-frame window. Use an empty prompt for motion without a text instruction.

Quick start

The example template is the planned destination for source selection and editing controls.

npm
pnpm

npx create-reactor-app my-xmax-app --model=xmax-x2-1

pnpm create reactor-app my-xmax-app --model=xmax-x2-1

This browser example uses the base SDK. Provide a <video id="output" autoplay playsinline muted> element and a server token route as described in Authentication.

import { Reactor } from "@reactor-team/js-sdk";

const output = document.getElementById("output") as HTMLVideoElement;
const reactor = new Reactor({
  modelName: "reactor/xmax-x2-1",
  modelTracks: [
    { name: "source", kind: "video", direction: "sendonly" },
    { name: "main_video", kind: "video", direction: "recvonly" },
  ],
});

reactor.on("trackReceived", (name, _track, stream) => {
  if (name !== "main_video") return;
  output.srcObject = stream;
  void output.play().catch(console.error);
});
reactor.on("error", console.error);

const response = await fetch("/api/reactor/token", { cache: "no-store" });
if (!response.ok) throw new Error(`Token request failed: ${response.status}`);
const { jwt } = await response.json();
await reactor.connect(jwt);

const camera = await navigator.mediaDevices.getUserMedia({ video: true });
await reactor.publishTrack("source", camera.getVideoTracks()[0]);
await reactor.sendCommand("set_prompt", {
  prompt: "Replace the white ball in the hand with a small orange kitten.",
});

For named methods and React controls, use XmaxX21Model or useXmaxX21 from the typed SDK.

How it works

Connect to reactor/xmax-x2-1.
Publish a source video track.
Set a prompt. Generation starts when a prompt is set and source frames arrive. The empty string is valid.
Read the output dimensions from generation_started or state_update.
Change the prompt, reference image, or drag window as needed.
Call reset to stop generation and clear the prompt, reference image, and drag points.

There is no start command. A null prompt means no prompt was set. An empty string means generation can run without text guidance. Reset keeps the session’s output dimensions.

Overview

FastH3-Omni

EdenLive

Vidu S2-Avatar

Vidu S2-Editing

H3 Reference Turbo Realtime

FastH3

Visko Orbis Stable

Visko Orbis Dynamic

HappyOyster

LingBot World 2

LingBot

X2

XMAX X2.1

Helios

LongLive-2.0

SANA-Streaming

LTX

XMAX X2.1 overview

At a glance

Key features

Edit a live source

Supply a reference

Guide motion

Quick start

How it works

​At a glance

​Key features

Edit a live source

Supply a reference

Guide motion

​Quick start

​How it works

At a glance

Key features

Quick start

How it works