SuperAPI AI 工具集

telnyx-voice-media-curl

通用与其它

查看项目

更新于 10-16 03:37

技能介绍

用途:这是 Telnyx 语音媒体能力的 curl 调用技能,面向需要在通话中控制音频与录音的场景,例如构建 IVR 系统、播放公告、播放 TTS 语音以及录制对话。

主要能力:提供播放音频(playback_start)、停止播放(playback_stop)、文本转语音(speak)、暂停录音(record_pause)、恢复录音(record_resume)、开始录音(record_start)、停止录音(record_stop)等 Call Control 动作端点。播放与朗读支持排队、overlay 模式、loop、command_id、client_state 等参数;录音支持格式、声道、最大时长、提示音、录音轨道、转写与说话人分离等可选配置。

使用方式:curl 在 macOS、Linux 和 Windows 10+ 已预装。先设置环境变量:export TELNYX_API_KEY="YOUR_API_KEY_HERE",随后以 Authorization: Bearer $TELNYX_API_KEY 请求 https://api.telnyx.com/v2/calls/{call_control_id}/actions/... 端点。均返回 result 字符串。所有调用需处理网络错误、限流(429)、校验错误(422)与鉴权错误(401)等状态码。

Webhook 与安全:相关事件包括 callPlaybackStarted/Ended、callRecordingSaved/Error、callRecordingTranscriptionSaved、callSpeakStarted/Ended。Telnyx 使用 Ed25519 非对称签名(非 HMAC),请求携带 telnyx-signature-ed25519 与 telnyx-timestamp 头,生产环境应使用 SDK 的 client.webhooks.unwrap() 校验,并拒绝超过 5 分钟的旧时间戳。端点须在 2 秒内返回 2xx,否则最多重试 3 次,可在门户配置故障转移 URL。

限制:overlay 启用时 target_legs 仅限 self;playback_stop 期望 call.playback.ended 或 call.speak.ended;record_pause 与 record_resume 无关联 webhook。具体收费、配额与账号配置资料暂未提供。