Animate a logo

A logo uploaded with engine: "logo" is traced into its own pieces: the badge or plate it sits on (base), then each letter and mark on it (piece_1…piece_n, in reading order), under a root logo that whole-logo motions move. Nothing is redrawn, so the shapes and colours are your upload's. It plays the 44 logo motions below, never the character ones, and exports like any rig.

A logo costs 60 credits once it is traced, with every motion, recolour, length, frame and sound included; one that can't be traced costs nothing. A tagline is 10 credits to set or change. See Credits & limits.

Create a logo#

POST/mascots

Upload the file first (POST /uploads): an SVG is best; a PNG or JPG works on a plain or transparent background. Flat colours trace cleanly, gradients come out as flat areas of colour, and a logo splits into at most 20 pieces (the nearest are joined beyond that). The call returns the finished mascot and its job at once; there is nothing to wait for.

curl -X POST https://lumorig.com/api/v1/uploads -H "Authorization: Bearer $LUMORIG_API_KEY" -F file=@logo.svg
# → { "id": "upl_…", … }

curl -X POST https://lumorig.com/api/v1/mascots -H "Authorization: Bearer $LUMORIG_API_KEY" -H "Content-Type: application/json" \
  -d '{ "upload_id": "upl_…", "engine": "logo", "name": "Acme" }'
# → { "mascot": { "id": "msc_…", "logo": true, "status": "ready", … }, "job": { "type": "logo", "status": "succeeded", "credits": 60 } }

Motions#

Play any of these by id: add one with POST /mascots/{id}/animations { preset }, or export it straight away by passing the id as animation. A motion the logo can't play (too few pieces, no symbol beside the name) pops it in whole instead and says so in the clip's notes.

Intros (28): play once and hold the logo#

Loops (16)#

The outline, window, light and colour effects play the same in Lottie, animated SVG, GIF and video: they are written as trim paths, masks, gradient fills and colour layers, which every Lottie player draws.

Tagline#

POST/mascots/{id}/tagline

A line or web address under the logo, set in one of three open-licence fonts and turned into outlines like the rest of the logo. The logo is shrunk to make room when it must, inside its own box. The line gets a palette colour of its own, tagline, to recolour apart, and every intro brings it in as the logo locks. A new version is made, so GET /mascots/{id}/versions steps back.

curl -X POST https://lumorig.com/api/v1/mascots/msc_…/tagline -H "Authorization: Bearer $LUMORIG_API_KEY" -H "Content-Type: application/json" \
  -d '{ "text": "acme.com", "font": "sans" }'
# → the mascot, with "tagline": { "text": "acme.com", "font": "sans" }

Setting or changing it costs 10 credits as a finished job of type tagline; the same words and font again cost nothing.

Export#

Logos export through POST /mascots/{id}/exports like any mascot. Four options matter most for a logo:

curl -X POST https://lumorig.com/api/v1/mascots/msc_…/exports -H "Authorization: Bearer $LUMORIG_API_KEY" -H "Content-Type: application/json" \
  -d '{ "format": "mp4", "animation": "draw", "duration": 2, "frame": "landscape",
        "background": "#ffffff", "sound": "whoosh", "size": 1920 }'

From an agent#

The MCP server's create_mascot takes engine: "logo", animate_mascot takes any logo motion id, set_logo_tagline sets the line, and export_mascot takes duration, frame and sound. See Use from AI agents, or the logo animation page to watch every motion on our own logo.