SuperAPI AI 工具集

telnyx-voice-media-python

智能体与模型

查看项目

更新于 10-16 09:48

技能介绍

用途:该技能基于 Telnyx Python SDK,在通话中控制音频媒体,适用于构建 IVR 系统、播放语音公告和录制通话。

安装与初始化:pip install telnyx。初始化示例:client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。

主要能力:

  1. 播放音频:调用 client.calls.actions.start_playback,指定 audio_url 等;可停止播放 stop_playback。连续播放命令会排队等待。开启 overlay 时 target_legs 仅限 self。
  2. 文本转语音:client.calls.actions.speak,需 payload 与 voice,可选 language、payload_type(text/ssml)、voice_settings、service_level 等。
  3. 录音:client.calls.actions.start_recording 需 format、channels;支持自定义文件名、最长时长、提示音、录音轨道、超时、转录及转录引擎/语言/说话人分离等。可 pause_recording、resume_recording、stop_recording。

Webhook:使用 Ed25519 签名,请求带 telnyx-signature-ed25519 与 telnyx-timestamp 头。生产环境应验证签名,使用 client.webhooks.unwrap(payload, headers),其中 payload 为原始请求体。相关事件包括 call.playback.started/ended、call.speak.started/ended、call.recording.error/saved、call.recording.transcription.saved。

错误处理:需处理 APIConnectionError、RateLimitError(429,指数退避重试)、APIStatusError(如 401、403、404、422)。

限制:资料未提供具体定价、并发限制或平台覆盖范围等信息。