用途:通过 Telnyx Python SDK 创建和管理实时视频通信与会议房间,覆盖房间、会话、参与者、录制和合成等资源。
主要能力:房间的创建、查询、更新、删除;生成与刷新加入房间的 Client Token;查看房间会话列表与详情,结束会话、踢出、静音、取消静音参与者;查看参与者与录制列表、删除单个或批量录制;创建、查询、删除房间合成(room composition),并支持 webhook 回调地址与超时配置。
使用方式:先安装依赖 pip install telnyx,然后初始化客户端:client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。之后调用 client.rooms、client.rooms.sessions、client.room_participants、client.room_recordings、client.room_compositions 等资源方法。例如创建房间 client.rooms.create(unique_name="my-meeting-room", max_participants=10),生成加入令牌 client.rooms.actions.generate_join_client_token(room_id=...)。
错误处理:API 调用可能返回网络错误、429 限流、422 校验错误或 401 认证错误,建议捕获 telnyx.APIConnectionError、telnyx.RateLimitError、telnyx.APIStatusError,并对 429 使用指数退避重试。
适用场景:需要在 Python 应用中集成实时视频会议、房间管理、录制与合成能力的开发者。
限制:资料未提供定价、平台兼容性、并发上限或具体性能指标;部分字段与参数为可选,实际可用性以 Telnyx 官方文档为准。