{"uid":"cap_5mn2lDKJ5QKZwCoQ5mr37","slug":"halowerk-music-ducking-sidechain-compression-mix-c6b52202","name":"Halowerk Music Ducking (Sidechain Compression Mix)","description":"Takes a voice recording and a music track and returns one mix in which the music is lowered by sidechain compression whenever the voice is present and returns in pauses — the standard podcast and voice-over sound. The music is looped or trimmed to the voice length, starts at the chosen bed level and fades out at the end; the voice is levelled first. Depth of ducking and music level are selectable, and the mix is brought to the target loudness, measured afterwards.","url":"https://medien.halowerk.com/v1/music-ducking?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"music":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"filename":{"type":"string","maxLength":260},"content_base64":{"type":"string","maxLength":5500000}},"additionalProperties":false},"voice":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"filename":{"type":"string","maxLength":260},"content_base64":{"type":"string","maxLength":5500000}},"additionalProperties":false},"duck_ratio":{"type":"number","default":8,"maximum":20,"minimum":2,"description":"How strongly the music dips under speech."},"target_lufs":{"type":"number","default":-16,"maximum":-12,"minimum":-24},"output_format":{"enum":["opus","mp3","wav","flac"],"type":"string","default":"mp3"},"music_level_db":{"type":"number","default":-12,"maximum":0,"minimum":-30,"description":"Music level when nobody speaks, relative to the voice."},"duration_minutes":{"type":"integer","maximum":30,"minimum":1,"description":"Length of the voice track in started minutes."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cBrCvTqIllkI0bX0nr-w_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Mixes a voice recording with a background music track using sidechain-style ducking — music lowers automatically when speech is present and returns during pauses — then normalises to a target loudness.","exampleAgentPrompt":"Mix my podcast voice recording with this background music track — duck the music down with a ratio of 8 when I'm speaking, set the music bed at -12 dB, and bring the whole mix to -16 LUFS as an MP3.","exampleUseCases":[{"title":"Podcast episode music bed","prompt":"I've got my podcast episode voice recording and a royalty-free music track. Can you mix them together so the music ducks under my voice when I'm speaking, keep the music at -12 dB, use a duck ratio of 8, and export as MP3 at -16 LUFS?"},{"title":"YouTube voice-over background music","prompt":"I have a narration file and a background music clip for my YouTube video — please mix them so the music lowers whenever I'm speaking using a duck ratio of 10, set the bed at -15 dB, and target -14 LUFS in the output, in WAV format."},{"title":"Radio ad voice-over with music bed","prompt":"Take my 2-minute radio ad voice recording and this music track and produce a ducked mix — I want strong ducking with a ratio of 12 so the music really drops when the voice is on, music level at -10 dB, finalised to -16 LUFS as an MP3."}],"resultDescription":"A single mixed audio file (MP3, WAV, FLAC, or Opus) in which the music track has been looped or trimmed to match the voice length, sidechain-ducked under speech, faded out at the end, and normalised to the specified LUFS target. The voice is levelled before mixing.","failureModes":["Voice or music file exceeds 24 MB upload / base64 limit — returns 400 or payload-too-large error","Unsupported audio codec or format in the uploaded files — returns 422 with format error","duck_ratio or music_level_db outside allowed range — returns 422 validation error","target_lufs outside -24 to -12 range — returns 422 validation error","duration_minutes exceeds 30 — returns 422 validation error","Payment not included or insufficient — returns 402 Payment Required","Source URL unreachable or returns non-audio content — returns 400 or 502"],"whenToPreferThis":"Choose this endpoint when you need a ready-to-publish, broadcast-quality mix of a voice recording and a music bed with automatic sidechain-style ducking — particularly for podcasts, voice-overs, or radio ads — and you want configurable duck depth, music level, and loudness normalisation without running a local DAW or audio processing pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:36.883Z","isFirstParty":false,"canonicalSlug":"halowerk-music-ducking-sidechain-compression-mix-c6b52202"}