elai

1# Elai
2 
3## Purpose
4Build 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.
5 
6## Tooling
7All commands go through `bin/elai.py`.
8 
9```bash
10bin/elai.py auth
11# {"ok": true, "avatars": 40} on success
12 
13bin/elai.py avatars
14# list available avatars (code, name, gender)
15 
16bin/elai.py videos
17# list your videos (id, name, status)
18 
19bin/elai.py video-get --id <VIDEO_ID>
20# one video: name, status; rendered video URL when ready
21 
22bin/elai.py render --id <VIDEO_ID>
23# submit a render for a drafted video; consumes render credits (confirmation-gated)
24 
25bin/elai.py render-status --id <VIDEO_ID>
26# poll render status; prints status and the video URL when the render completes
27```
28 
29Notes:
30- 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.
31- Custom-avatar footage submission (the PATCH-based workflow) and WebRTC real-time streaming are outside CLI scope.
32 
33## Auth
34- Provider id: `elai` (credential is collected as `custom.elai`)
35- 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
36- Allowed hosts: `apis.elai.io`
37…