Start an Interactive Session

Initiate a real-time interactive session with your avatar using POST /v1/interactive/start_session.

Request

import requests

api_key = "YOUR_API_KEY"
base_url = "https://api.mirako.ai/v1"
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}

payload = {
    "avatar_id": "YOUR_AVATAR_ID",           # Avatar to interact with
    "voice_profile_id": "PREMADE_OR_CUSTOM_VOICE_ID"
}

response = requests.post(
    f"{base_url}/interactive/start_session",
    headers=headers,
    json=payload
)
response.raise_for_status()
session = response.json().get("data", {})
session_id = session.get("session_id")
print(f"Session started: {session_id}")

Note: The returned session_id is required for sending audio streams and managing the session.

Dive deeper

• Start Session
• List Sessions