SuperAPI AI 工具集

telnyx-voice-streaming-javascript

通用与其它

查看项目

更新于 10-16 03:48

技能介绍

用途:该技能面向 JavaScript 开发者,提供 Telnyx 通话媒体的实时处理能力,包括媒体串流、通话分叉与实时转写,适用于实时音频分析与 AI 集成场景。

安装与初始化:执行 npm install telnyx@6.74.2,然后通过 import Telnyx from 'telnyx' 创建客户端,使用 TELNYX_API_KEY 作为 API 密钥。

主要能力与用法:

  1. 通话分叉,将通话媒体实时串流到指定目标,需指定 target 或 rx、tx 属性;通过 client.calls.actions.startForking(callControlId) 启动,stopForking 停止。
  2. 媒体串流,将通话媒体以 base64 编码 RTP 负载、包裹在 JSON 中近实时发送到 WebSocket 地址或 Dialogflow;通过 startStreaming 启动,stopStreaming 停止,可配置编解码、采样率、轨道等参数。
  3. 实时转写,通过 startTranscription 启动,支持多种转写引擎(Google、Telnyx、Deepgram、Azure、xAI、AssemblyAI、Speechmatics、Soniox、Parakeet 等),通话挂断或调用 stopTranscription 时停止。

Webhook:事件包括 callForkStarted、callForkStopped、callStreamingStarted、callStreamingFailed、callStreamingStopped 与 transcription。请求带 telnyx-signature-ed25519 和 telnyx-timestamp 头,生产环境应使用 client.webhooks.unwrap() 验证签名,Express 中需使用原始 body。

限制与错误处理:API 调用可能返回网络错误、429 限流、422 校验错误或 401 认证错误;生产代码应捕获 Telnyx.APIConnectionError、RateLimitError、APIError,并对 429 采用指数退避重试。其余定价、平台范围等信息暂未提供。