Studio

Character: identity, model & voice

The settings that decide who the character is, what it looks like, how it sounds, and the rules and moods it brings to every conversation.

Open a character from Characters with Open studio. The editor shows the character on a stage. The right dock holds six setting groups — Identity & model, Language & voice, Mind & knowledge, Behavior, Scene & motion and Channels, with the separate Teacher mode entry below them. Click a group to open its first tab in a panel; the group's other tabs sit in a strip at the top of the panel. The left dock holds the appearance tools.

This page covers the Identity & model and Language & voice groups, plus the Guardrails and Emotion tabs of the Behavior group. The AI model, documents, personality, memory and tools are on Mind & knowledge; publishing and channels are on Faces, phone & publishing.

Character settings are not saved automatically. Press Save in the toolbar (or Ctrl/Cmd+S); the panel footer shows "Unsaved changes · Ctrl/Cmd+S saves" until you do. Moving to another tab or menu saves first.
You do not need to fill in every tab. A new character already has a default look, voice, scene and AI settings. Give it a Name and a Background / Persona, check the voice, then press Test conversation at the bottom of the right dock. To draft everything at once, use Generate with AI in the toolbar: describe the role, press Generate setup, tick the fields you want under Review your setup, and apply them.
The AI Character Setup dialog, with a box for describing what the character should do, a Character text language menu, example buttons and a Generate setup button.
Generate with AI opens AI Character Setup. Describe what the character should do, or fill the box from one of the Start with an example buttons, choose the Character text language, then press Generate setup. You can edit the result and apply only the fields you choose.

Identity — who it is

Identity & model › Identity holds the character's own words.

The Identity & model panel on its Identity tab, with the Name, Role and Background / Persona fields filled in for a sample product guide.
Identity & model › Identity for the sample character Selim: Name, Role and Background / Persona, with the word counter above the persona box. The tab strip leads on to Model & Face, Model settings and LiveFace 2D.
FieldWhat it does
NameWhat the character calls itself, and how it appears across the studio. Up to 120 characters.
RoleA short title shown under the name on the Characters page, such as "Math teacher" or "Support agent".
Background / PersonaWho this character is, in your own words: their role, where they work, who they help, what they care about. A word counter above the field turns red when you go over the limit. This text goes to the AI on every reply.
Conversation StyleHow they speak — formal or casual, concise or detailed, which words they prefer and which they avoid.
Example Dialogues (optional)A few short exchanges written as the character would really answer (User: … / Character: …). Models imitate examples more reliably than they follow written instructions.
Cover PhotoA still picture of the character. The Characters gallery shows it until a stage portrait has been drawn, and the website widget's launcher uses it. Upload photo accepts images up to about 500 KB.
LanguagesThe languages the character replies in. All languages follows the visitor's language; Selected languages limits replies to your list (Add a language) and offers one of them when a visitor uses another. Keep at least one selected. Which languages can be spoken also depends on the voice and speech recognition.
Interaction ModeHow a conversation is triggered: Manual (text/button), Proximity, Voice-activated, Push-to-talk or Wake word.

Writing a persona that works

Write it as a description of a person, not a specification of a robot. "You are a helpful assistant" produces a generic answer machine; "You have run the front desk of this hotel for eleven years, you know every regular by name, and you would rather solve a problem than explain a policy" produces a character.

Keep facts out of the persona. Prices, opening hours, product specifications and policy text belong in the Knowledge Base, where they are looked up only when relevant instead of being re-read on every turn.

Wake word

Choosing Wake word reveals four extra settings. The character then ignores what it hears until one of your phrases appears in it — the right choice for a noisy showroom or a device left running all day. The check runs on the server, so Unreal, web and kiosk clients all follow the same rule.

Leaving the phrase list empty switches the gate off and the character answers everything. This is deliberate, so a half-configured kiosk stays usable instead of falling silent. WhatsApp messages are always answered without a wake phrase.

Model & Face — what it looks like

How you change the look depends on where the character's model comes from.

The Identity & model panel on its Model & Face tab, showing the current library avatar and shortcuts to its appearance, motion, background and model settings.
Model & Face for a Library avatar. Current avatar names the model in use and links to Edit appearance, Face & motion, Animation, Background and Model settings. Create and Upload are the other two sources.

