telnyx-ai-inference-java

用途：该技能面向 Java 开发者，提供使用 Telnyx AI Inference 接口的 SDK 示例，覆盖 LLM 对话补全、语音转写、向量嵌入，以及通话相关的会话与洞察分析能力。

主要能力：

1. 语音转文字：调用 POST /ai/audio/transcriptions，与 OpenAI Transcription API 保持一致。
2. 对话补全：POST /ai/chat/completions，必填 messages，可选 model、temperature、max_tokens、tools、response_format、stream 等参数，与 OpenAI Chat Completions API 一致。
3. 会话管理：对 /ai/conversations 进行列表、创建、查询、更新元数据、删除，并可手动新增消息、获取消息列表。
4. 洞察模板与分组：对 /ai/conversations/insights 与 /ai/conversations/insight-groups 进行增删改查，并可分配或取消分配洞察到分组。
5. 嵌入：POST /ai/embeddings 对 Telnyx Storage Bucket 中的文档执行嵌入，支持 PDF、HTML、txt、json、csv 及音视频（单文件最大 100mb）。

使用方式：通过 Maven 或 Gradle 引入 com.telnyx.sdk:telnyx:6.36.0。使用 TelnyxOkHttpClient.fromEnv() 初始化客户端后调用各模块方法。示例涵盖 chat、audio、conversations、insightGroups、insights、embeddings 等。列表接口可用 autoPager() 自动翻页，或用 hasNextPage() 与 nextPage() 手动控制。

限制与注意：所有调用都可能出现网络错误、限流（429）、校验错误（422）或认证错误（401），生产代码需捕获 TelnyxServiceException 并通过 statusCode() 判断，429 建议指数退避重试。嵌入支持的文件类型与大小限制如上；超出类型的文件将按非结构化文本尝试嵌入。价格、计费方式及可用模型清单在资料中暂未提供。