avatarModel when you create a persona or session token.
For most new production builds, set avatarModel to cara-4.
A saved persona can already specify its model. When no explicit or saved model is supplied, model resolution considers the avatar’s active version, the assets it supports, and your organization’s model access. It does not simply select the newest model regardless of compatibility. Select a supported
avatarModel explicitly when your integration depends on a particular public model.Available models
Cara 3
SetavatarModel to cara-3 when an existing deployment needs to stay on the previous stable model. Cara 3 outputs 720x480 landscape video.
Cara 4
SetavatarModel to cara-4 for new production avatars, higher-resolution sessions, and stronger custom avatars from a single photo. Cara 4 supports 1152x768 landscape output and 768x1152 portrait output.
cara-4 selects the stable Cara 4 release. Selecting it does not guarantee pixel-identical output across sessions, sites, devices, or future service updates.
For custom avatar setup, see Create custom avatars and Custom avatar best practices.
Cara 4 Latest
SetavatarModel to cara-4-latest to test Anam’s newest model capabilities before they are pinned to a stable release. Cara 4 Latest is experimental and is not recommended for production sessions.
Avatar compatibility and reuse
Model selection does not generate missing avatar assets. If you explicitly request a model the avatar does not support, the request fails instead of silently switching to another model. Choose a supported model or an avatar created for the model you need. Access to a gated model and compatible avatar assets are separate requirements. Do not assume that every existing custom avatar automatically supports a new model. Test the target model with your avatar before changing production configuration. If it is unsupported, confirm the available regeneration or migration path with Anam Support; selecting a different model name alone is not a migration.Cara 3 vs. Cara 4
Cara 4 is the current generation of Anam’s avatar model. Compared with Cara 3, it produces higher-resolution video, better lip sync, more natural expressivity, smoother transitions between speaking and idle states, and stronger identity preservation for custom avatars. Cara 4 also supports portrait output for mobile and vertical layouts. To request a portrait session, setvideoWidth to 768 and videoHeight to 1152 in sessionOptions. See Video options for supported dimensions and crop behavior.
Use Cara 3 only when you need continuity with an existing integration or avatar that was built around Cara 3 output.