Skip to main content
Sandbox Mode is a development environment that lets you verify your integration without consuming credits.

What you can do

  • Verify API integration and session lifecycle
  • Test frontend and backend connectivity
  • Debug audio and video pipelines
  • Iterate on your implementation for free

Constraints

  • Limited avatars — only the Wayne avatar is available (ID: dd73ea75-1218-4ef3-92ce-606d5f7fbc0a)
  • Short sessions — sessions automatically terminate after approximately 1 minute
  • No credit usage — sandbox mode does not require or consume any credits

Enabling Sandbox Mode

Include the is_sandbox flag when creating a session token:
curl -X POST https://api.liveavatar.com/v1/sessions/token \
  -H "X-API-KEY: <YOUR_API_KEY>" \
  -H "content-type: application/json" \
  -d '{
    "mode": "FULL",
    "is_sandbox": true,
    "avatar_id": "dd73ea75-1218-4ef3-92ce-606d5f7fbc0a",
    "avatar_persona": {
      "voice_id": "<voice_id>",
      "language": "en"
    }
  }'
Once your integration is working in sandbox mode, remove the is_sandbox flag and swap in your production avatar to go live.