Text-to-avatar animation API
Liforma Motion API
Use Motion when you already know what the avatar should say. Send text and receive generated speech, facial animation, and optional exported video.
Endpoint
POST /v1/motion/rendersProcessing Flow
- Text-to-speech
- Animation
- Optional video export
Request
{
"avatar": "nova",
"voice": "bright-guide",
"text": "Welcome back. Your lesson is ready.",
"export": { "format": "mp4" }
}Response
{
"render_id": "motion_b9e1",
"audio_url": "https://cdn.liforma.ai/audio/motion_b9e1.wav",
"animation_url": "https://cdn.liforma.ai/animation/motion_b9e1.json",
"video_url": "https://cdn.liforma.ai/video/motion_b9e1.mp4"
}Billing Notes
Liforma bills by generated speech and animation time, not by wall-clock session time. If the avatar is silent, you are not paying for speech minutes.