{"uid":"cap__WHxt9Jih34BHL-mYJTrk","slug":"halowerk-audiowerk-duck-voice-ducking-sidechain-compression-42726295","name":"HALOWERK audiowerk Duck (Voice Ducking / Sidechain Compression)","description":"HALOWERK audiowerk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.","url":"https://audio.halowerk.com/duck?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"music":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"description":"Public http(s) URL."},"content_base64":{"type":"string","maxLength":12000000,"description":"The file inline, base64."}},"description":"The music bed. Either url or content_base64.","additionalProperties":false},"ratio":{"type":"number","default":8,"maximum":20,"minimum":1.5,"description":"How hard the bed is pulled down once the threshold is crossed."},"voice":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"description":"Public http(s) URL."},"content_base64":{"type":"string","maxLength":12000000,"description":"The file inline, base64."}},"description":"The voice track. Either url or content_base64.","additionalProperties":false},"attack_ms":{"type":"integer","default":20,"maximum":500,"minimum":1,"description":"How fast the bed ducks when the voice starts. Short values can clip the first syllable."},"loop_music":{"type":"boolean","default":true,"description":"Loop a bed shorter than the voice track. Off, the mix ends when the bed does."},"release_ms":{"type":"integer","default":400,"maximum":3000,"minimum":50,"description":"How fast the bed returns between words. Under 100 ms the bed audibly flutters."},"threshold_db":{"type":"number","default":-30,"maximum":-6,"minimum":-60,"description":"Voice level above which the bed starts to be pulled down."},"music_gain_db":{"type":"number","default":-8,"maximum":6,"minimum":-40,"description":"Level of the bed before ducking, relative to its own level."},"output_format":{"enum":["mp3","wav","flac","opus"],"type":"string","default":"mp3","description":"Format of the mixed file."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_upB73QC0P6Bv07AzaDP5i","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Mixes a voice track over a music bed with automatic ducking — the music volume is pulled down when the voice is detected and restored when it stops.","exampleAgentPrompt":"Mix my voiceover MP3 (https://cdn.example.com/narration.mp3) over this background music file (https://cdn.example.com/music.mp3), ducking the music down by a ratio of 8 when my voice kicks in, with a 20ms attack and 400ms release, threshold at -30dB, and export the result as MP3.","exampleUseCases":[{"title":"Podcast intro music bed mix","prompt":"Take my podcast intro voiceover at https://cdn.example.com/intro-voice.mp3 and mix it over the music bed at https://cdn.example.com/intro-music.mp3 — duck the music with a ratio of 10, 15ms attack, 500ms release, threshold at -28dB, and give me back a WAV file."},{"title":"YouTube video narration over background music","prompt":"I have a narration track at https://storage.example.com/narration.mp3 and a background music loop at https://storage.example.com/background.mp3 — blend them so the music ducks under my voice using a ratio of 6, attack 25ms, release 600ms, threshold -32dB, loop the music to fill the whole narration, and output as MP3."},{"title":"Radio-style ad voiceover with music bed","prompt":"Create a radio ad mix: voice is at https://assets.example.com/ad-voice.wav, music bed at https://assets.example.com/ad-music.mp3 — set music gain to -10dB, duck ratio 12, attack 10ms, release 300ms, threshold -25dB, output as opus."}],"resultDescription":"Returns a mixed audio file (MP3, WAV, FLAC, or Opus as specified) containing the voice track blended over the music bed, with the music automatically attenuated (ducked) during speech and restored during silences, using the configured attack, release, ratio, threshold, and gain parameters.","failureModes":["Invalid or inaccessible audio URL returns an error fetching the resource","Both url and content_base64 missing for voice or music returns a validation error","content_base64 payload exceeding 12MB limit causes a rejection","Ratio, attack_ms, release_ms, threshold_db or music_gain_db out of allowed range returns a 400 validation error","Unsupported output_format value returns a schema validation error","Payment not provided or insufficient USDC on Base Mainnet returns a 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need server-side automatic voice ducking (sidechain compression) of a music bed under a voice track, with fine-grained control over attack, release, ratio, threshold, and gain — especially in podcast, broadcast, or video production workflows where you want professional-sounding mixes without a DAW. Prefer this over manual audio mixing or generic audio conversion endpoints when the goal is specifically to have music automatically respond to voice presence.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:31:02.753Z","isFirstParty":false,"canonicalSlug":"halowerk-audiowerk-duck-voice-ducking-sidechain-compression-42726295"}