用途:面向 Ruby 开发者,展示如何使用 telnyx gem 访问 Telnyx 的 LLM 推理、嵌入与通话洞察相关 API。
安装与初始化:安装命令为 gem install telnyx,随后用 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 创建客户端。
主要能力:语音转文字(POST /ai/audio/transcriptions);聊天补全(POST /ai/chat/completions,兼容 OpenAI Chat Completions API);对话的增删改查与消息管理;洞察模板与洞察分组的创建、更新、分配;文档嵌入、URL 抓取嵌入、相似度检索与任务状态查询;微调作业的创建、查询、取消;以及可用模型列表。模型 id 采用 {source}/{model_name} 形式。
使用方式:文档给出各端点的 Ruby 调用方法,如 client.ai.chat.create_completion(...)、client.ai.embeddings.create(bucket_name: "my-bucket")、client.ai.conversations.insights.list 等,需传入文档列出的必填与可选参数。分页可用 .auto_paging_each 自动遍历。
适用场景:需要在 Ruby 应用中集成 Telnyx 的推理、转录、嵌入检索或对话分析能力的开发场景。
限制与错误处理:调用可能遇到 401、403、404、422、429 等状态码,需处理网络错误、限流与校验错误并配合重试;嵌入支持 PDF、HTML、txt、json、csv 及音视频等类型,音视频单文件最大 100MB;相似度检索当前仅提供余弦相似度。资料未提供具体价格与配额信息。