用途:通过 Telnyx 的 Python SDK 管理和操作实时视频房间与会议资源,包括房间、房间会话、参与者、录像和房间合成。
安装:pip install telnyx
初始化:使用 from telnyx import Telnyx 创建客户端,api_key 可通过环境变量 TELNYX_API_KEY 传入,也可省略。
主要能力:
- 房间:创建、查看、更新、删除房间;可设置 enable_recording、max_participants、unique_name 及 Webhook 相关参数。
- 加入令牌:生成和刷新加入房间所需的 Client Token,可设置 token_ttl_secs、refresh_token_ttl_secs,返回令牌及过期时间。
- 会话:列出和查看房间会话;结束会话(会踢出当前所有参与者)、踢出、静音、取消静音参与者。
- 参与者:列出并查看房间参与者。
- 录像:列出、查看、删除单条或批量删除房间录像。
- 房间合成:列出、异步创建、查看、删除房间合成,支持 format、resolution、video_layout、Webhook 参数。
错误处理:需处理网络错误、速率限制 429、验证错误 422 与认证错误 401 等。常见状态码包括 401、403、404、422、429,可参考 SDK 中的异常类型进行重试与提示。
限制:资料未提供计费、价格、区域可用性及具体使用步骤之外的说明。