Audiowerk

duck

Takes a voice recording and a music bed and returns one mixed file in which the music is pulled down by the voice through an ffmpeg sidechain compressor. Threshold, ratio, attack and release are all settable and all reported back with the result, because they are the difference between a mix that breathes and one that pumps: a release under 100 ms makes the bed audibly flutter between words, above 1500 ms it never returns between sentences. The bed is looped or cut to the length of the voice.

POST https://audio.halowerk.com/duck

Eingaben

Felder des veröffentlichten Eingabeschemas
Feld	Typ	Pflicht	Beschreibung
voice	object	Ja	The voice track. Either url or content_base64.
music	object	Ja	The music bed. Either url or content_base64.
music_gain_db	number	Nein	Level of the bed before ducking, relative to its own level.
threshold_db	number	Nein	Voice level above which the bed starts to be pulled down.
ratio	number	Nein	How hard the bed is pulled down once the threshold is crossed.
attack_ms	integer	Nein	How fast the bed ducks when the voice starts. Short values can clip the first syllable.
release_ms	integer	Nein	How fast the bed returns between words. Under 100 ms the bed audibly flutters.
loop_music	boolean	Nein	Loop a bed shorter than the voice track. Off, the mix ends when the bed does.
output_format	string	Nein	Format of the mixed file.

Vollständiges Eingabeschema anzeigen

{
  "type": "object",
  "required": [
    "voice",
    "music"
  ],
  "additionalProperties": false,
  "properties": {
    "voice": {
      "type": "object",
      "additionalProperties": false,
      "description": "The voice track. Either url or content_base64.",
      "properties": {
        "url": {
          "type": "string",
          "maxLength": 2048,
          "description": "Public http(s) URL."
        },
        "content_base64": {
          "type": "string",
          "maxLength": 12000000,
          "description": "The file inline, base64."
        }
      }
    },
    "music": {
      "type": "object",
      "additionalProperties": false,
      "description": "The music bed. Either url or content_base64.",
      "properties": {
        "url": {
          "type": "string",
          "maxLength": 2048,
          "description": "Public http(s) URL."
        },
        "content_base64": {
          "type": "string",
          "maxLength": 12000000,
          "description": "The file inline, base64."
        }
      }
    },
    "music_gain_db": {
      "type": "number",
      "minimum": -40,
      "maximum": 6,
      "default": -8,
      "description": "Level of the bed before ducking, relative to its own level."
    },
    "threshold_db": {
      "type": "number",
      "minimum": -60,
      "maximum": -6,
      "default": -30,
      "description": "Voice level above which the bed starts to be pulled down."
    },
    "ratio": {
      "type": "number",
      "minimum": 1.5,
      "maximum": 20,
      "default": 8,
      "description": "How hard the bed is pulled down once the threshold is crossed."
    },
    "attack_ms": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 20,
      "description": "How fast the bed ducks when the voice starts. Short values can clip the first syllable."
    },
    "release_ms": {
      "type": "integer",
      "minimum": 50,
      "maximum": 3000,
      "default": 400,
      "description": "How fast the bed returns between words. Under 100 ms the bed audibly flutters."
    },
    "loop_music": {
      "type": "boolean",
      "default": true,
      "description": "Loop a bed shorter than the voice track. Off, the mix ends when the bed does."
    },
    "output_format": {
      "type": "string",
      "enum": [
        "mp3",
        "wav",
        "flac",
        "opus"
      ],
      "default": "mp3",
      "description": "Format of the mixed file."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "voice": {
    "url": "https://audio.halowerk.com/examples/voice.wav"
  },
  "music": {
    "url": "https://audio.halowerk.com/examples/voice.wav"
  }
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Audiowerk0,004 USDC
ad slot auction
POSThttps://audio.halowerk.com/ad-slot-auction
Four actions on one endpoint. create opens a slot with its position, length, reserve price and closing time, and returns an admin token that only the opener holds. bid places a sealed bid, checked against the reserve, the slot length and th
Audiowerk0,006 USDC
audio fingerprint
POSThttps://audio.halowerk.com/audio-fingerprint
Builds an acoustic fingerprint from the submitted audio by decoding it locally with ffmpeg, measuring spectral peaks in fixed Hann-window frames, and hashing target-zone peak pairs. The answer returns the signature, sample method, first has
Audiowerk0,006 USDC
convert
POSThttps://audio.halowerk.com/convert
Converts to FLAC, WAV at 16 or 24 bit, MP3, Opus or AAC, with sample rate, channel count and quality all settable and all reported back. What separates this from a bare transcode is the verdict on what the conversion actually did. The spect

Alle Endpunkte dieses Hubs →

duck

Eingaben

Veröffentlichtes Eingabebeispiel

Ergebnis & Dokumentation

Weitere Endpunkte dieses Hubs

ad slot auction

audio fingerprint

convert