Overview
FalSmartTurnAnalyzer provides an easy way to use Smart Turn detection via Fal.ai’s cloud infrastructure. This implementation requires minimal setup - just an API key - and offers scalable inference without having to manage your own servers.
Installation
Requirements
- A Fal.ai account and API key (get one at Fal.ai)
- Internet connectivity for making API calls
Configuration
Constructor Parameters
Optional[str]
default:"None"
Your Fal.ai API key for authentication (required unless using a custom
deployment)
str
default:"https://fal.run/fal-ai/turn-detection/raw"
URL endpoint for the Smart Turn API (defaults to the official Fal deployment)
aiohttp.ClientSession
required
An aiohttp client session for making HTTP requests
Optional[int]
default:"None"
Audio sample rate (will be set by the transport if not provided)
SmartTurnParams
default:"SmartTurnParams()"
Configuration parameters for turn detection. See
SmartTurnParams
for details.
Example
Custom Deployment
You can also deploy the Smart Turn model yourself on Fal.ai and point to your custom deployment:Performance Considerations
- Latency: While Fal provides global infrastructure, there will be network latency compared to local inference
- Reliability: Depends on network connectivity and Fal.ai service availability
- Scalability: Handles scaling automatically based on your usage
Notes
- Fal handles the model hosting, scaling, and infrastructure management
- The session timeout is controlled by the
stop_secsparameter - For high-throughput applications, consider deploying your own inference service