Skip to main content
Use Avatar Playground to see how an avatar speaks and moves before building your own UI. Choose an example or upload your own image, add a Persona, then go live.

1. Open Playground

You need Node.js 22.12+ and Vivix Studio 1.1.0+. Install and start the template:
Open the local address printed in your terminal. Select API Key in the header, enter your key, then select Verify & save.

2. Pick an example or use your image

Select Chat for a first conversation. To use your own image, select Start blank, then upload it or paste a public HTTPS URL. The starting output is 720p at 9:16; choose a portrait image with the same ratio. See Prepare a starting image for image guidance. Explore the other examples too: Walk for movement through a scene, Performance for prepared routines, Object interaction for handling props, and Pet for an animal character. Each example loads an image and character setup you can adapt before going live. Select a screenshot to view it at full size.
Chat example with an editable character setup and portrait preview

3. Write a Persona

Use a Persona to describe who the character is, how they speak, and how they behave while speaking and listening. The Persona (required) field brings these together. Start with a few sentences or adapt one of the examples. You do not need to fill in every section of the guide:
Persona field with four short sentences describing Runa's personality, replies, gestures, and listening habits
If you want more detail later, select Expand. You can organize a longer Persona with Markdown headings and check it in Markdown preview. Select Close to return to your setup.

4. Go live and talk

Select the play button under Video preview. When the avatar appears, type a message below it or enable the microphone. Change one setting at a time and repeat the same message to compare results. End the session before editing the image or Persona.

5. Bring the flow into your app

Playground follows the same path your app will use: image and Persona → create a session → play video → exchange messages. Follow the Quickstart, then choose a TRTC or Agora player as needed.

6. FAQ

Do the examples include tools, image switching, and scripted performances?

The Performance example includes tools for prepared routines and outfit changes. The application handles tool calls, image changes, and playback. See tools, image switching, and scripted performances to build these into your own application.

Where do I change the voice?

The template uses a preset voice. To choose another, see the voice guide and TTS configuration, then set tts_config when creating your session.