{"uid":"cap_b7lUhn3kkdihMuKAH0vuU","slug":"agents-vimmerse-net-vimmerse-attach-audio-to-video-0e7600c7","name":"Vimmerse Attach Audio to Video","description":"Attaches **`audio_url`** to **`video_url`**.\n\n**`attach_mode`:** `MatchVideo`, `PadAudio`, `MatchAudio`, `SpeedAdjust`, `Strict`","url":"https://agents.vimmerse.net/v2/video/audio?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"AttachAudioRequest","required":["video_url","audio_url"],"properties":{"audio_url":{"type":"string","title":"Audio URL"},"video_url":{"type":"string","title":"Video URL"},"async_mode":{"type":"boolean","title":"Async Mode","default":false},"attach_mode":{"type":"string","title":"Attach Mode","default":"MatchVideo","description":"`MatchVideo`, `PadAudio`, `MatchAudio`, `SpeedAdjust`, or `Strict`."},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook URL"},"audio_duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Audio duration (seconds)"},"video_duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Video duration (seconds)"}}},"responseSchema":{},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_dbKWtWyLVykjR52J6cOsW","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000000","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.vimmerse.net","brandSlug":"agents-vimmerse-net-x402","brandBaseUrl":"https://agents.vimmerse.net","brandDocsUrl":null,"whatItDoes":"Attaches an audio track to a video file with configurable duration-matching modes (MatchVideo, PadAudio, MatchAudio, SpeedAdjust, Strict).","exampleAgentPrompt":"Take this video at https://example.com/myvideo.mp4 and attach the audio from https://example.com/mytrack.mp3 to it, using MatchVideo mode so the audio gets trimmed or looped to match the video length.","exampleUseCases":[{"title":"Background music for a promo video","prompt":"I have a product promo video at https://cdn.example.com/promo.mp4 and a music file at https://cdn.example.com/bgmusic.mp3 — can you attach the music to the video using MatchVideo mode so it fits the video perfectly?"},{"title":"Voiceover narration on a slideshow","prompt":"Please attach my recorded narration at https://storage.example.com/narration.wav to the slideshow video at https://storage.example.com/slides.mp4 using Strict mode — both are exactly 60 seconds."},{"title":"Speed-adjust audio to match video","prompt":"I've got a 90-second video at https://media.example.com/clip.mp4 and a 75-second song at https://media.example.com/song.mp3. Attach the audio to the video using SpeedAdjust mode so the song stretches to fill the full video."}],"resultDescription":"A processed video file with the specified audio track attached, returned either synchronously as a result URL or asynchronously as a job ID that can be polled for completion. The response includes the output video URL once processing finishes.","failureModes":["Invalid or inaccessible video_url or audio_url (404 or permission errors)","Unsupported media format for video or audio input","Strict mode failure when durations do not match exactly","Timeout on large files in synchronous mode","Webhook delivery failure in async mode","Insufficient credits to process the request"],"whenToPreferThis":"Use this endpoint when you need to combine a separate audio file (music, voiceover, sound effects) with a video and require precise control over how duration mismatches are handled — choose from five attach modes (MatchVideo trims/loops audio, PadAudio pads audio with silence, MatchAudio trims video, SpeedAdjust changes playback speed, Strict enforces exact duration match). Prefer this over manual video editing tools when automating media pipelines or when the audio and video durations may differ.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:38:31.555Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-vimmerse-attach-audio-to-video-0e7600c7"}