Get started
Quickstart
Create an API key, pick a persona and start your first face-to-face conversation in about five minutes.
1. Create an API key
Sign in to the dashboard and open API keys. Keys start with mos_live_ and are shown once. Store yours in an environment variable.
bash
export MANAVOS_API_KEY=mos_live_…2. Start a conversation
Every account includes six stock personas. Create a conversation with one of them; the response includes a join URL.
bash
curl -X POST https://app.manavos.ai/api/v1/conversations \
-H "Authorization: Bearer $MANAVOS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "persona_id": "aarohi" }'json
{
"id": "conv_8f21",
"persona_id": "aarohi",
"status": "active",
"join_url": "https://app.manavos.ai/app/live/?id=conv_8f21",
"mode": "video"
}3. Join or embed
Open join_url in a browser, or embed it in an iframe with camera and microphone permissions. When the call ends, the transcript arrives via webhook.
html
<iframe src="{join_url}" allow="camera; microphone; fullscreen; display-capture"></iframe>