用途 该技能面向需要以 JavaScript 调用 Telnyx AI 推理能力的开发者，提供 Telnyx Node.js SDK 的安装、初始化与各 AI 端点的调用示例，涵盖 LLM 推理、语音转文字、嵌入和会话洞察分析。
安装与初始化 安装命令：npm install telnyx@6.74.2 初始化示例： import Telnyx from 'telnyx'; const client = new Telnyx({ apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted }); 后续示例均假定 client 已按上述方式初始化。
错误处理 所有 API 调用都可能失败，包括网络错误、限流（429）、校验错误（422）和认证错误（401）。文档给出了 try/catch 示例，区分 Telnyx.APIConnectionError、Telnyx.RateLimitError 和 Telnyx.APIError，并说明常见错误码：401 无效 API key、403 权限不足、404 资源不存在、422 校验错误、429 限流（建议指数退避重试）。
分页 列表方法返回自动分页迭代器，可使用 for await (const item of result) { ... } 自动遍历所有页。
语音转文字 POST /ai/audio/transcriptions，示例使用 model: 'distil-whisper/distil-large-v2'。该端点与 OpenAI Transcription API 一致，可与 OpenAI JS 或 Python SDK 配合使用。返回 duration（number）、segments（array[object]）、text（string）、words（array[object]）。
聊天补全 POST /ai/chat/completions，必填 messages，可选参数包括 api_key_ref、best_of、early_stopping、enable_thinking、frequency_penalty、guided_choice、guided_json、guided_regex、length_penalty、logprobs、max_tokens、min_p、model、n、presence_penalty、response_format、seed、stop、stream、temperature、tool_choice、tools、top_logprobs、top_p、use_beam_search 等。该端点与 OpenAI Chat Completions API 一致，可与 OpenAI SDK 配合使用，但文档标注其已弃用，建议改用 POST /v2/ai/openai/chat/completions。
会话管理 支持列出会话（GET /ai/conversations，支持 PostgREST 风格查询参数过滤，可对 metadata 中任意字段过滤）、创建会话（POST /ai/conversations，可选 metadata、name）、获取单个会话、更新会话 metadata、删除会话，以及向会话添加消息（POST /ai/conversations/{conversation_id}/message，必填 role）、获取会话消息（GET /ai/conversations/{conversation_id}/messages）。会话返回字段包括 created_at、id、last_message_at、metadata、name。
洞察模板与分组 提供聚合会话洞察（GET /ai/conversations/conversation-insights/aggregates，返回 record_count）、获取/创建/查询/更新/删除洞察模板分组（insight-groups，必填 name，可选 description、webhook）、将洞察模板分配到分组及取消分配、以及洞察模板的列出、创建（必填 instructions、name）、查询、更新和删除。洞察模板字段包括 insight_type（custom、default）、instructions、json_schema、name、webhook。还可获取指定会话的洞察（GET /ai/conversations/{conversation_id}/conversations-insights，返回 conversation_insights、status，状态枚举为 pending、in_progress、completed、failed）。
嵌入 支持对 Telnyx Storage Bucket 进行嵌入（POST /ai/embeddings，必填 bucket_name，可选 document_chunk_overlap_size、document_chunk_size、embedding_model、loader）。支持文件类型包括 PDF、HTML、txt/非结构化文本、json、csv 以及音视频（mp3、mp4、mpeg、mpga、m4a、wav、webm，最大 100MB）；不符合类型的文件将尝试按非结构化文本嵌入。还可列出嵌入桶、查询某桶内文件级嵌入状态、删除桶的嵌入并禁用 AI（恢复普通存储计费）、相似度搜索（POST /ai/embeddings/similarity-search，必填 bucket_name、query，可选 num_of_docs，目前仅余弦相似度，返回 0 到 1 的距离）以及嵌入 URL 内容（POST /ai/embeddings/url，必填 url、bucket_name，可抓取同域最多 5 层子页面）。嵌入任务状态包括 queued、processing、success、failure、partial_success。
微调 支持列出微调任务（GET /ai/fine_tuning/jobs）和创建微调任务（POST /ai/fine_tuning/jobs，必填 model、training_file，可选 hyperparameters、suffix），示例使用 model: 'openai/gpt-4o' 与 training_file: 'training-data.jsonl'。
适用场景 需要 JavaScript 环境下调用 Telnyx AI 能力进行语音转写、对话补全、会话洞察分析、文档或 URL 嵌入及相似度检索、以及微调任务的开发场景。
限制 资料未提供具体的计费方式、价格、配额、速率上限、支持的模型完整列表、可用区域、SLA 等信息；聊天补全端点已被标注为弃用。以上未提及内容暂未提供，需以官方最新文档为准。