Export formats

An export renders a mascot (and, for animated formats, one of its animations) to a file. Exports are jobs because video encoding takes a few seconds, but they never call a model. On Maker and Studio they never cost credits; on Free, one animation of each character downloads free and 50 credits unlocks the rest. Vector formats come straight from the rig, so they stay sharp at any size and weigh kilobytes.

Exports by plan#

Free is for trying, Maker and Studio are for shipping. On Free, exports are PNG and GIF previews up to 512 px with a small “Made with Lumorig” mark, for personal use (an email GIF counts as a GIF). The first animation (or clip) you download of a character is free, in every Free format and size, and a vector character's free animation also as Lottie, dotLottie or animated SVG, with the mark. Anything else of it (another animation, a still, a clip mascot's breathing idle, a sequence) costs 50 credits once and unlocks every Free-format download of it: all its animations or clips, including ones added later, at any allowed size. Without enough credits that request returns 402 insufficient_credits; an edited copy of uploaded art is a new character. The live <lumorig-player> embed works with a badge. Maker and Studio export every format below, clean and up to 2048 px, with commercial use. Asking for anything else on Free returns 402 plan_required with the formats Free includes in details.included. Previews follow the same rule: PNG only on Free, marked above 384 px. Self-hosted servers that don't charge credits export everything.

Formats#

Animated#

These need an animation: an animation id, an animation name, or any preset id such as wave (presets are fitted to the rig on the fly, even if you never saved one).

Stills#

animation is optional here: with it, the still is posed at time t of that animation; without it you get the rest pose.

Export options#

POST/mascots/{id}/exports

curl -X POST https://lumorig.com/api/v1/mascots/msc_…/exports -H "Authorization: Bearer $LUMORIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "format": "webm", "animation": "wave", "size": 768, "fps": 30 }'
# 202 → { "id": "job_…", "type": "export", "status": "queued", … }

curl "https://lumorig.com/api/v1/jobs/job_…?wait=60" -H "Authorization: Bearer $LUMORIG_API_KEY"
# → { "status": "succeeded", "result": { "file": { "id": "file_…", "url": "/api/v1/files/file_…", "mime": "video/webm", "bytes": … } } }

Downloading files#

A finished export job has result.file. Its url is relative to the API origin and, like every file endpoint, needs your API key.

GET/files/{id}

curl -L "https://lumorig.com/api/v1/files/file_…?download=1" -H "Authorization: Bearer $LUMORIG_API_KEY" -o pip-wave.webm

Files are immutable, so responses carry a year-long private cache header. Store the bytes on your own CDN if you serve them to users.

Previews#

For thumbnails and quick checks there is a synchronous still renderer. It answers in the request (no job), works with an API key or, for public mascots, with no key at all.

GET/mascots/{id}/preview

<img src="https://lumorig.com/api/v1/mascots/msc_…/preview?animation=wave&t=0.6&size=256" alt="Pip waving" />

Choosing a format#

Measured on one character, a two-second wave at 30 fps and 512 px. Your numbers will vary with the drawing, but the ratios hold.