> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bey.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Troubleshooting
> Known issues and how to resolve them.
Check [status.bey.dev](https://status.bey.dev/) for ongoing incidents and service availability, and see
[API Errors](/concepts/api/errors) for more information on what API error responses and status codes mean.
## Avatars
### Avatar has quality issues
For [custom avatars](/concepts/avatars/custom), quality is highly dependent on the quality of the input video. Please make sure your video recording follows the [recording best practices](/concepts/avatars/custom), and either try again, or [reach out to support](mailto:support@beyondpresence.ai) for assistance.
If you are talking to an avatar through a low-bandwidth connection, like a mobile phone on cellular data, [Simulcast](https://livekit.com/blog/an-introduction-to-webrtc-simulcast) might be downscaling the video to reduce your data usage. In this case, try again with a stable internet connection and check whether the issue persists.
If you notice quality issues with a [stock avatar](/concepts/avatars/stock), please [report the issue to support](mailto:support@beyondpresence.ai).
### Avatar has lip synchronization issues (video and audio are not in sync)
Avatar lip synchronization is dependent on how well the audio used to create the avatar matches the audio produced by your TTS model at inference.
For [custom avatars](/concepts/avatars/custom), you should make sure that your video recording has good, audible audio, and that the recording language is similar to your later conversation target language.
For [stock avatars](/concepts/avatars/stock), degraded lip synchronization might occur for target languages that are phonetically very different from English. If you notice issues with a specific language, try [creating a custom avatar](/concepts/avatars/custom) trained on a video recording that matches your target language, or [reach out to support](mailto:support@beyondpresence.ai) for help.
### Custom avatar creation is failing
Avatar creation errors are often just the account hitting its custom avatar slot limit, not a technical failure. If so, please upgrade your plan or reach out to your customer success manager to discuss higher slot quotas. See also [Concurrency & Quotas](/production/concurrency) for more information on usage quotas per subscription tier.
If you are creating avatars via the API, make sure to check the API error code and error message in your logs, and see the [API Errors page](/concepts/api/errors) for possible causes.
## Speech-to-Video API
### Avatar is not showing up
There can be several reasons why avatars may not show up in your session:
* **Implementation issue:** Your implementation does not invoke the Beyond Presence API correctly. If you are using LiveKit Agents, make sure that your implementation matches the [official usage instructions](https://docs.livekit.io/agents/models/avatar/plugins/bey/#usage) (same for other frameworks).
* **Account issue:** Your account has run out of credits, has reached the session limit, or does not have access to the requested avatar.
* **Avatar issue:** The requested avatar does not exist, or you do not have access to it, or it was created with an outdated model that is no longer supported and needs to be retrained.
* **System downtime:** Beyond Presence aims for consistent 99.95%+ uptime across all services, but system downtimes may still occur. Check the [Status page](https://status.bey.dev/) to see whether there are any Speech-to-Video downtimes.
To narrow down the issue, make sure to always check your logs for errors, check the API error code and error message for more detail, and see the [API Errors page](/concepts/api/errors) for possible causes.
In case you need further assistance, please [reach out to support](mailto:support@beyondpresence.ai).
### Video resolution is too low
All Beyond Presence avatars support high-definition rendering by default. However, if you are using LiveKit Agents, [Simulcast](https://livekit.com/blog/an-introduction-to-webrtc-simulcast) is applied by default, which downscales resolution for low-bandwidth devices like mobile phones on a cellular connection. Try again with a stable internet connection and check whether the issue persists. In case of persisting issues, please [reach out to support](mailto:support@beyondpresence.ai).
### Session limit exceeded
Beyond Presence enforces a limit on how many sessions you can run at the same time, and this limit differs per plan. See [Quotas](/production/concurrency) for the limit that applies to your plan and how to raise it.
### Multiple avatars cannot join the same room
This is a known limitation. If your use case requires multiple different avatars in the same room, please [reach out to support](mailto:support@beyondpresence.ai).
### Audio stutter at end of turn
This is a known issue with Google Gemini Live API models used through LiveKit Agents, and we are actively working to resolve it. In the meantime, we recommend switching to other LLM providers, such as OpenAI RealTime, or Gemini 3.5 Flash with separate TTS/STT.
## Learn More
Check for ongoing incidents and service availability
Response format and status codes for API errors