video-background-music-v2
It turns any video into a cinematic experience by generating AI-powered instrumental soundtracks that match its mood.
# Video Background Music Generator
Generates instrumental background music for a given video. If no caption is provided, the video is automatically analyzed to create a fitting music description. The generated music is mixed with the video's original audio and merged into a final MP4.
## Parameters
- video (required) – Input video file path.
- caption – Music description prompt. Auto-generated from the video if empty.
- audio – Optional reference audio for style guidance.
- bpm – Beats per minute. 0 for auto-detect, 1–300 for manual.
- bg_music_volume – Background music volume (0.0–1.0, default: 0.7).
- seed – Random seed. -1 for random.
API quick start
Run video-background-music-v2 with a single API call.
{
"inputVideo": "https://your-cdn.com/input.mp4",
"caption": "Classical piano music.",
"inputAudio": "https://your-cdn.com/input.mp3",
"bpm": 0
}curl -X POST "https://api.wiro.ai/v1/Run/wiro/video-background-music-v2" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_WIRO_API_KEY" \
--data-binary @- <<'JSON'
{
"inputVideo": "https://your-cdn.com/input.mp4",
"caption": "Classical piano music.",
"inputAudio": "https://your-cdn.com/input.mp3",
"bpm": 0
}
JSON