Bring-your-own intelligence API

Liforma Relay API

Use Relay when your application owns the intelligence layer. Liforma transcribes the user, sends you text, then renders your chosen reply as speech and animation.

$0.03 per speech minute API preview

Endpoint

POST /v1/relay/sessions

Processing Flow

  1. Speech-to-text
  2. Your intelligence layer
  3. Text-to-speech
  4. Animation

Request

{
  "avatar": "milo",
  "webhook_url": "https://your.app/liforma/reply",
  "events": ["transcript.final", "avatar.finished"]
}

Response

{
  "session_id": "relay_31af",
  "websocket_url": "wss://api.liforma.ai/v1/relay/relay_31af",
  "reply_contract": "text_in"
}

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.