Elai

Purpose

Build AI avatar presenter videos with Elai: list available avatars, inspect videos and their render status, submit renders, and poll until a render finishes. Reach for this when the user wants a talking-head video generated from a script or slide deck.

Tooling

All commands go through bin/elai.py.

bin/elai.py auth
# {"ok": true, "avatars": 40} on success

bin/elai.py avatars
# list available avatars (code, name, gender)

bin/elai.py videos
# list your videos (id, name, status)

bin/elai.py video-get --id <VIDEO_ID>
# one video: name, status; rendered video URL when ready

bin/elai.py render --id <VIDEO_ID>
# submit a render for a drafted video; consumes render credits (confirmation-gated)

bin/elai.py render-status --id <VIDEO_ID>
# poll render status; prints status and the video URL when the render completes

Notes:

• Rendering is asynchronous: render submits the job, then poll render-status until status leaves rendering. Download the resulting video promptly; do not treat the URL as a permanent artifact.
• Custom-avatar footage submission (the PATCH-based workflow) and WebRTC real-time streaming are outside CLI scope.

Auth

• Provider id: elai (credential is collected as custom.elai)
• Collection: Elai API token via the secure credential flow (credentials.request_api_access); only the account primary (admin) user can generate one, under Settings, then API Keys
• Allowed hosts: apis.elai.io
• Connect placement: bearer_header (the token goes in Authorization: Bearer <token>)
• Status check: bin/elai.py auth