Session API

Send requests from your server to https://api.livefaces.ai with:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Use the canonical API origin directly; older .lagena.ai application URLs redirect.

Choose a starting point

Experience	Request	Required scope
Voice with optional face, prompt, and tools	`POST /v1/sessions`	`sessions:create`
Published workflow with initial inputs	`POST /v1/workflow-runs`	`workflows:run`
Read either session / refresh its token	`GET /v1/sessions/{session_id}`	`sessions:read`
End either session	`DELETE /v1/sessions/{session_id}`	`sessions:delete`
Read its saved transcript	`GET /v1/sessions/{session_id}/transcript`	`sessions:read`
Check the API key’s organization and scopes	`GET /v1/auth/api-key`	Valid API key

Use catalog and published-revision UUIDs provisioned for your organization. Display names and workflow version numbers cannot replace these IDs.

Connection flow

The response contains id, livekit_url, and participant_token. Use the URL and token with a LiveKit client to join the session. A session created without a face has no digital-human video. Keep the API key on your server. Return connection details only to the participant authorized to join; participant tokens are credentials too. Session creation depends on the services enabled for your organization. A 503 means creation is currently unavailable; see errors and retries. Begin with API keys, then create a voice session or start a workflow.

Get started

Console

Workflows

API reference

Help

Session API

Choose a starting point

Connection flow

​Choose a starting point

​Connection flow

Choose a starting point

Connection flow