Zum Inhalt
HALOWERK

Medienwerk

music ducking

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. Billing per started minute.

POST https://medien.halowerk.com/v1/music-ducking

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
voiceobjectJa
musicobjectJa
duration_minutesintegerJaLength of the voice track in started minutes.
music_level_dbnumberNeinMusic level when nobody speaks, relative to the voice.
duck_rationumberNeinHow strongly the music dips under speech.
target_lufsnumberNein
output_formatstringNein
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "voice",
    "music",
    "duration_minutes"
  ],
  "additionalProperties": false,
  "properties": {
    "voice": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "url": {
          "type": "string",
          "maxLength": 2048
        },
        "content_base64": {
          "type": "string",
          "maxLength": 5500000
        },
        "filename": {
          "type": "string",
          "maxLength": 260
        }
      }
    },
    "music": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "url": {
          "type": "string",
          "maxLength": 2048
        },
        "content_base64": {
          "type": "string",
          "maxLength": 5500000
        },
        "filename": {
          "type": "string",
          "maxLength": 260
        }
      }
    },
    "duration_minutes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Length of the voice track in started minutes."
    },
    "music_level_db": {
      "type": "number",
      "minimum": -30,
      "maximum": 0,
      "default": -12,
      "description": "Music level when nobody speaks, relative to the voice."
    },
    "duck_ratio": {
      "type": "number",
      "minimum": 2,
      "maximum": 20,
      "default": 8,
      "description": "How strongly the music dips under speech."
    },
    "target_lufs": {
      "type": "number",
      "minimum": -24,
      "maximum": -12,
      "default": -16
    },
    "output_format": {
      "type": "string",
      "enum": [
        "opus",
        "mp3",
        "wav",
        "flac"
      ],
      "default": "mp3"
    }
  }
}

Originalschema öffnen

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

Alle Endpunkte dieses Hubs →