How Streamoji Avatars Works

Understanding the architecture and workflow of Streamoji Avatars will help you integrate it effectively into your application. This guide explains the core concepts, data flow, and how different components work together.

Overview

Streamoji Avatars operates as a cloud-based avatar generation service. Users create avatar configurations through your application's UI, which are then sent to our API. The API processes these configurations and returns optimized 3D avatar models in GLB format, ready to be used in your application.

Architecture

The Streamoji Avatars system consists of several key components:

1. Avatar Creator UI

Your application's interface where users customize their avatars. This can be built using our web components or your own custom UI.

2. Configuration Object

The avatar configuration is a JSON object containing asset IDs and color indices that define the avatar's appearance.

3. REST API

Our cloud-based API processes avatar configurations and generates GLB files. All requests require Firebase Authentication.

4. GLB Output

The API returns optimized GLB files containing the 3D model, textures, and animation data ready for your application.

How It Works

Streamoji Avatars uses a simple three-step process:

1. Customize

Users select avatar features (face, hair, clothing, accessories) through your application's UI or our embedded Avatar Creator.

2. Generate

The configuration is sent to our API, which processes it and generates a production-ready 3D avatar in GLB format.

3. Deploy

Load the GLB file into your application, game engine, or 3D viewer. The avatar is ready for animation and rendering.

For detailed implementation steps, see the API Integration Guide.

Asset System

Streamoji uses a comprehensive asset library where each customization option (hairstyles, clothing, accessories, facial features) is identified by a unique asset ID.

How Assets Work

Modular Design: Each asset is a separate 3D model that can be combined with others to create unique avatars
Gender-Specific: Assets are designed for either male or female base models to ensure proper fit and appearance
Color Customization: Many assets support color variations through predefined palettes

Browse the Asset Library to explore available options with previews and IDs.

What You Get

Every avatar is delivered as a GLB file containing:

Optimized 3D mesh ready for real-time rendering
High-quality PBR textures (albedo, normal, roughness, occlusion)
Humanoid skeleton rig compatible with standard animations
52 ARKit facial blendshapes for expressions and lip-sync
Self-contained format (2-5MB) - no external dependencies

For technical specifications, see Technical Specs.

Best Practices

Cache generated avatars locally to reduce API calls
Use avatar IDs to save and reload configurations efficiently
Implement proper error handling and loading states
Validate configurations before sending to the API

See the complete Best Practices Guide for detailed recommendations.

Next Steps

Now that you understand how Streamoji Avatars works, you're ready to start integrating:

Set Up AuthenticationExplore API ReferenceView Code ExamplesBrowse Asset Library