Media

Voice Monkey supports three kinds of media — audio, video and images — in announcements and Flow nodes. Anywhere a node or Announcement API parameter takes a URL (audio, image, video, background_audio, website_url), you can use any of the sources below.

Where the media comes from

You have three options:

1. Self-hosted URL — paste any public HTTPS URL. Common choices: S3/R2 buckets, Dropbox public links, Google Drive direct links.
2. Upload to Voice Monkey (Hobby and Ultimate) — upload via the console at app.voicemonkey.io/media. Each uploaded file gets a public https://media.voicemonkey.io/… URL — copy it from the Copy URL button on the file card and paste it into any node or API call. Uploaded files are capped at 100 MB each.
3. Curated library — pre-made soundscapes, sounds and videos that ship with Voice Monkey. See below.

In Flow nodes and the Playground, the Browse button on every URL field opens a media picker that lets you pick from any of these sources without copying URLs by hand.

Curated library

Voice Monkey ships a library of pre-made media: Halloween soundscapes, sleep sounds (Fan Sounds, Ocean Waves and White Noise), dog barking, and Halloween and Christmas portraits and video pranks for Echo Show. Items are referenced with the short tag syntax:

media://<slug>

For example:

{
  "audio": "media://fan-sounds"
}

The API resolves the tag to the real underlying URL at request time. The real URL is intentionally hidden — it can change without breaking your saved flows, and library content can’t be hotlinked from outside Voice Monkey.

Browse the curated library by hitting Browse on any media URL field in a Flow node or in the Playground, then switching to the Library tab. The picker writes the right media://<slug> value for you — no need to remember slugs.

Using images

• Displayed on screen-enabled Echo devices (Echo Show, Echo Show 15).
• Supported formats: JPG, PNG. Keep size under 5 MB for best reliability.
• Use the image parameter on the Announcement API or an Image action in a Flow.

Using videos

• Displayed on Echo Shows only.
• Supported formats: MP4 (H.264). Aim for ≤ 30 MB for fast startup.
• Use the video parameter on the Announcement API or a Video action in a Flow.
• Ambient videos loop indefinitely — add a Wait + Stop Media if you want a time limit.

Using audio

• Supported formats: MP3 (recommended), MP4. 44.1 kHz / 48 kHz, mono or stereo.
• Your own audio files can be up to 240 seconds long via the audio parameter or the Audio node’s Sound tab. Longer files won’t play at all, so put them on the Audio node’s Long audio tab instead, which has no length limit. Any speech in the same part of a Flow counts toward the 240 seconds.
• Library soundscapes and HLS streams (.m3u8) have no length limit. Via the audio parameter or the Sound tab they play in full on the Echo’s music player, until they finish or you say “Alexa, stop”.
• Use the audio parameter on the Announcement API or an Audio action in a Flow.
• Most pre-built soundscapes live in the curated library — reference them with media://<slug>.

Plan limits

Feature	Free	Hobby	Ultimate
Reference external URLs	yes	yes	yes
Use the curated library	yes	yes	yes
Upload your own files	no	yes	yes