Lovely RouterDocs
Get a key
Models API

Character rigs

Turn one picture of a character into a layered, rigged 2.5D character that turns its head, blinks, talks with lip sync, changes expression and moves to music — one flat price per character, downloaded as a .livliv package.

A character rig turns one picture of a character into a living 2.5D character, head to chest (a bust): the picture is cut into layers (hair in front and behind, face, eyes, brows, mouth, ears, neck, clothes), the hidden parts behind each layer are painted in, and every layer gets the motion it needs. The result turns its head with depth, blinks, follows your pointer with its eyes, breathes, lets its hair and accessories swing, talks with lip sync, changes expression and bobs and sways to music.

You get it as a .livliv file: a LivLiv model package (a ZIP of the layers and a model.json). Play it in the Talking character playground, or in your own page with the open-source LivLiv Player.

Price#

character-rig costs $2.99 per character, whatever the picture. The price is held from your balance when the rig starts and charged when it is ready; a rig that fails is free. Making it takes 7 to 9 minutes.

Make one#

Save the character with POST /v1/characters, then ask for its rig:

cURL
curl https://lovelyrouter.com/v1/characters/CHARACTER_ID/rig \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -F consent=true \
  -F image=@front.png

image is optional: without it the rig is made from the character's photo, or else from the front view of its turnaround sheet. Poll GET /v1/characters/CHARACTER_ID/rig/job until status is succeeded, then download the package from GET /v1/characters/CHARACTER_ID/rig. To save a character and start its rig in one call, add rig=true (and consent=true) when you create it. Every field and status is in the Character endpoints.

Pictures that work best#

  • One character, facing the camera, head and shoulders or half body. A full-body or three-quarter picture is cut to a bust (head to chest) first.
  • Drawn characters (anime, manga, game and illustration styles) give the cleanest layers. Semi-realistic and painted styles work too, and get turned views of the nose, mouth, eyes and cheeks for head turns.
  • Hair and face clearly visible. Bangs over the eyes are fine; sunglasses and masks are kept as drawn and don't move.
  • A plain background helps; the background is cut away either way.

What the package holds#

  • Layers cut from your picture, in drawing order, with the parts behind them painted in. At rest the character looks the same as your picture.
  • Motion: head turns and nods with depth, a body that follows and breathes, a soft chest spring, hair split into strands that swing, ribbons, earrings and pendants that swing.
  • Eyes and mouth: closed eyes, four mouth shapes for lip sync, and five expressions (smile, shy, angry, sad, surprised), all drawn in the style of your picture.
  • Extensions: turned views, the chest spring and a fade at the bottom of the bust are optional fields (x-views, x-bust, x-fade). Our player build plays them; the stock LivLiv Player ignores them and plays the rest of the character.

The package's meta.license is yours: you own what you make from your picture. It carries no watermark.

Play it in your page#

The playground uses our build of LivLiv Player, with talking (lip sync from any audio, such as text to speech) and moving to music (a head bob, sway and bounce on the beat of a song or a tempo). The stock player plays the same file without the extensions:

JavaScript
import { Player } from '@livliv/player'

const player = new Player(document.querySelector('canvas'))
await player.load('/characters/mara.livliv')
player.setExpression('smile')

Follow a face#

In the playground and with the player's face tracking in your own page, the character can follow a face from the camera. The face is tracked in the browser with MediaPipe Face Landmarker: the camera picture stays on the device and nothing is uploaded.

Terms#

Every rig request sets consent: true: you accept the character rig terms, including the use restrictions of the model's licence, and confirm that you may use the picture and that anyone recognisable in it is 18 or older and agreed. Character rigs are made with See-through (single-image layer decomposition for anime characters, SIGGRAPH 2026; Apache-2.0 code, Open RAIL++-M weights) and played with LivLiv Player (Apache-2.0); the beat-synced motion builds on Project AIRI (MIT).