TruGen and Avatario avatar IDs in LiveKit vs a Sume avatar handle
In LiveKit, TruGen and Avatario pick a face with an avatar_id. Sume uses a stable avatar_handle you create yourself. Here is how they differ.
TruGen and Avatario both choose a face in LiveKit with an avatar_id, usually picked from a stock list or dashboard. Sume instead gives you a avatar_handle that you name when you create the avatar, so your code can say product_host and get the same face every time. Use a handle when brand consistency matters more than catalog breadth.
How the two LiveKit plugins pick a face
TruGen's page lists avatar_id as an optional parameter for a stock avatar model, plus avatar_participant_identity (default "trugen-avatar") and avatar_participant_name. It installs with uv add "livekit-agents[trugen]~=1.8" or, for Node.js, pnpm add @livekit/agents-plugin-trugen, and reads TRUGEN_API_KEY.
Avatario's page needs AVATARIO_API_KEY and AVATARIO_AVATAR_ID, which you choose in the Avatario dashboard. Its pattern is to start the avatar session before the agent session. It is a Python plugin installed with uv add "livekit-agents[avatario]~=1.8".
How Sume names a face
POST /v1/avatar-1.0/generate takes a top-level avatar_handle and an input union: a prompt, structured props (ethnicity, sex, age) or a photo with a public HTTPS image_url. Sume normalizes the handle and stores it without a leading @. When the creation job completes, the avatar is a reusable resource in your workspace.
Then every talking video names that handle, so the face is a stable key in your own code rather than an opaque vendor ID.
| Item | TruGen | Avatario | Sume Avatar 1.0 |
|---|---|---|---|
| Face selector | avatar_id (optional stock avatar) | AVATARIO_AVATAR_ID or avatar_id | avatar_handle you name |
| Where you choose | Stock list | Avatario dashboard | Your own create call |
| Custom face | Not stated on the page | Not stated on the page | Prompt, profile or photo input |
| Languages | Python and Node.js | Python | Any HTTP client |
| Output | Live participant | Live participant | MP4 job result |
When a handle is the better key
A stock avatar ID is quick for a prototype. A handle you create is better when the presenter is part of your brand, because a teammate or an agent can reuse it without looking up a catalogue. Creating an avatar costs $0.95 once, and each later video only pays for its own seconds.
If your face has to appear in a live call, stay with the LiveKit plugin. If it has to appear in a dozen scheduled videos, create the handle once, as one avatar across twelve videos shows.
Sources
Related posts
More in Integrations
- Truth Social 15-minute video limit and Sume's 900-second trim cap
Truth Social accepts videos up to 15 minutes and 450 MB. Sume video trim outputs top out at 900 seconds, so one trim job fits. How to cut a longer source.
- Truth Social 450 MB video limit: average bitrate for 15 minutes
A 450 MB cap over a 900-second clip leaves about 4 Mbps for video plus audio. Worked ceilings for 5, 10 and 15 minutes, and a Python check before upload.
- Typeform webhook auto-disabled: answer 2xx before calling Sume
Typeform disables a webhook that fails every try, and a 404 or 410 stops it at once. Answer 2xx first, then start the Sume job from a queue.
- Upload a local file to Sume from chat: hosted MCP can't read disk
Hosted Sume MCP cannot read your laptop files. The flow is assets_upload_url, a client PUT of the bytes, then assets_complete. What to do in ChatGPT or Claude.
Written by Sume