The character editor guide covers the stage, the scene and animation tools, and testing. Custom avatars lists what an uploaded model needs.

Model settings

Identity & model › Model settings answers two questions for your own model: what kind of model it is, and which shape in it corresponds to which facial movement. For a Character Studio library character a read-only Library character card takes the place of the type, source and mapping cards — the library draws it with its own face rig and lip sync, so there is nothing to map. Its Edit the look button opens the appearance tools.

Avatar TypeWhen to use it
Unreal Engine (UE plugin)Your Unreal Engine app draws the character through the IAMX plugin. Nothing to map: the server sends the facial performance as MetaHuman face controls. The Unreal Engine connection card shows the plugin setting to use (bUseCloudMode = true).
AvaturnAvaturn characters. A ready-made mapping is included.
Reallusion CC4Character Creator 4 exports. A partial mapping is included; map the rest yourself.
Custom GLBYour own model, mapped in the Blendshape Mapping editor.
  1. Choose the Avatar Type that matches where the model came from. Types with a ready mapping show Preset available.
  2. Upload the model under Model Source rather than pasting a URL. Uploading lets the studio read the list of shapes inside the file, so the mapping dropdowns are filled in for you. Maximum 100 MB.
  3. If a Native facial rig card appears, the model carries its own calibrated facial driver and needs no mapping.
  4. Otherwise press Apply preset if one exists for the type, or Auto-detect to match names automatically.
  5. Check the Jaw and Mouth & Lips groups. A name the model does not contain is shown in red as "(not in model)".
  6. Try it with Test conversation and raise Global Gain if the mouth movement looks too subtle.
Switching Avatar Type does not replace an existing mapping — the old names stay and the face can go still. After changing type, press Apply preset explicitly.

Emotion → Face Morph Intensity sets how strongly the character's mood shows on its face (default ×0.70). Mouth shapes are held back automatically while it speaks, so emotion never fights lip sync.

Unreal plugin switches

The UE Plugin Settings card is read by the Unreal plugin only:

The group's last tab, LiveFace 2D, turns a portrait photo into a talking head. It is a plan feature and is covered in Faces, phone & publishing.

Language & Voice — how it sounds

Language & voice › Language & Voice sets the voice. The languages the character speaks are chosen on Identity › Languages.

TTS ProviderKey neededNotes
Free TTSNoIncluded voices hosted on the server. Automatic (match language) picks a voice for the conversation language.
ElevenLabsNo (optional)Uses the included IAMX voice, or your own ElevenLabs library — including your cloned voices — when you add your key. The Voice connection card shows which one is in use.
OpenAI TTSYesThere is no voice list to pick from: open Enter voice ID manually and type an OpenAI voice name such as alloy, echo or nova.
MiniMaxYesStrong for Chinese and Turkish. Enter the key as key:groupid.

Keys saved in My workspace › Settings › API Keys become the default for all your characters. For MiniMax and OpenAI TTS, Override for this character sets a separate key for this one (Manage in Settings opens the workspace keys); when a workspace owner or admin saves such a key, it also replaces the workspace default for that provider. For ElevenLabs the tab has no key field: the workspace key, when one is saved, is used for every character, and Manage my key in Settings on the Voice connection card opens the workspace keys. With a key in place, Fetch voices or Refresh voices loads the list under Voice Selection.

Create your voice

With ElevenLabs selected, Create your voice makes a voice from your own recording. It is available from the Starter plan up; on Free the card offers View paid plans.

  1. Enter a Voice name.
  2. Add an Audio recording: MP3, WAV, M4A, OGG or WebM, up to 20 MB, one speaker, no background music.
  3. Confirm that it is your voice, or that you have the speaker's permission, and press Create voice.

With the included IAMX voice, the new voice belongs to your workspace, up to the number of personal voices shown on the card. With your own ElevenLabs key, it is added to your ElevenLabs account and your provider's limits and charges apply. A voice that needs provider verification waits under Voices awaiting verification and counts toward your limit until you remove it. Delete my voice removes a personal voice you no longer use.

Choose a speech model, then test the whole reply

For ElevenLabs and OpenAI TTS, TTS Model trades response speed against quality. Compare models with the same voice and sentence.

