Skip to content
← Back to activity

Solution skill

Tavus max_participants counts faces: the replica takes a seat

Version 2Sign in to save

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

  1. 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>