@nodaro/sdk 1.1.1 → 1.2.0

package/dist/index.cjs

@@ -1523,18 +1523,22 @@ var VoicesResource = class {
    * ElevenLabs UUID) OR a {@link VoiceChangerProVoice} object carrying per-voice
    * ElevenLabs speech-to-speech settings (stability / similarityBoost / style /
    * useSpeakerBoost / `seed`) plus a loudness `volumeMode` (and a manual
-   * `volume`). A per-voice `seed` makes that speaker's recast reproducible.
+   * `volume`) — OR `null`, meaning keep this speaker's original voice (requires
+   * a platform running cloud-plugins with keep-slot support). At least one
+   * entry must be non-null. A per-voice `seed` makes that speaker's recast
+   * reproducible.
    *
    * Pass `audioUrl` for audio-only recast or `videoUrl` to recast the audio
    * track of a video clip (the server demuxes, recasts, and remuxes).
    *
-   * Voice and music are ALWAYS separated first — ElevenLabs only ever sees the
-   * isolated vocal stem, never the music bed. `preserveBackground` (default
-   * `true`) only controls whether that music/instrumental stem is mixed back
-   * under the new voices; set it `false` for a clean voice-only result.
-   * `separationQuality` selects the demucs model used for that split: `"fast"`
-   * (default, htdemucs — preserves more of the voice) or `"best"` (htdemucs_ft —
-   * finer separation). `removeBackgroundNoise` additionally denoises the result.
+   * Voice and music are ALWAYS separated first — before recasting, the source
+   * is split into an isolated vocal stem and a music/SFX stem.
+   * `preserveBackground` (default `true`) only controls whether that
+   * music/instrumental stem is mixed back under the new voices; set it `false`
+   * for a clean voice-only result. `separationQuality` selects the quality of
+   * the voice/music separation: `"fast"` (default, quicker — preserves more of
+   * the voice) or `"best"` (finer voice/music separation).
+   * `removeBackgroundNoise` additionally denoises the result.
    * `musicVolumeMode` sets the level of that preserved background (only relevant
    * when `preserveBackground` is on): `"match"` (default) keeps the original
    * level, `"normalize"` loudnorms it, `"manual"` uses `musicVolume`%.