这是 Telnyx AI Assistants 的 Python 客户端用法整理，面向用代码管理 AI 语音助手的开发场景。安装命令为 pip install telnyx；初始化通过 import os、from telnyx import Telnyx，并用 api_key=os.environ.get("TELNYX_API_KEY") 创建 client。
用途与主要能力：核心入口是 client.ai.assistants.create()（POST /ai/assistants），必填 name 与 instructions，可选 tags、model 等；创建后可 client.ai.assistants.chat()（POST /ai/assistants/{assistant_id}/chat）发送消息，必填 content、conversation_id、assistant_id，读取 response.content。还支持 retrieve、update、list、delete、clone、instructions.enhance、imports（provider 可选 elevenlabs、vapi、retell）、tags、tools、canary_deploys、scheduled_events、send_sms，以及 tests 与 test_suites 的创建、触发、运行历史查询。
用法与错误处理：所有 API 可能返回网络错误、429 限流、422 校验错误或 401 认证错误，示例以 try/except 捕获 telnyx.APIConnectionError、telnyx.RateLimitError、telnyx.APIStatusError 并判断状态码。电话号码必须为 E.164 格式（如 +13125550001）。列表方法返回自动分页迭代器。模型可用性因账户而异，遇 422 时可调用 client.ai.assistants.list() 发现可用模型，常见有 openai/gpt-4o、Qwen/Qwen3-235B-A22B。
限制：资料未提供具体收费与价格信息；不得臆造参数、枚举、响应字段或 webhook 字段，需要未列出的字段应查阅 references/api-details.md。