Avatar creation
What Avatar styles are supported?
What Avatar styles are supported?
Spatius supports more than realistic human avatars. The Avatar creation pipeline can also support semi-realistic, stylized, and cartoon-like 3D characters.Character models can be customized through the reconstruction workflow. For an example 3D character, see the Spatius website.
How do I create a custom Avatar? Do I need an image or a video?
How do I create a custom Avatar? Do I need an image or a video?
Use Create Avatar in Spatius Studio. The current creation flow supports creating an Avatar from a single portrait image.The detailed photo requirements are shown in Studio during the creation flow.
How long does custom Avatar generation take?
How long does custom Avatar generation take?
Typical custom Avatar generation takes about 3-5 hours. The generated result is a 3D Avatar model that can be used by AvatarKit.
Can I use half-body or full-body Avatars and customize the scene?
Can I use half-body or full-body Avatars and customize the scene?
Yes. Spatius can support half-body and full-body Avatar usage.Avatar position, foreground scale, scene framing, and composition are controlled by your client experience. Rendering a full 16:9 model at high quality depends on the end user’s device GPU.
Does the Avatar include a background? Can I add my own scene?
Does the Avatar include a background? Can I add my own scene?
No. The generated Avatar does not include a fixed background or scene.Treat AvatarKit as the foreground Avatar rendering layer. Your application owns the scene composition around it: place an image, video, WebGL scene, or native view behind the Avatar render surface, then control layout through your own canvas, DOM stacking, or native view hierarchy.This background layer is not sent to Motion Server. Motion Server only receives avatar speech audio and returns motion data; AvatarKit renders the Avatar locally, and your app composites the final visual scene.
How many public Avatars are available? Can I use them without creating my own?
How many public Avatars are available? Can I use them without creating my own?
After registering in Spatius Studio, public Avatars shown in Studio can be used directly.
Can I modify an Avatar after it has been created?
Can I modify an Avatar after it has been created?
No. Updating appearance, clothing, hairstyle, or similar visual attributes after creation is not currently supported.
Audio and lip sync
Does Spatius accept text input to generate mouth movement?
Does Spatius accept text input to generate mouth movement?
No. Spatius requires an audio stream, because motion data is generated from avatar speech audio.If your application starts from text, convert that text to speech first, then send the generated avatar speech audio to Spatius.
What audio formats are supported?
What audio formats are supported?
Spatius supports common realtime audio inputs, including PCM, Opus, and WebRTC audio tracks.For PCM input, use mono 16-bit PCM. Supported PCM sample rates are:
8000, 16000, 22050, 24000, 32000, 44100, and 48000 Hz.For Opus input, supported sample rates are:8000, 12000, 16000, 24000, and 48000 Hz.Is English lip sync worse than Chinese, Japanese, or Korean?
Is English lip sync worse than Chinese, Japanese, or Korean?
English lip sync quality is expected to be strong. In normal viewing, the difference from Chinese, Japanese, or Korean should not be obvious with clear audio.
How can I evaluate lip-sync accuracy?
How can I evaluate lip-sync accuracy?
Use a lip-sync benchmark such as SyncNet for quantitative evaluation. Spatius also provides SDKs and examples that can be used to generate test clips for your own review.
What usually causes lip sync to look wrong?
What usually causes lip sync to look wrong?
Under normal setup, lip sync should not visibly drift. If you see no lip sync or obvious mismatch, check:
- Integration method: Direct Mode Integration, Platform Integration, embedded playground, or Backend Mode Integration.
- Deployment and test region: your backend, realtime provider, Motion Server region, and end-user location.
- Audio format and sample rate.
- Whether avatar speech audio is sent promptly as it is generated.
How should audio be sent to Motion Server? WebSocket, WebRTC, or REST?
How should audio be sent to Motion Server? WebSocket, WebRTC, or REST?
Use a realtime path. WebSocket and WebRTC are supported integration shapes; REST is not recommended for realtime avatar speech.For low-latency realtime agents, use a WebRTC-based integration such as LiveKit Agents Integration or Agora Convo AI Integration when that matches your stack.
Performance and limits
What is the typical first response latency?
What is the typical first response latency?
Typical time to first motion data is about 700-1200 ms. It is mainly affected by network conditions and how quickly avatar speech audio is sent to Motion Server.
What rendering FPS should I expect?
What rendering FPS should I expect?
The typical Avatar rendering target is 25 FPS.
Can I request a higher-resolution or higher-FPS version?
Can I request a higher-resolution or higher-FPS version?
The current standard target is around 1K / 25 FPS. Higher custom versions are not self-serve today.
How long does the mouth take to return after interruption or stop?
How long does the mouth take to return after interruption or stop?
Typical mouth-return delay after interruption or stop is about 1.6 seconds.This parameter can be tuned, but lower delay trades off against mouth-shape completeness and playback continuity.
How does concurrency affect performance?
How does concurrency affect performance?
Concurrency mainly means how many conversations can run at the same time. It does not inherently reduce the quality of one session, but it determines how many simultaneous conversations your plan and deployment can support.
How much does client GPU performance affect the experience?
How much does client GPU performance affect the experience?
Client GPU performance mainly affects rendering FPS and smoothness, not the generated avatar identity. Common modern devices should run the Avatar smoothly.
Expression and motion control
Can I trigger facial expressions such as smile, happy, sad, or surprised?
Can I trigger facial expressions such as smile, happy, sad, or surprised?
Not today. Beyond lip sync, explicit facial-expression control is not currently supported in the public SDK surface.The current runtime states are focused on idle, interruption, and speaking.
Can I trigger body motions such as listening, thinking, head movement, or custom gestures?
Can I trigger body motions such as listening, thinking, head movement, or custom gestures?
Not today. The current public SDK surface does not expose API control for custom body motion or gesture states.The current runtime states are focused on idle, interruption, and speaking.
Can I control gaze or eye movement?
Can I control gaze or eye movement?
User-triggered gaze or eye-movement control is not currently supported. Eye focus can be adjusted through Avatar model tuning, but it is not exposed as a runtime user setting.
Are expressions and actions manually controlled or automatically generated?
Are expressions and actions manually controlled or automatically generated?
Expressions and actions are currently inferred from audio and the Avatar model. They are not controlled through a public runtime API.
Integration and architecture
Which client platforms are supported?
Which client platforms are supported?
Spatius provides client SDKs for Web, Flutter, iOS, and Android.Third-party realtime integrations use an RTC SDK path for LiveKit and Agora.
How does WebRTC integration work?
How does WebRTC integration work?
In a WebRTC integration, the RTC path carries avatar audio and motion data to the client. The client renders the Avatar locally with AvatarKit.
Is there a runnable LiveKit demo?
Is there a runnable LiveKit demo?
Yes. The public demo repository includes a LiveKit path:https://github.com/spatius-ai/spatius-avatar-demoThe docs also include a LiveKit Agents quickstart.
How do I connect Spatius to my LLM and TTS pipeline?
How do I connect Spatius to my LLM and TTS pipeline?
Whether you use Direct Mode Integration or Backend Mode Integration, your application owns ASR, LLM, and TTS.This can become complex. For a packaged realtime-agent workflow, start with LiveKit Agents Integration.
How is work split between cloud and client?
How is work split between cloud and client?
Motion Server receives avatar speech audio and generates motion data. The client prepares and plays audio, receives motion data, and renders the Avatar locally.
Deployment and data
Where is Spatius deployed?
Where is Spatius deployed?
Spatius is deployed in
us-west, ap-northeast, and cn-beijing. Public docs and examples default to us-west, and SDKs compose endpoint URLs from SPATIUS_REGION.See Regions for the current region list and endpoint reference. Demo behavior can also depend on the realtime provider used by that demo, such as LiveKit Cloud edge routing.Is private deployment or on-prem deployment supported?
Is private deployment or on-prem deployment supported?
Private or on-prem deployment of Motion Server is not self-serve today. The current public integration model uses Spatius-hosted Motion Server plus client-side AvatarKit rendering.For strict private deployment or dedicated-region requirements, contact the Spatius team.
How should I evaluate network latency across regions?
How should I evaluate network latency across regions?
Evaluate the full path your product uses: your agent backend, TTS provider, Motion Server, realtime provider, client region, and end-user network.For low-latency production setups, keep the agent runtime, TTS provider, realtime provider, and Motion Server region as close as your deployment constraints allow.
Meeting and video-stream use cases
Can I use a Spatius Avatar inside Zoom, Google Meet, or Microsoft Teams?
Can I use a Spatius Avatar inside Zoom, Google Meet, or Microsoft Teams?
It is possible, but the solution is complex. Spatius does not push finished avatar video by default, so meeting-app output requires an additional layer that renders the Avatar and then sends video into the meeting app.This adds technical complexity and latency.
What meeting integration approach is recommended?
What meeting integration approach is recommended?
Use a self-developed client whenever possible, with AvatarKit rendering inside your own client app.
What are the limitations of a headless-browser streaming approach?
What are the limitations of a headless-browser streaming approach?
A headless-browser streaming approach must send audio, receive motion data, render the Avatar, and then push rendered video into another system.This adds operational complexity and latency compared with rendering directly in your own client.
Is there an out-of-the-box virtual camera output?
Is there an out-of-the-box virtual camera output?
No. There is no out-of-the-box virtual-camera output today.
Billing and support
Where can I see pricing and plan limits?
Where can I see pricing and plan limits?
Use the Spatius pricing page for current pricing and plan limits.Concurrency limits are hard limits in the plan. If you need higher concurrency, contact the Spatius team for a commercial quote.
How do free trial credits work?
How do free trial credits work?
Free credits may be available for evaluation. The Q&A record notes a monthly free-credit allowance and different grant plans for developers and enterprise users.Contact the Spatius team to confirm the current credit policy for your account.
What payment methods are supported?
What payment methods are supported?
The Q&A record notes USD or EUR payment through Stripe for billing. If billing is not enabled for your account yet, payment and concurrency can be set manually by the team before launch.
How do I get technical support?
How do I get technical support?
Use the Spatius Discord for developer support. Screen recordings help the engineering team debug visual or integration issues.For deeper debugging, coordinate with the Spatius team for a real-time engineering support session.
Next steps
Choose your integration path
Compare Direct Mode, Platform Integrations, and Backend Mode.
Demo projects
Run the public demos before building your own integration.
Audio concept
Understand audio input, send timing, and lip-sync behavior.