Where a character can live
One character, several places. Same brain, same voice, same documents — a different audience and different chrome in each.
| Surface | Who it's for | Needs a key? |
|---|---|---|
| Test conversation | You, while building | No — you're signed in |
| Website widget | Visitors to your website | No — the character must be Unlisted or Public |
| HTML Embed (iframe) | Any web page you control | Not for an Unlisted or Public character |
| Kiosk | An unattended touchscreen | Yes, built into the URL |
| Live room | A crowd talking to one character together | No |
Phone calls and WhatsApp messages are covered on their own pages: AI phone assistants and WhatsApp Business. Your own app or game connects with the Character ID, the UE Plugin (Cloud Mode) settings or the WebSocket (JavaScript) snippet on the character's Channels › Publish tab.
Test conversation — for you
The studio's own way to talk to a character while you build it. There is no separate playground page any more.
- On the Characters page, select a character and choose Test conversation. The editor opens with its test panel.
- Inside the character editor, use the chat button under the setting groups on the right. It saves your edits first, hides the editing tools and lets the character answer on the same stage, in its scene, with your saved settings. End test returns to editing.
- For characters the scene studio cannot draw — a Pixel Streaming MetaHuman, LiveFace 2D or an Unreal character — the same button opens Preview & test instead.
Two related tools: Preview in the editor toolbar hides the docks so you can look at the stage as visitors will (Back to editing leaves it), and Channels › Publish preview rehearses the real website embed before you publish. See the character editor guide.
Website widget — on your website
A launcher in the bottom-right corner of your site that opens the character. Choose one of eight templates on Channels › Publish, preview it, and copy one line of script. Full instructions: Website avatars & embed.
HTML embed — an iframe on any page
The HTML Embed (iframe) card on the character's Channels › Publish tab gives you a one-line iframe. Drop it into any page:
<iframe src="https://iamxlive.com/embed/YOUR_CHARACTER_ID"
width="400" height="600"
allow="microphone"></iframe>
The character must be Unlisted or Public for a keyless embed. A Private character needs a key added to the URL (?apiKey=iamx_…), which means the key is visible in your page source — only do that on pages you control. If the card says the saved scene is not published yet, use Publish scene so the embed shows your latest background, lighting and camera.
Options you can add to the URL
| Option | Effect |
|---|---|
?chat=false | Hides the chat column, leaving just the character. This also removes the microphone button, so use it only for a display-only character. |
?speakerId=… | Identifies the visitor, so memory and emotional state follow a specific person across visits. Pass your own user ID here if you have one. |
?render=liveface / ?render=pixelstream | Forces a specific look, overriding what the character is set to. |
?apiKey=… | An authenticated session, required for a Private character. The embed code on the LiveFace 2D tab also carries a key placeholder to replace. |
Kiosk — an unattended screen
A fullscreen, self-healing layout for a touchscreen left running all day: no browser chrome, one large microphone button, the last couple of messages, and a small emotion readout. If the network drops it reconnects by itself. The character appears with the look it has in the studio, including a Pixel Streaming MetaHuman if one is selected.
https://iamxlive.com/kiosk/YOUR_CHARACTER_ID?apiKey=YOUR_IAMX_KEY
Build that URL by hand. Create a dedicated key for the device under My workspace › API Keys (New key) — one key per terminal, so you can revoke a single stolen machine — and set the URL as the browser's start page in kiosk mode. The key is shown only once when you create it.
Live room — everyone at once
A shared page where every visitor sees the same character and the same chat. People enter a name and choose Join the chat, then talk to it together — the character addresses them by name and replies in whatever language they write in.
https://iamxlive.com/live/YOUR_CHARACTER_ID
This is the surface behind a landing-page demo or a public installation. It is the only surface where visitors see each other's messages, and their messages join the same queue you moderate in Channels › Livestream.
Choosing between them
| You want… | Use |
|---|---|
| To test a change you just made | Test conversation |
| A support assistant in the corner of your website | Website widget |
| The character inside a page layout of your own | HTML embed |
| A greeter on a screen in your lobby | Kiosk |
| A demo everyone can try at once from a link | Live room |
| A voice on a phone number | Phone |
| Answers on your WhatsApp Business number | |
| An NPC inside your game | The Unreal plugin |
| Something none of these cover | The WebSocket (JavaScript) snippet on Channels › Publish |