Question 1

What file formats does Miris support

Accepted Answer

OpenUSD (Open Universal Scene Description) is the primary authoring format — .usd, .usda, .usdc, and .usdz are accepted. Material standards: USD Preview Surface and MaterialX. Miris also supports glTF/GLB, Gaussian Splatting (.ply / .splat), and emerging neural representations (NeRFs). Export from Blender, Maya, or Houdini using the documented export guides.

Question 2

How long does processing take?

Accepted Answer

Preview generation is typically ready in 5–10 minutes. Full Streamable Asset compilation takes 30 minutes to 3 hours depending on asset complexity. You'll receive an email when it's ready — you don't need to keep the browser open.

Question 3

Why did my asset fail to process?

Accepted Answer

Processing failures are usually caused by unsupported materials, missing textures, or external file references. Check that your USD file uses USD Preview Surface or MaterialX materials, all textures are included in the same folder, and all file paths are relative. Export guides for Blender, Maya, and Houdini cover the most common causes.

Question 4

Where do I generate a Viewer Key?

Accepted Answer

Sign in to the Miris Portal at app.miris.com and open Viewer keys from the top-right account menu. Each key takes a Key name, an Expiration, and optional Tags (a key with tags only streams assets sharing at least one of those tags; a key with no tags can access all your assets). The key is displayed once at creation — copy it immediately and store it somewhere safe. Keys can be Deactivated, Reactivated, Deleted, or have their Tags modified later from the same panel.

Question 5

What are the beta limits?

Accepted Answer

During public beta: unlimited uploads, 5 high-fidelity processing credits per month, 1000 views per account per month before watermarking, and 10GB maximum file size per asset.

Question 6

What counts as a view toward my 1,000 limit?

Accepted Answer

Each time an asset is loaded and streamed counts as one view. Views are tracked per account and reset on the 1st of each month. When you reach 1,000 views, a watermark is applied to all streams automatically. You'll receive a warning in the console before you hit the limit.

Question 7

Does the viewer work on tablet or mobile devices?

Accepted Answer

Any modern desktop, tablet, mobile, or XR headset. Browser minimums: Chrome 90+, Firefox 88+, Safari 14+ (including iOS), Edge 90+. Supported operating systems: Windows 11, Ubuntu 22.04 LTS, macOS 15.0. Streaming requires WebGL 2.0 and ES6 modules. WebXR sessions are supported on capable headsets. Quality adjusts to device and network automatically.

Question 8

How is Miris different from traditional 3D delivery?

Accepted Answer

Traditional delivery ships a complete file before anything renders, then leaves your app to handle LOD, culling, and texture streaming. Miris compiles each asset into a hierarchical, view-dependent Streamable Asset and serves only the geometry, textures, and material data the current camera needs. The device renders locally; the Miris edge network handles distribution.

Question 9

Which Miris SDK should I install?

Accepted Answer

The Miris Web SDK ships three packages: @miris-inc/components (HTML custom elements with declarative syntax for web component standards), @miris-inc/three (Three.js scene integration), and @miris-inc/core (for a different 3D library like Babylon.js or PlayCanvas). Every integration needs two credentials: a Viewer Key and an Asset ID. iOS, Android, and Unity wrappers are in development. An experimental Miris CLI distributes as a GitHub release for asset and Viewer Key automation.

Question 10

What's the difference between a Viewer Key and an API Key?

Accepted Answer

Viewer Keys are public-facing credentials safe to ship in frontend code. Two categories: Standard Keys (full-access keys created in the Portal with optional Tags that scope asset access) and Asset Share Keys (created automatically when you share an individual asset). Both can be Deactivated, Reactivated, Deleted, or have their Tags modified. API Keys are private, server-side credentials — never include them in client bundles.

Question 11

How is this different from glTF/glb hosting?

Accepted Answer

glTF and GLB are downloaded as complete files before rendering begins, and the runtime is responsible for any subsequent LOD work. Miris streams 3D data progressively at the geometry, texture, and material level — first frames render almost immediately, fidelity sharpens as more data arrives, and quality adapts to device and network in real time. Same source asset, fundamentally different delivery model.

Question 12

Is there a Miris CLI?

Accepted Answer

Yes — the Miris CLI is an experimental feature distributed as a GitHub release at github.com/Miris-Inc/cli/releases/latest. It exposes three primary command groups: miris auth (oauth and apikey subcommands), miris asset (upload, list, get, update, bulk-update, delete), and miris viewerkey (create, list, update, delete, revoke). Useful for CI/CD pipelines and bulk asset operations.

Question 13

What's the difference between a Preview and a Streamable Asset?

Accepted Answer

When you upload an asset, Miris first generates a Preview — a lower-fidelity visual representation ready in about 5–10 minutes. Once you've reviewed the Preview, you can generate a Streamable Asset: the high-fidelity, streaming-optimized version that works in the Miris Player and the Web SDK.

Question 14

What happens to my source files?

Accepted Answer

Your original source files are retained securely. Miris processes them into a proprietary streaming-optimized format, but the originals are not modified or deleted — you can re-process them later if needed.

Question 15

What's the difference between the Miris Player and the Web SDK?

Accepted Answer

player.miris.com is Miris's hosted viewer — a ready-made way to view and share your Streamable Assets via a direct link, with no code required. The Web SDK is for developers who want to embed Miris streaming into their own applications with full control over layout, interaction, and the surrounding scene.

Question 16

Why can't I see my asset in my three.js application?

Accepted Answer

Three common causes: (1) light intensity is too low — confirm your scene has at least one light with non-zero intensity, or rely on Miris's default Image-Based Light; (2) the camera and asset overlap at the origin (0,0,0) — translate the camera back along Z so it can see the asset; (3) the Viewer Key is misconfigured — verify it's the correct key, hasn't expired, and is scoped to the asset's Tags.

Question 17

Do beta credits roll over month to month?

Accepted Answer

No. High-fidelity generation credits do not roll over or accumulate. Your account resets to 5 credits at the beginning of each month.

Question 18

What happens if I run out of high-fidelity credits?

Accepted Answer

You can still upload assets and generate Previews — you just can't create new Streamable Assets until credits renew at the beginning of the next month. Existing Streamable Assets continue to stream and count toward the 1,000 monthly view limit.

Build with your stack. Stream in minutes.

Two ways to integrate

Beta access is full access

Join the beta

Full platform access

Shape what ships next

Skip the heavy lifting

Built and tested in production

Teams building with Miris

Developer toolkit

Frequently asked questions

Featured developer articles

Add 3D to your product, not to your roadmap