Skip to main content
PixVerse R2 Persona is a character that you talk to in real time. Create the character from an image, a name, and a persona, and choose its voice from a selection of real-time voices. The character speaks and reacts in real time. Talk to it over your computer’s microphone, and it hears you and answers. You can also talk to it through text. Each sentence that the character speaks also arrives as a transcript, so you can show subtitles. You can use a character in more than one session. Save its character_id, and attach the character in a later session instead of creating it again. The PixVerse R2 Persona reference has four pages. This overview comes first. The schema lists every command and message. The prompt guide covers the image, the persona, and how to talk to the character. The tutorial covers a character, a microphone, and a call, step by step. PixVerse R2 Persona uses the same wire protocol as every other Reactor model. You open a session with the Reactor class, send named commands, publish and receive tracks, and receive messages. Its model name is reactor/pixverse-r2-persona. The @reactor-models/pixverse-r2-persona typed SDK adds named methods and React hooks to the same protocol.

At a glance

The model name, reactor/pixverse-r2-persona, is the name that you pass to the SDK. It is also the scope of a token. The short slug, pixverse-r2-persona, names the docs folder, the typed SDK, and the row for the model on Pricing and billing.

Key features

A character from one image

Upload one clear picture, and give the character a name, a persona, and a voice. The character is ready in a few seconds. Save its character_id to use it again.

Talk or type

When you publish your microphone, the character answers your speech. You can also send a line with say. Each sentence that the character speaks also arrives as a transcript line for subtitles.

Calls you can repeat

Start a call, end it, and start another call with the same character. session_state tells you when the character can hear you and when you receive its video and voice.

Quick start

Create a session token on your server. Then connect with the base JavaScript SDK or the @reactor-models/pixverse-r2-persona typed SDK. Do not put your rk_ API key in browser code. To create tokens, see Authentication.

How it works

  1. Connect to reactor/pixverse-r2-persona. The first session_state has the phase idle. Publish your mic track now, so that the character hears you from the start of the call.
  2. Call list_voices to see the voices. To use default_voice, skip this step. Upload one image. Then call create_character with the image, a name, and a persona. The phase moves to character_ready with character_id set. In a later session, call attach_character with that id instead.
  3. Call start_call. The phase moves through starting and connecting to live. speech_ready becomes true during connecting, about 2 seconds after the call opens.
  4. Talk. Speak into the microphone, or send a line with say. The character answers on main_video and main_audio. Each sentence also arrives as a transcript line.
  5. Call end_call, or let the call end by itself. The character stays current, so start_call starts the next call.
The character does not speak first. It waits for your first turn. To have the character greet the person, wait until speech_ready and video_receiving are both true. Then say a short line such as “Hello!”. The character answers that line.The character does not answer speech that comes before speech_ready is true. It does not hear a published microphone that sends no samples. Speak after the character finishes its answer. If you speak while it answers, it may not hear you.