Avatars and scenes
How do I create a Personal Avatar?
How do I create a Personal Avatar?
Use Create Avatar in Spatius Studio. The creation flow shows the current image requirements. After creation, use the Avatar’s
avatar-id in your app.Can I add a background or my own scene?
Can I add a background or my own scene?
Yes. AvatarKit renders the Avatar with a transparent background, so your application can place an image, video, WebGL scene, or native view behind it.A Personal Avatar may also have an optional 16:9 background available from Studio. See Avatar Background for the download and layout flow.
Audio
Can I send text directly to Spatius?
Can I send text directly to Spatius?
No. Motion Server receives the audio the Avatar should speak and generates motion data from it. If your application starts with text, first produce speech audio with TTS or a speech-to-speech model.
What audio format should I use?
What audio format should I use?
The canonical input is mono 16-bit PCM (
s16le) at the sample rate configured for the session. Some SDK entry points also accept Opus, and RTC integrations receive audio through their provider path.The configured format must match the bytes you send. See Audio and the SDK Reference for platform-specific formats.Why does Avatar playback stall between audio chunks?
Why does Avatar playback stall between audio chunks?
Send new TTS chunks as they are generated instead of pacing them at playback speed. Motion Server needs enough buffered audio to prepare the next motion window before the current one finishes.If only 1x paced audio is available, pre-buffer it at the start of each speech turn. See Audio: Send timing.
Integrations
Does Spatius provide a voice agent?
Does Spatius provide a voice agent?
No. Spatius turns avatar speech audio into motion data and renders the Avatar. Your voice-agent platform or application owns microphone input, turn handling, ASR, LLM, and speech generation.For a packaged agent path, use LiveKit Agents Integration or Agora Convo AI Integration.
Which integration should I choose?
Which integration should I choose?
Use a recommended integration for LiveKit Agents or Agora Convo AI. Use Direct Mode when the client owns the audio source, or Backend Mode when your application owns client delivery.See the concise comparison in Integrations.
Which client platforms are supported?
Which client platforms are supported?
AvatarKit supports Web, iOS, Android, and Flutter. The packaged RTC-provider coverage varies by integration and platform; the core iOS and Android SDKs are not limited to Agora.See SDK Capability Matrix for the current package boundaries.
Regions and support
Which Spatius regions are available?
Which Spatius regions are available?
Spatius operates in
us-west, ap-northeast, and cn-beijing.See Regions & Endpoints for endpoint and client-selection details.Where can I find pricing and plan limits?
Where can I find pricing and plan limits?
See the Spatius pricing page for current public pricing and plan information.
How do I get developer support?
How do I get developer support?
Join the Spatius Discord. Include the platform, integration, SDK version, region, error output, and a short screen recording when reporting a visual issue.