Configuration Reference

This page documents every option you can pass to the POST /v2/edits endpoint (and the SDK process() / create_edit() methods).

Input media

Single file

{
  "input_media": {
    "url": "https://example.com/episode.mp3"
  }
}

Multiple files (multi-track)

Pass an array to process multi-speaker recordings with separate audio tracks:

{
  "input_media": [
    { "url": "https://example.com/host.mp3" },
    { "url": "https://example.com/guest.mp3" }
  ]
}

Audio cleaning

These options detect and remove unwanted sounds from the recording.

fillers

Remove filler words such as "um", "uh", "like", "you know", and similar hesitation markers.

long_silences

Trim long pauses and awkward gaps between sentences.

mouth_sounds

Remove clicks, lip smacks, tongue sounds, and similar mouth noises that often appear between words.

breath

Remove audible breathing sounds between sentences and during pauses.

breath options:

stutters

Detect and remove repeated word fragments (e.g. "I— I— I think").

Audio enhancement

These options improve audio quality without cutting content.

remove_noise

Reduce background noise: hiss, hum, fan noise, AC, street noise, etc.

studio_sound

Apply aggressive audio enhancement to make the recording sound studio-quality. Best used on voice-only recordings in quiet environments.

studio_sound options:

normalize

Balance loudness levels across the recording so it sounds consistent throughout.

autoeq

Legacy automatic EQ correction. Prefer studio_sound; autoeq will be removed in a future release.

mute_lufs + target_lufs

Target a specific integrated loudness level (LUFS). -16 LUFS is the standard for podcasts (Apple Podcasts standard).

{
  "config": {
    "mute_lufs": true,
    "target_lufs": -16
  }
}

Output format

export_format

The audio format for the cleaned output file. This only applies to audio outputs. Video jobs keep the original video container format.

Content generation

transcription

Return a full word-by-word transcript of the audio.

Language is auto-detected. See supported languages.

summarize

Generate chapter markers, key learnings, and an episode summary from the transcript. Requires transcription to be enabled.

social_content

Generate social media post suggestions (tweets, LinkedIn, show notes) from the content.

Additional options

These options are also supported by the current SDK/backend surface but are not covered in the sections above.

Additional cleanup and enhancement

Additional output and delivery

Additional advanced workflow options

Full example

result = client.process(
    "https://example.com/episode.mp3",
    fillers=True,
    long_silences=True,
    mouth_sounds=True,
    breath=True,
    stutters=True,
    remove_noise=True,
    studio_sound=False,
    normalize=True,
    mute_lufs=False,
    target_lufs=-16,
    export_format="mp3",
    transcription=True,
    summarize=True,
    social_content=False,
)

const result = await client.process(
  'https://example.com/episode.mp3',
  {
    fillers: true,
    longSilences: true,
    mouthSounds: true,
    breath: true,
    stutters: true,
    removeNoise: true,
    studioSound: false,
    normalize: true,
    muteLufs: false,
    targetLufs: -16,
    exportFormat: 'mp3',
    transcription: true,
    summarize: true,
    socialContent: false,
  }
);

{
  "input_media": {
    "url": "https://example.com/episode.mp3"
  },
  "config": {
    "fillers": { "enabled": true },
    "long_silences": { "enabled": true },
    "mouth_sounds": { "enabled": true },
    "breath": { "enabled": true },
    "stutters": { "enabled": true },
    "remove_noise": { "enabled": true },
    "studio_sound": { "enabled": false },
    "normalize": { "enabled": true },
    "mute_lufs": false,
    "target_lufs": -16,
    "export_format": "mp3",
    "transcription": { "enabled": true },
    "summarize": { "enabled": true },
    "social_content": { "enabled": false }
  }
}

Recommended presets