telnyx-ai-inference-curl

Telnyx AI Inference - curl 是一份面向开发者的 REST API 示例集合，用于通过 curl 调用 Telnyx 的 LLM 推理、嵌入与 AI 分析接口。

用途该技能提供 Telnyx AI 相关 REST API 的 curl 调用示例，覆盖语音转文字、聊天补全、对话管理、洞察模板与分组、嵌入任务与相似度搜索、URL 内容嵌入等能力，可用于通话洞察与摘要等场景。

主要能力

语音转文字：POST /ai/audio/transcriptions，与 OpenAI Transcription API 一致，可使用 OpenAI JS 或 Python SDK。返回 duration、segments、text、words。
聊天补全：POST /ai/chat/completions（已弃用，建议改用 POST /v2/ai/openai/chat/completions），与 OpenAI Chat Completions API 一致，支持 messages 及多种可选参数（如 model、temperature、tools、stream 等）。
对话管理：列出、创建、获取、更新元数据、删除对话；向对话添加消息；获取对话消息（含工具调用）。
洞察模板与分组：获取/创建/更新/删除洞察模板与洞察分组，支持将洞察分配或取消分配到分组。
洞察聚合：GET /ai/conversations/conversation-insights/aggregates 按指定字段聚合对话洞察。
嵌入：对 Telnyx Storage Bucket 中的文档执行嵌入，支持 PDF、HTML、txt、json、csv 及音视频（mp3、mp4、mpeg、mpga、m4a、wav、webm，最大 100MB）；列出已嵌入的 bucket；查看文件级嵌入状态；禁用某个 bucket 的 AI 嵌入；相似度搜索（当前仅余弦相似度，距离 0-1，越小越相似）；嵌入 URL 内容（同域下最多 5 层子页面）；查询嵌入任务状态（queued、processing、success、failure、partial_success）。

使用方式

安装：curl 在 macOS、Linux 和 Windows 10+ 上预装。
认证：export TELNYX_API_KEY="YOUR_API_KEY_HERE"，所有示例使用该环境变量进行 Bearer 认证。
错误处理：API 调用可能因网络错误、限流（429）、校验错误（422）或认证错误（401）失败。示例展示了通过 -w "\n%{http_code}" 获取 HTTP 状态码并分支处理：2* 成功、422 校验错误、429 限流（延迟重试）、401 认证失败。常见错误码：401 无效 API key、403 权限不足、404 资源未找到、422 校验错误、429 限流（建议指数退避重试）。
分页：列表端点返回分页结果，使用 page[number] 和 page[size] 查询参数翻页，检查响应中的 meta.total_pages。

适用场景适合需要在生产代码中集成 Telnyx AI 能力的开发者，用于通话洞察与摘要、语音转写、对话式应用、文档嵌入与相似度检索、网站内容嵌入等。

限制

技能介绍