telnyx-ai-inference-go

用途

telnyx-ai-inference-go 是一套面向 Go 开发者的技能示例，用于访问 Telnyx 的 LLM 推理 API、嵌入（embeddings）能力，以及用于通话洞察和摘要的 AI 分析功能。所有示例基于 Telnyx Go SDK，展示如何初始化客户端并调用各类 AI 接口。

安装与初始化

安装命令：

go get github.com/team-telnyx/telnyx-go

初始化客户端：

import (
  "context"
  "fmt"
  "os"

  "github.com/team-telnyx/telnyx-go"
  "github.com/team-telnyx/telnyx-go/option"
)

client := telnyx.NewClient(
  option.WithAPIKey(os.Getenv("TELNYX_API_KEY")),
)

以下所有示例都假定 client 已按上述方式初始化。

错误处理

API 调用可能因网络错误、速率限制（429）、校验错误（422）或认证错误（401）失败，生产代码中应始终处理错误。常见错误码包括：401 无效 API 密钥、403 权限不足、404 资源不存在、422 校验错误（检查字段格式）、429 速率限制（建议指数退避重试）。分页可使用 ListAutoPaging() 进行自动迭代。

主要能力

语音转文本：POST /ai/audio/transcriptions，与 OpenAI Transcription API 一致，返回 duration、segments、text。
聊天补全：POST /ai/chat/completions，与 OpenAI Chat Completions API 一致，必填 messages，可选参数包括 model、temperature、max_tokens、stream、tools、response_format 等。
会话管理：支持列出、创建、获取、更新元数据、删除会话，以及向会话手动插入消息（POST /ai/conversations/{conversation_id}/message）和获取会话消息（含工具调用）。
洞察模板与分组：支持洞察模板的增删改查，以及洞察分组的管理和洞察与分组的指派/取消指派。
嵌入与检索：对 Telnyx 存储桶中的文档执行嵌入（支持 PDF、HTML、txt、json、csv、音视频等，音视频最大 100MB），列出已嵌入的存储桶、查看文件级嵌入状态、禁用某存储桶的 AI 嵌入，以及基于余弦相似度的相似度搜索（POST /ai/embeddings/similarity-search，必填 bucket_name 与 query）。
URL 内容嵌入：从指定 URL 抓取网页内容并嵌入，可包含同域下最多 5 层子页面。

使用方式

通过 Go SDK 调用上述 REST 端点，每个能力均提供对应的 Go 示例代码，涵盖请求参数与返回字段。开发者可将示例直接用于自己的 Go 项目。

适用场景

适合需要在 Go 服务中集成 AI 对话、语音转写、文档语义检索、通话洞察与摘要分析的开发者。

限制

资料未提供收费、价格、配额、速率上限及完整平台支持等信息，暂未提供。