Video Music Remover API Documentation

Video Music Remover API Documentation

Playground

Video Music Remover strips the background music from any video while keeping dialogue and sound effects, so you can reuse, re-score or dub footage. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Video Music Remover removes the background music from a video and keeps everything else: dialogue, voices and sound effects stay where they were, and the picture is left untouched. Use it to clear music before reposting a clip, to re-score footage with your own track, or to prepare a video for dubbing.

Key capabilities

• Removes background music Takes out the music bed under your video, including songs and instrumental scores.

• Keeps dialogue and sound effects Speech, footsteps, impacts, ambience and other effects remain in the soundtrack.

• Original picture The video frames are not re-generated or re-encoded: resolution, frame rate and quality stay the same.

• Long videos Handles videos up to 10 minutes in one request.

Parameters and how to use

• video: (required): URL of the input video.

How to use

1. video – (required) Provide the URL of the video.

After you finish configuring the parameters, click Run, preview the result, and iterate if needed.

Pricing

> Billing duration: Input media duration is rounded up to whole seconds. The minimum billed duration is 3 seconds; shorter inputs are billed as 3 seconds.

Rate: $0.01 per 5 seconds (capped at 600s / $1.20).

Notes

• A video without an audio track has no music to remove and is returned unchanged.
• Videos longer than 10 minutes are trimmed to the first 10 minutes.
• Music that is much louder than the dialogue may leave faint traces, and steady background sounds such as rain can be slightly quieter in the result.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "video": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/video-music-remover" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters