Developing in Sandbox Mode

Developing on top of LiveAvatar sessions can consume a lot of credits.

That's why we've decided to build Sandbox Mode. The intend is to help developers build and iterate on their API integrations without burning through credits better suited for production.

What is Sandbox Mode

Sandbox Mode is a special execution mode for LiveAvatar sessions designed for development and testing. It allows you to integrate, experiment, and validate your LiveAvatar workflows without consuming credits.

• Verifying your API integration • Testing session lifecycle events • Iterating on frontend or backend logic • Debugging any existing audio/video pipelines

While Sandbox Mode mirrors production behavior, it intentionally applies strict limits to prevent excessive resource usage.

Sandbox Mode Behaviors

In sandbox mode, the following behaviors apply:

• Avatar Restrictions - developers will only be able to use a select subset of production avatars.
  • Wayne - dd73ea75-1218-4ef3-92ce-606d5f7fbc0a (id)
• Session Duration Limits - sandbox mode sessions will terminate in around 1 minute. The session will automatically close and be treated as a maximum duration reached.
• No credit usage - sandbox mode does not require any credits to start and will not consume any credits.

These constraints ensure Sandbox Mode remains a safe and cost-free environment for development while still providing realistic behavior.

Enabling Sandbox Mode

To enable Sandbox Mode, include the is_sandbox flag when creating a LiveAvatar token Create Session Token.