The Language & Voice panel with the TTS Model list open, showing ElevenLabs models with their approximate first-audio time and quality.
The TTS Model list for ElevenLabs shows each model's approximate time to the first audio and its quality. Here Eleven v4 Turbo is selected; Voice Delivery below it sets the starting point for the delivery.
ElevenLabs modelFirst audioQualityAs the selector describes it
Eleven v4 TurboAbout 150 msbestNewest real-time model: natural emotion, audio tags, 90+ languages.
Eleven v4About 1 sstudioHighest quality, for narration and long text; slower in live conversation.
Flash v2.5About 75 msgoodRecommended for a live kiosk or NPC.
Turbo v2.5About 250 msvery goodBalanced: medium quality and low latency.
Multilingual v2About 500 msbestQuality first, high latency.
Multilingual v1About 600 msmediumLegacy model, best avoided.
English v1About 400 msmediumEnglish only.

The tab starts on Flash v2.5, which the card recommends for a live NPC. Eleven v4 Turbo is the newest real-time model, at about 150 ms to the first audio. Eleven v4 has the highest quality but takes about a second to start speaking, so it suits narration and long text better than live conversation.

Voice clones created before v4 must be retrained in ElevenLabs before they work with v4. When you choose Eleven v4 or Eleven v4 Turbo with a cloned voice or one of your personal voices selected, the TTS Model card shows this reminder. Until the clone is retrained, keep an earlier model such as Flash v2.5 for that voice.

OpenAI TTS offers GPT-4o Mini TTS (the default), TTS-1 and TTS-1 HD.

The timings in the selector are approximate time to the first audio, not the time from the visitor finishing a question to hearing an answer. Recognition, the AI reply, the network and playback add to it. Use Preview selected voice and settings to hear the voice, then Test conversation to judge the conversation you will publish.

Expressiveness

For ElevenLabs, Voice Delivery offers starting points — Natural conversation, Warm and friendly, Calm and clear, or Custom — use character speaking style. A profile sets Stability, Style Intensity and Speed for you.

Prosody fine-tunes delivery: Stability (low is dynamic and emotional, high is even and predictable), Similarity (how closely a cloned voice is followed), Style Intensity (0 is neutral, 1 is exaggerated), Speed (ElevenLabs only) and Speaker Boost. These are ElevenLabs-style settings; other providers may ignore them.

These values are a starting point. During a conversation the emotion engine nudges stability and style up and down, so the character sounds different when the conversation turns tense.

If the character uses real-time voice

When Core AI is set to Gemini Live (realtime) or OpenAI Realtime (voice), this tab changes completely: there is no separate speech engine, because the model produces the audio itself. Pick a voice from the Gemini Live Voice or OpenAI Realtime Voice grid, filtered by All / Female / Male. A real-time model cannot answer on WhatsApp.

Voice names are not interchangeable between real-time and standard voices. After switching between a real-time model and a standard one, come back to this tab and pick the voice again.

Guardrails — the rules

Behavior › Guardrails holds what the character must not do or say, in plain language, one rule per line. With Enable guardrails on, IAMX adds them to the AI's instructions with high priority, in standard and real-time voice conversations alike. They guide the model; they do not guarantee that every reply follows every rule.

After editing the rules, test ordinary questions and attempts to change the character's role. Keep access checks and permissions in the connected application or tool: a written rule does not replace authorization.

Emotion

Behavior › Emotion sets the character's mood. The Plutchik Emotion Wheel is the starting state across eight emotions — Joy, Trust, Fear, Surprise, Sadness, Disgust, Anger and Anticipation. During a conversation every visitor message shifts it, and the state feeds both the character's tone and its facial expression.

Emotion Engine SettingsWhat it controls
Decay Rate (decay/sec)How quickly the mood drains back to neutral. The default 0.0050 settles in about three minutes. For a public kiosk use around 0.0200 (roughly 45 seconds), so each new visitor meets a fresh character. 0.0000 never fades.
Classifier EnabledWhether visitor messages change the mood at all. It runs alongside the reply and adds no delay. Off, the wheel stays fixed and the tone never changes.
Transition Smoothing (ms)How long the face takes to move between expressions. The default 1500 ms feels natural; lower it if the face seems to lag behind the voice.
On a shared kiosk, a decay rate of zero means moods never fade — an insult from an hour ago still colours the tone for the next person in the queue. Always give a public device a decay rate.

Where to go next

IAMX AI STUDIO