名称： voicemonkey
描述： 通过 VoiceMonkey API v2 控制 Alexa 设备——进行语音播报、触发 Alexa 例程、启动流程以及在 Echo Show 设备上显示媒体内容。
主页： https://voicemonkey.io
元数据： {"clawdbot":{"emoji":"🐒","requires":{"env":["VOICEMONKEY_TOKEN"]},"primaryEnv":"VOICEMONKEY_TOKEN"}}

VoiceMonkey

通过 VoiceMonkey API v2 控制 Alexa/Echo 设备。支持文本转语音（TTS）播报、触发 Alexa 例程、启动流程以及在 Echo Show 设备上显示图片/视频。

设置步骤

1. 从 Voice Monkey 控制台 获取您的密钥令牌：进入 Settings → API Credentials。
2. 设置环境变量：
   bash export VOICEMONKEY_TOKEN="your-secret-token"
   或者添加到 ~/.clawdbot/clawdbot.json 文件中：
   json { "skills": { "entries": { "voicemonkey": { "env": { "VOICEMONKEY_TOKEN": "your-secret-token" } } } } }
3. 在 Voice Monkey 控制台中找到您的设备 ID：进入 Settings → Devices。

API 基础 URL

https://api-v2.voicemonkey.io

播报 API

在 Alexa 设备上进行 TTS 播报、播放音频/视频或显示图片。

端点： https://api-v2.voicemonkey.io/announcement

基础 TTS 播报

curl -X GET "https://api-v2.voicemonkey.io/announcement?token=$VOICEMONKEY_TOKEN&device=YOUR_DEVICE_ID&text=Hello%20from%20Echo"

使用 Authorization 请求头（推荐）

curl -X POST "https://api-v2.voicemonkey.io/announcement" \
  -H "Authorization: $VOICEMONKEY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "device": "YOUR_DEVICE_ID",
    "text": "Hello from Echo the Fox!"
  }'

指定语音与提示音

curl -X POST "https://api-v2.voicemonkey.io/announcement" \
  -H "Authorization: $VOICEMONKEY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "device": "YOUR_DEVICE_ID",
    "text": "Dinner is ready!",
    "voice": "Brian",
    "chime": "soundbank://soundlibrary/alarms/beeps_and_bloops/bell_02"
  }'

在 Echo Show 上显示图片

curl -X POST "https://api-v2.voicemonkey.io/announcement" \
  -H "Authorization: $VOICEMONKEY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "device": "YOUR_DEVICE_ID",
    "text": "Check out this image",
    "image": "https://example.com/image.jpg",
    "media_width": "100",
    "media_height": "100",
    "media_scaling": "best-fit"
  }'

播放音频文件

curl -X POST "https://api-v2.voicemonkey.io/announcement" \
  -H "Authorization: $VOICEMONkey_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "device": "YOUR_DEVICE_ID",
    "audio": "https://example.com/sound.mp3"
  }'

在 Echo Show 上播放视频

curl -X POST "https://api-v2.voicemonkey.io/announcement" \
  -H "Authorization: $VOICEMONKEY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "device": "YOUR_DEVICE_ID",
    "video": "https://example.com/video.mp4",
    "video_repeat": 1
  }'

在 Echo Show 上打开网站

curl -X POST "https://api-v2.voicemonkey.io/announcement" \
  -H "Authorization: $VOICEMONKEY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "device": "YOUR_DEVICE_ID",
    "website": "https://example.com",
    "no_bg": "true"
  }'

播报参数说明

例程触发 API

触发 Voice Monkey 设备以启动 Alexa 例程。

端点： https://api-v2.voicemonkey.io/trigger

curl -X POST "https://api-v2.voicemonkey.io/trigger" \
  -H "Authorization: $VOICEMONKEY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "device": "YOUR_TRIGGER_DEVICE_ID"
  }'

流程触发 API

启动 Voice Monkey 流程。

端点： https://api-v2.voicemonkey.io/flows

curl -X POST "https://api-v2.voicemonkey.io/flows" \
  -H "Authorization: $VOICEMONKEY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "device": "YOUR_DEVICE_ID",
    "flow": 12345
  }'

媒体要求

图片

• 支持大多数常见格式（JPG、PNG 等）
• 不支持动态 GIF
• 优化文件大小以加快加载速度
• 必须托管在具有有效 SSL 的 HTTPS URL 上
• CORS 必须允许通配符：Access-Control-Allow-Origin: *

视频

• 仅支持 MP4 格式（MPEG-4 Part-14）
• 音频编解码器：AAC、MP3
• 最大分辨率：1080p @30fps 或 @60fps
• 必须托管在具有有效 SSL 的 HTTPS URL 上

音频

• 格式：AAC、MP3、OGG、Opus、WAV
• 比特率：≤ 1411.20 kbps
• 采样率：≤ 48kHz
• 文件大小：≤ 10MB
• 总响应时长：≤ 240 秒

SSML 示例

在 text 参数中使用 SSML 以实现更丰富的播报效果：

<speak>
  <amazon:emotion name="excited" intensity="high">
    这是个令人兴奋的消息！
  </amazon:emotion>
</speak>

<speak>
  现在是 <say-as interpret-as="time">3:30pm</say-as>
</speak>

注意事项

• 请妥善保管您的令牌；若泄露，请通过 Console → Settings → API Credentials 进行轮换。
• 使用 API Playground 进行测试和探索选项。
• 高级会员可直接在 Voice Monkey 控制台上传媒体文件。
• 发送播报前请务必确认，以避免产生意外噪音。