用途:通过 Telnyx 官方 Python SDK(telnyx)调用其 AI 推理 API,覆盖大语言模型对话、语音转写、文本嵌入与对话洞察分析等能力。
安装与初始化:pip install telnyx;随后从 telnyx 导入 Telnyx 并用 TELNYX_API_KEY 环境变量初始化 client。
主要能力:语音转文字(POST /ai/audio/transcriptions,兼容 OpenAI Transcription API);聊天补全(POST /ai/chat/completions,已废弃,建议改用 /v2/ai/openai/chat/completions,支持 messages、tools、guided_json、stream 等参数);对话管理(列出、创建、获取、更新元数据、删除对话,添加与读取消息);对话洞察(聚合 insights、洞察分组与模板的增删改查,以及洞察与分组的分配与取消分配,支持 webhook);嵌入(对 Telnyx Storage 存储桶内 PDF、HTML、文本、JSON、CSV 及音视频文件生成嵌入,支持 URL 内容抓取嵌入、相似度搜索、任务状态查询,以及为存储桶禁用 AI 嵌入)。
用法要点:client 初始化后即可调用上述方法;列表方法返回自动分页迭代器,可用 for item in page_result 遍历所有页。
限制与错误处理:需妥善处理 401、403、404、422、429 等错误,遇 429 可按 Retry-After 退避重试。
注:微调相关接口的文档在此处被截断,具体用法暂未提供。