Skip to content

Video audio

  • Type video.audio
  • Group MZBase
  • Role action
  • Risk reads only
  • Side effect none
  • Runs once per item
  • Needs media

Adds music, changes the volume, mutes or extracts the audio

Also available to AI agents and over MCP as a tool.

source

Source · string · required · default binary · one of binary, media

Where the input file comes from: the item’s file (binary), a media library item, or a URL.

binaryProperty

File field · string · optional · default data

Shown when source is binary.

mediaId

Media · string · optional

Shown when source is media.

operation

Operation · string · optional · default addMusic · one of addMusic, setVolume, mute, extract

Add music, change the volume, mute, or extract the sound.

audioSource

Music from · string · optional · default binary · one of binary, media

The music or sound file.

Shown when operation is addMusic.

audioBinaryProperty

Music property · string · optional · default data

Shown when audioSource is binary.

audioMediaId

Music (media) · string · optional

Shown when audioSource is media.

musicVolume

Music volume · number · optional · default 0.3 · range 0 – 2

Shown when operation is addMusic.

keepOriginal

Keep the original sound · boolean · optional · default true

Shown when operation is addMusic.

loop

Loop · boolean · optional · default true

Shown when operation is addMusic.

volume

Volume · number · optional · default 1 · range 0 – 4

Shown when operation is setVolume.

format

Format · string · optional · default mp3 · one of mp3, aac, wav

Shown when operation is extract.

into

Into field · string · optional · default data

saveTo

Save to · string · optional · default none · one of none, media

Where the result goes: back on the item as a file, or into the media library (the item then gets mediaId).

mediaFolder

Media folder · string · optional

Shown when saveTo is media.

mediaTags

Media tags · array · optional

Shown when saveTo is media.

  • main

← All nodes