Lovely RouterДокументация
Получить ключ
Models API

Риги персонажей

Одна картинка персонажа превращается в многослойного 2.5D-персонажа с ригом: он поворачивает голову, моргает, говорит с синхронизацией губ, меняет выражение лица и двигается под музыку. Одна цена за персонажа, скачивается пакетом .livliv.

Риг превращает одну картинку персонажа в живого 2.5D-персонажа от головы до груди (бюст): картинка режется на слои (волосы спереди и сзади, лицо, глаза, брови, рот, уши, шея, одежда), скрытые части за каждым слоем дорисовываются, и каждый слой получает нужное ему движение. В итоге персонаж поворачивает голову с объёмом, моргает, следит глазами за курсором, дышит, его волосы и украшения качаются, он говорит с синхронизацией губ, меняет выражение лица, кивает и покачивается под музыку.

Вы получаете файл .livliv — пакет модели LivLiv (ZIP со слоями и model.json). Его можно проиграть в плейграунде «Говорящий персонаж» или на своей странице с открытым LivLiv Player.

Цена#

character-rig стоит $2.99 за персонажа, какой бы ни была картинка. Сумма резервируется на балансе при запуске и списывается, когда риг готов; неудачный риг бесплатен. Изготовление занимает 7–9 минут.

Сделать риг#

Сохраните персонажа через POST /v1/characters, затем запросите риг:

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

image можно не передавать: тогда риг делается из фото персонажа, а без него — из фронтального вида его листа-разворота. Опрашивайте GET /v1/characters/CHARACTER_ID/rig/job, пока status не станет succeeded, затем скачайте пакет из GET /v1/characters/CHARACTER_ID/rig. Чтобы сохранить персонажа и сразу запустить риг одним вызовом, добавьте при создании rig=true (и consent=true). Все поля и статусы — в эндпоинтах персонажей.

Какие картинки подходят лучше#

  • Один персонаж, лицом к камере, голова и плечи или по пояс. Картинка в полный рост или по колено сначала обрезается до бюста (от головы до груди).
  • Рисованные персонажи (аниме, манга, игры, иллюстрации) дают самые чистые слои. Полуреалистичные и живописные стили тоже работают и получают повёрнутые виды носа, рта, глаз и щёк для поворотов головы.
  • Хорошо видны волосы и лицо. Чёлка на глазах не мешает; очки и маски остаются как нарисованы и не двигаются.
  • Простой фон помогает; фон в любом случае вырезается.

Что внутри пакета#

  • Слои, вырезанные из вашей картинки, в порядке отрисовки, со скрытыми частями дорисованными. В покое персонаж выглядит так же, как ваша картинка.
  • Движение: повороты и кивки головы с объёмом, тело, которое следует за головой и дышит, мягкая упругость груди, волосы, разделённые на пряди, ленты, серьги и кулоны, которые качаются.
  • Глаза и рот: закрытые глаза, четыре формы рта для синхронизации губ и пять выражений (улыбка, смущение, злость, грусть, удивление), всё в стиле вашей картинки.
  • Расширения: повёрнутые виды, упругость груди и затухание низа бюста — необязательные поля (x-views, x-bust, x-fade). Наша сборка плеера их проигрывает; стандартный LivLiv Player их пропускает и проигрывает остальное.

meta.license пакета — ваш: то, что вы сделали из своей картинки, принадлежит вам. Водяного знака нет.

Проиграть на своей странице#

Плейграунд использует нашу сборку LivLiv Player с речью (синхронизация губ с любым аудио, например с синтезом речи) и движением под музыку (кивки, покачивание и пружинистость в такт песне или темпу). Стандартный плеер проигрывает тот же файл без расширений:

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

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

Следовать за лицом#

В плейграунде и с отслеживанием лица плеера на вашей странице персонаж может повторять за лицом в камере. Лицо отслеживается в браузере с помощью MediaPipe Face Landmarker: изображение с камеры остаётся на устройстве, ничего не загружается.

Условия#

Каждый запрос рига задаёт consent: true: вы принимаете условия рига персонажей, включая ограничения использования лицензии модели, и подтверждаете, что вправе использовать картинку и что все узнаваемые на ней люди старше 18 лет и дали согласие. Риги делаются с See-through (разложение одного изображения аниме-персонажа на слои, SIGGRAPH 2026; код Apache-2.0, веса Open RAIL++-M) и проигрываются в LivLiv Player (Apache-2.0); движения в такт основаны на Project AIRI (MIT).