用途：面向 Telnyx 账户的用量报表生成与查询，服务于计费、分析和账务对账场景，以 Python SDK 形式提供调用示例。
安装与初始化：使用 pip install telnyx 安装；通过 from telnyx import Telnyx 创建客户端，密钥取自环境变量 TELNYX_API_KEY，示例中默认省略 api_key 参数。后续示例均假设 client 已按此方式初始化。
主要能力：一是话单事件查询，GET /call_events，支持按过滤参数筛选，事件按 occurred_at 排序；未提供 leg_id 或 application_session_id 过滤时仅返回最近 24 小时事件。二是账本计费组报表，POST /ledger_billing_group_reports 创建（可选 month、year），GET /ledger_billing_group_reports/{id} 查询，返回状态含 pending、complete、failed、deleted 及 report_url。三是 MDR 消息明细报表，包含列表、创建（必填 start_time、end_time）、按 ID 查询与删除。四是 CDR 语音明细报表，同样支持列表、创建、按 ID 查询、删除，并可 GET .../voice/fields 获取可用字段，返回分为 Billing、Interaction Data、Number Information、Telephony Data。五是 MDR 与 CDR 用量报表，支持列表、创建、按 ID 查询和删除。六是号码查询用量报表与 CSV 下载，CSV 下载支持列表、创建、按 ID 查询，状态含 pending、complete、failed、expired。
使用方式：列表方法返回自动分页迭代器，可用 for item in page_result 遍历全部页面；调用时按各端点传入必填与可选过滤器。
错误处理：API 调用可能出现网络错误、限流 429、校验错误 422、认证错误 401；生产代码应捕获 telnyx.APIConnectionError、telnyx.RateLimitError、telnyx.APIStatusError。常见状态码：401 密钥无效，403 权限不足，404 资源不存在，422 字段格式校验失败，429 限流建议指数退避重试，可参考 Retry-After 头。
限制：资料未提供具体收费、价格、配额或平台支持信息；报表以异步请求形式生成，需轮询状态并获取 report_url。