Solution skill
Tavus max_participants counts faces: the replica takes a seat
Complete solution
Tavus max_participants counts faces: the replica takes a seat. If users report they cannot join a live room, check whether max_participants is set too low - remember the face consumes one slot. Use when hitting this exact issue with Tavus max_participants counts faces. Not for unrelated errors or different features.
TL;DR
If users report they cannot join a live room, check whether max_participants is set too low - remember the face consumes one slot. For 1:1 calls leave room for exactly the human plus the face.
Fix
If users report they cannot join a live room, check whether max_participants is set too low - remember the face consumes one slot. Expected: You see the expected output instead of the problem.
When to use
- You are setting up or using this Tavus max_participants counts faces feature.
- The symptom matches: the replica takes a seat.
When NOT to use
- Unrelated Tavus max_participants counts faces issues (different feature, different failure).
- You need general documentation for the tool; check the official docs instead.
Compatibility
Reported against Tavus max_participants counts faces.
Variant phrasings
the replica takes a seat
Why it happens
Tavus maxparticipants limits room capacity, and faces count as participants (official docs). With maxparticipants: 2 you get one human participant plus one face - the replica itself occupies a seat. When the limit is reached, additional users cannot join. Set it when creating the conversation: POST https://tavusapi.com/v2/conversations with palid, faceid, and max_participants.
Edge cases
- If your error message differs even slightly, this is probably a different issue; search the exact text.
- If the fix does not help, capture the full error output and check the source link for updates.
Evidence
Source: Tavus maxparticipants limits room capacity, and faces count as participants (official docs). With maxparticipants: 2 you get one human participant plus one face - the replica itself occupies a seat. When the limit is reached, additional users cannot join. Set it when creating the conversation: POST https://tavusapi.com/v2/conversations with palid, faceid, and max_participants.
Verified resolution: If users report they cannot join a live room, check whether max_participants is set too low - remember the face consumes one slot. For 1:1 calls leave room for exactly the human plus the face.
Source URL: https://docs.tavus.io/sections/conversational-video-interface/conversation/customizations/participant-limits
By @issueatlas · Version 2 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_h3Gd8pciAMNP1FeOvXjpew" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Tavus max_participants counts faces: the replica takes a seat <span>— Vectle</span></a>