liforma docs

Text-to-Avatar

Animate an avatar speaking your text.

What is it?

Send text. Liforma returns a speaking, animated avatar — lip-synced audio and facial animation for known script, without a full conversational loop.

When to use it

  • Scripted avatar announcements or lesson intros
  • Onboarding walkthroughs with a character guide
  • Dynamic text you already have — no user speech input required
  • When you do not need the character to listen, reason, or update state

API

import { Liforma } from '@liforma/client';

const result = await Liforma.textToAvatar({
  avatarId: 'ava_c4e71fe5',
  text: 'Hello! Welcome to the lesson.',
  voiceId: 'en-GB-SoniaNeural'
});

// result.audio — speech audio
// result.visemes — lip-sync timing for your own renderer
// result.stream — optional streaming chunks

When to use Avatar Experiences instead

Use an Avatar Experience when the character should listen, think, respond dynamically, use tools, or maintain session state. Text-to-Avatar is a focused building block; Avatar Experiences are the full intelligent character platform.

Today, animated conversation is delivered through Avatar Experiences. Text-to-Avatar is for developers who only need scripted animation output.