Skip to main content

​
General

If you see an error about file size, it means your training video or audio file is larger than the 750 MB limit.Tavus supports training videos and audio files up to 750 MB. This limit helps maintain a balance between quality and processing speed.
Tavus requires the H.264 codec for all uploads.
To reduce file size:
  • Compress the file using video compression tools.
  • Lower the resolution — 1080p is usually enough.
  • Trim any extra content to shorten the video.
  • Reduce the frame rate to around 30 fps.

​
Conversational Video Interface (CVI)

If the replica starts responding to background sounds, such as people talking nearby, it may be due to the absence of noise filtering.To resolve this, enable noise cancellation using Daily’s updateInputSettings() method. For example:
callFrame.updateInputSettings({
  audio: {
    processor: {
      type: 'noise-cancellation',
    },
  },
});
Learn more in the Daily SDK documentation.
This is a rare issue caused by an internal server problem. When it happens, our team is automatically notified and works to resolve it as quickly as possible.You can check the system status at status.tavus.io. We recommend checking periodically for updates if you encounter this error.

​
Relationship with STT Layer

The Conversational Flow layer is the recommended approach for configuring turn-taking behavior with Sparrow-1. This supersedes the legacy Sparrow-0 configuration available in the STT layer via smart_turn_detection.
Legacy Approach: Configuring turn-taking via the STT layer’s smart_turn_detection parameter is a legacy approach that uses Sparrow-0. For new implementations, use the Conversational Flow layer with Sparrow-1 instead.
When you configure the Conversational Flow layer with turn_detection_model set to sparrow-1, these settings override any corresponding settings in the STT layer.

​
Parameter Mapping: Sparrow-0 to Sparrow-1

Here’s how Sparrow-0 (STT layer) parameters map to Sparrow-1 (Conversational Flow layer):
Sparrow-0 (STT Layer)Sparrow-1 (Conversational Flow Layer)Notes
participant_pause_sensitivityturn_taking_patienceControls how long to wait before responding
participant_interrupt_sensitivityreplica_interruptibilityControls how easily the replica can be interrupted
Important: When using Sparrow-1 via the Conversational Flow layer, any conflicting settings in the STT layer (Sparrow-0) will be overridden. For example, if you set participant_pause_sensitivity: "high" in the STT layer but turn_taking_patience: "low" in the Conversational Flow layer with turn_detection_model: "sparrow-1", the Conversational Flow setting (low) will take precedence.

​
Migration Guide

If you’re currently using Sparrow-0 settings in the STT layer and want to upgrade to Sparrow-1:Before (Sparrow-0):
{
  "layers": {
    "stt": {
      "participant_pause_sensitivity": "high",
      "participant_interrupt_sensitivity": "low"
    }
  }
}
After (Sparrow-1):
{
  "layers": {
    "conversational_flow": {
      "turn_detection_model": "sparrow-1",
      "turn_taking_patience": "low",
      "replica_interruptibility": "high"
    }
  }
}
Note the inverted mapping:
  • participant_pause_sensitivity: "high" (quick response) → turn_taking_patience: "low" (eager)
  • participant_interrupt_sensitivity: "low" (hard to interrupt) → replica_interruptibility: "high" (easy to interrupt)
The naming has been updated in Sparrow-1 to be more intuitive from the replica’s perspective.

​
Replica

This error usually means your training video is missing the required consent statement or the statement wasn’t clearly spoken.To generate a digital replica using the Phoenix model, your video must include this line at the beginning, spoken clearly:
“I, [FULL NAME], am currently speaking and give consent to Tavus to create an AI clone of me by using the audio and video samples I provide. I understand that this AI clone can be used to create videos that look and sound like me.”
Make sure to replace [FULL NAME] with your actual name. The consent must be easy to hear and can be spoken in any supported language. You can view the list of supported languages here.If your video didn’t include this, re-record it with the consent statement at the beginning, then submit a new request through the Developer Portal or API.
If your replica’s lip movements are noticeably out of sync, it may be due to issues with the training video format. Even if the video appears clean, AI-generated content or videos that don’t follow the expected structure can affect training quality.Common causes:
  • The video does not follow the required recording format, which includes:
    • 1 minute of talking
    • 1 minute of silence
  • Lips do not fully close during the talking segment, which limits the model’s ability to learn realistic lip movements.
To improve your replica:
  • Record a new video following the correct structure (one minute of talking followed by one minute of silence).
  • Speak naturally, allowing full lip movement including closures.
  • Avoid using AI-generated videos for training.
For more details, see the Replica Training Guide.

​
Video Generation

If your video looks unnatural or has repeated gestures, it may be due to the script length. Videos over 5 minutes can lead to reduced movement variety and a less natural feel.To improve quality:
  1. Keep videos short – under 5 minutes is ideal.
  2. Break long scripts into smaller, focused segments.
  3. Tighten the script – remove filler and keep pacing steady.
  4. Use multiple replicas for variety in longer content.
  5. Review and revise – check for repetition and adjust as needed.
If the issue persists after following the troubleshooting guide above, please don’t hesitate to contact our support team for further assistance.