sonilo 0.9.0 → 0.11.0

package/dist/index.d.cts

@@ -51,10 +51,13 @@ interface TextToMusicParams {
     prompt: string;
     duration: number;
     segments?: Segment[];
-    /** "stream" (default) or "async" (required by `submit()` and `output_format: "wav"`). */
+    /** "stream" (default) or "async" (required by `submit()` and by any
+     * `outputFormat` other than the m4a default). */
     mode?: "stream" | "async";
-    /** Container for the async result. `wav` requires `mode: "async"`. Defaults to m4a server-side. */
-    outputFormat?: "m4a" | "wav";
+    /** Container for the async result. `wav` and `mp3` (320 kbps) are
+     * finalize-time transcodes and require `mode: "async"`; m4a is what the
+     * stream itself carries. Defaults to m4a server-side. */
+    outputFormat?: "m4a" | "wav" | "mp3";
     /** How many distinct music variants to generate in one request (1-10,
      * default 1). Cost scales linearly, and values above 1 are never covered
      * by the free trial. Values above 1 require `mode: "async"` — only
@@ -93,8 +96,9 @@ interface VideoToMusicParams {
      * `isolateVocals`; both are accepted and OR'd server-side. Requires
      * `mode: "async"` (auto-selected by `submit()`). */
     preserveSpeech?: boolean;
-    /** Container for the async result. `wav` requires async. Defaults to m4a. */
-    outputFormat?: "m4a" | "wav";
+    /** Container for the async result. `wav` and `mp3` (320 kbps) are
+     * finalize-time transcodes and require async. Defaults to m4a. */
+    outputFormat?: "m4a" | "wav" | "mp3";
     /** Duck the generated music under the source voice at finalize time.
      * Default-ON server-side in async mode: leave unset to keep it on, pass
      * `false` to opt out. Free, best-effort; only valid on `submit()`. */
@@ -269,12 +273,53 @@ interface VideoResult extends BaseTaskResult {
     video?: SfxMedia;
     duration_seconds?: number;
 }
+/** Params for `videoToVideoMusic`.
+ *
+ * The delivered video's audio is decided by two independent knobs:
+ * `keepOriginalSound` picks the **voice source**, `ducking` picks how that
+ * voice and the generated music are **combined**.
+ *
+ * | Request | Audio in the returned video |
+ * | --- | --- |
+ * | neither set | generated music only — the source's own audio is removed |
+ * | `keepOriginalSound: true` | full original sound + music ducked under it |
+ * | `keepOriginalSound: true, ducking: false` | full original sound + static music mix |
+ * | `preserveSpeech: true` | isolated vocals + music ducked under them |
+ * | `preserveSpeech: true, ducking: false` | static vocal-forward mix of vocals + music |
+ *
+ * `keepOriginalSound` supersedes `preserveSpeech` — the voice source is a
+ * single choice, and keeping the whole track subsumes keeping only the
+ * isolated speech. No combination is rejected.
+ *
+ * The source picture is copied without re-encoding, so the input must carry
+ * H.264, H.265/HEVC, VP9 or AV1 video in an mp4, mov, m4v or webm container —
+ * animated gif and VP8 webm are rejected. Maximum input duration is 360
+ * seconds. */
 interface VideoToVideoMusicParams {
     video?: VideoInput;
     videoUrl?: string;
     prompt?: string;
-    /** Keep the source speech/vocals in the output. Both this and the legacy
-     * `isolateVocals` are accepted and OR'd server-side. */
+    /** How the music should develop over time. Same shape as
+     * `videoToMusic`'s: the first `start` must be 0. Supplying these skips the
+     * prompt-service plan the server would otherwise derive from `prompt`. */
+    segments?: Segment[];
+    /** Keep the source video's whole original audio track in the result, with
+     * the generated music combined under it. Defaults to `false`, so by
+     * default the returned video's audio is the generated music ALONE and the
+     * source's own audio is removed. Supersedes `preserveSpeech`. */
+    keepOriginalSound?: boolean;
+    /** How the voice and the generated music are combined — not whether a
+     * voice is kept. Default-ON server-side: leave unset for the dynamic duck
+     * (music dips only while the voice is present), pass `false` for a static
+     * voice-forward mix at a fixed offset. Has no effect when there is no
+     * voice source, i.e. neither `keepOriginalSound` nor `preserveSpeech` is
+     * set. Free and best-effort; silently falls back to generated-audio-only
+     * if the source has no usable audio track, voice isolation fails, or the
+     * mix fails. */
+    ducking?: boolean;
+    /** Keep only the source's isolated speech (not the whole track) in the
+     * output. Both this and the legacy `isolateVocals` are accepted and OR'd
+     * server-side. Superseded by `keepOriginalSound`. */
     preserveSpeech?: boolean;
     /** @deprecated Legacy alias for `preserveSpeech`. */
     isolateVocals?: boolean;
@@ -290,9 +335,20 @@ interface VideoToVideoSfxParams {
     prompt?: string;
     segments?: SfxSegment[];
 }
-/** Params for `videoToSound` and `videoToVideoSound`. Both endpoints take the
- * identical form, so they share one params type. */
-interface VideoToSoundParams {
+/** Params for `videoToVideoSound`, and the base every `videoToSound` param
+ * also has. The two endpoints differ in exactly two fields, one in each
+ * direction, and both are enforced at the type level rather than left to the
+ * server to silently ignore:
+ *
+ * - `outputFormat` is **audio-only** — added by `VideoToSoundParams` below, so
+ *   it simply does not exist on this type.
+ * - `keepOriginalSound` is **video-only** — declared here, so
+ *   `VideoToSoundParams` inherits it and has to forbid it explicitly with
+ *   `?: never` (the inheritance runs the other way, so it cannot just be
+ *   omitted the way `outputFormat` is).
+ *
+ * Passing either field to the wrong endpoint is therefore a compile error. */
+interface VideoToVideoSoundParams {
     video?: VideoInput;
     videoUrl?: string;
     /** Style hint for the generated music bed. */
@@ -301,10 +357,20 @@ interface VideoToSoundParams {
     sfxPrompt?: string;
     /** Per-segment SFX descriptions; must start at 0 and be contiguous. */
     segments?: SfxSegment[];
-    /** Keep the source speech in the result. */
+    /** Keep the source video's whole original audio track in the result, with
+     * the generated music + SFX combined under it. Defaults to `false`, so by
+     * default the returned video's audio is the generated music and sound
+     * effects ALONE and the source's own audio is removed — and the result
+     * carries no `music_processed` stem, since with no voice source there is no
+     * processed track. Supersedes `preserveSpeech`. Video endpoint only. */
+    keepOriginalSound?: boolean;
+    /** Keep only the source's isolated speech (not the whole track) in the
+     * result. Superseded by `keepOriginalSound`. */
     preserveSpeech?: boolean;
-    /** Duck the generated music under the source speech. Default-ON
-     * server-side: leave unset to keep it on, pass `false` to opt out. */
+    /** How the voice and the generated bed are combined — not whether a voice
+     * is kept. Default-ON server-side: leave unset for the dynamic duck, pass
+     * `false` for a static voice-forward mix. Has no effect when there is no
+     * voice source. */
     ducking?: boolean;
     /** How many distinct variants to generate in one request (1-10, default
      * 1). Cost scales linearly, and values above 1 are never covered by the
@@ -313,6 +379,22 @@ interface VideoToSoundParams {
      * one entry per variant. */
     variantsNum?: number;
 }
+/** Params for `videoToSound`. Everything `videoToVideoSound` takes, plus the
+ * delivery container for the combined track. */
+interface VideoToSoundParams extends VideoToVideoSoundParams {
+    /** Container for the combined music + SFX track. Defaults to `wav`;
+     * `mp3` is 320 kbps. Applies to the combined output only — the `music`
+     * and `sfx` stems keep their native formats. Not available on
+     * `videoToVideoSound`, which always returns an mp4. */
+    outputFormat?: "wav" | "m4a" | "mp3";
+    /** Not available on this endpoint. `keepOriginalSound` only means something
+     * when the deliverable is a video whose own audio could be preserved;
+     * `videoToSound` returns generated audio, and its default already keeps the
+     * source voice in the mix. Typed `never` so passing it is a compile error
+     * rather than a field the server silently drops — the mirror of how
+     * `outputFormat` is kept off `videoToVideoSound`. */
+    keepOriginalSound?: never;
+}
 /** One variant's outputs on a `videoToSound` / `videoToVideoSound` result.
  * Present even at the default `variantsNum` of 1, as a single-entry array. */
 interface SoundOutputEntry {
@@ -421,7 +503,7 @@ declare class TextToMusic {
     /**
      * Submit an async text-to-music task; poll with
      * `client.tasks.wait<MusicTaskResult>(task.task_id)`. Required for
-     * `outputFormat: "wav"` and `variantsNum` above 1. `stream()`/`generate()`
+     * a non-m4a `outputFormat` and `variantsNum` above 1. `stream()`/`generate()`
      * remain the streaming path.
      */
     submit(params: TextToMusicParams): Promise<SfxTask>;
@@ -435,7 +517,7 @@ declare class VideoToMusic {
     /**
      * Submit an async video-to-music task; poll its result with
      * `client.tasks.wait<MusicTaskResult>(task.task_id)`. Required for
-     * `isolateVocals`/`preserveSpeech`, `outputFormat: "wav"`, and
+     * `isolateVocals`/`preserveSpeech`, a non-m4a `outputFormat`, and
      * `variantsNum` above 1 — the backend rejects all of these on the plain
      * stream, and they only ever run in async mode.
      */
@@ -489,8 +571,8 @@ declare class VideoToSound {
 declare class VideoToVideoSound {
     private readonly client;
     constructor(client: SoniloClient);
-    submit(params: VideoToSoundParams): Promise<SfxTask>;
-    generate(params: VideoToSoundParams, opts?: WaitOptions): Promise<SoundResult>;
+    submit(params: VideoToVideoSoundParams): Promise<SfxTask>;
+    generate(params: VideoToVideoSoundParams, opts?: WaitOptions): Promise<SoundResult>;
 }
 
 /** Dub a video into one or more target languages. Async only; the result
@@ -621,6 +703,6 @@ declare class RequestTimeoutError extends SoniloError {
 declare function download(media: SfxMedia | string | undefined, fetchFn?: typeof globalThis.fetch, timeout?: number): Promise<Uint8Array>;
 
 /** The SDK's own version. Generated by scripts/sync-versions.mjs — do not edit. */
-declare const VERSION = "0.9.0";
+declare const VERSION = "0.11.0";
 
-export { APIError, type AccountServices, type AudioChunkEvent, AuthenticationError, BadRequestError, type BaseTaskResult, type CompleteEvent, type CostEvent, type CostInfo, DEFAULT_TIMEOUT_MS, type DailyUsage, type DubbingLanguage, type DubbingParams, type DubbingResult, type ErrorEvent, GenerationError, type MusicMediaEntry, type MusicMuxEntry, type MusicTaskResult, type MusicTitle, PaymentRequiredError, RateLimitError, RequestTimeoutError, type Segment, type SegmentLabel, type SfxAudioFormat, type SfxError, type SfxMedia, type SfxResult, type SfxSegment, type SfxTask, SoniloClient, type SoniloClientOptions, SoniloError, type SoundOutputEntry, type SoundResult, type StreamEvent, TaskFailedError, TaskTimeoutError, type TextToMusicParams, type TextToSfxParams, type TitleEvent, type Track, TrialExhaustedError, type TrialQuota, type UnknownEvent, type UsageResponse, type UsageSummary, VERSION, type VideoInput, type VideoResult, type VideoToMusicParams, type VideoToSfxParams, type VideoToSoundParams, type VideoToVideoMusicParams, type VideoToVideoSfxParams, type WaitOptions, download, isAudioChunkEvent, isErrorEvent };
+export { APIError, type AccountServices, type AudioChunkEvent, AuthenticationError, BadRequestError, type BaseTaskResult, type CompleteEvent, type CostEvent, type CostInfo, DEFAULT_TIMEOUT_MS, type DailyUsage, type DubbingLanguage, type DubbingParams, type DubbingResult, type ErrorEvent, GenerationError, type MusicMediaEntry, type MusicMuxEntry, type MusicTaskResult, type MusicTitle, PaymentRequiredError, RateLimitError, RequestTimeoutError, type Segment, type SegmentLabel, type SfxAudioFormat, type SfxError, type SfxMedia, type SfxResult, type SfxSegment, type SfxTask, SoniloClient, type SoniloClientOptions, SoniloError, type SoundOutputEntry, type SoundResult, type StreamEvent, TaskFailedError, TaskTimeoutError, type TextToMusicParams, type TextToSfxParams, type TitleEvent, type Track, TrialExhaustedError, type TrialQuota, type UnknownEvent, type UsageResponse, type UsageSummary, VERSION, type VideoInput, type VideoResult, type VideoToMusicParams, type VideoToSfxParams, type VideoToSoundParams, type VideoToVideoMusicParams, type VideoToVideoSfxParams, type VideoToVideoSoundParams, type WaitOptions, download, isAudioChunkEvent, isErrorEvent };

package/dist/index.d.ts

@@ -51,10 +51,13 @@ interface TextToMusicParams {
     prompt: string;
     duration: number;
     segments?: Segment[];
-    /** "stream" (default) or "async" (required by `submit()` and `output_format: "wav"`). */
+    /** "stream" (default) or "async" (required by `submit()` and by any
+     * `outputFormat` other than the m4a default). */
     mode?: "stream" | "async";
-    /** Container for the async result. `wav` requires `mode: "async"`. Defaults to m4a server-side. */
-    outputFormat?: "m4a" | "wav";
+    /** Container for the async result. `wav` and `mp3` (320 kbps) are
+     * finalize-time transcodes and require `mode: "async"`; m4a is what the
+     * stream itself carries. Defaults to m4a server-side. */
+    outputFormat?: "m4a" | "wav" | "mp3";
     /** How many distinct music variants to generate in one request (1-10,
      * default 1). Cost scales linearly, and values above 1 are never covered
      * by the free trial. Values above 1 require `mode: "async"` — only
@@ -93,8 +96,9 @@ interface VideoToMusicParams {
      * `isolateVocals`; both are accepted and OR'd server-side. Requires
      * `mode: "async"` (auto-selected by `submit()`). */
     preserveSpeech?: boolean;
-    /** Container for the async result. `wav` requires async. Defaults to m4a. */
-    outputFormat?: "m4a" | "wav";
+    /** Container for the async result. `wav` and `mp3` (320 kbps) are
+     * finalize-time transcodes and require async. Defaults to m4a. */
+    outputFormat?: "m4a" | "wav" | "mp3";
     /** Duck the generated music under the source voice at finalize time.
      * Default-ON server-side in async mode: leave unset to keep it on, pass
      * `false` to opt out. Free, best-effort; only valid on `submit()`. */
@@ -269,12 +273,53 @@ interface VideoResult extends BaseTaskResult {
     video?: SfxMedia;
     duration_seconds?: number;
 }
+/** Params for `videoToVideoMusic`.
+ *
+ * The delivered video's audio is decided by two independent knobs:
+ * `keepOriginalSound` picks the **voice source**, `ducking` picks how that
+ * voice and the generated music are **combined**.
+ *
+ * | Request | Audio in the returned video |
+ * | --- | --- |
+ * | neither set | generated music only — the source's own audio is removed |
+ * | `keepOriginalSound: true` | full original sound + music ducked under it |
+ * | `keepOriginalSound: true, ducking: false` | full original sound + static music mix |
+ * | `preserveSpeech: true` | isolated vocals + music ducked under them |
+ * | `preserveSpeech: true, ducking: false` | static vocal-forward mix of vocals + music |
+ *
+ * `keepOriginalSound` supersedes `preserveSpeech` — the voice source is a
+ * single choice, and keeping the whole track subsumes keeping only the
+ * isolated speech. No combination is rejected.
+ *
+ * The source picture is copied without re-encoding, so the input must carry
+ * H.264, H.265/HEVC, VP9 or AV1 video in an mp4, mov, m4v or webm container —
+ * animated gif and VP8 webm are rejected. Maximum input duration is 360
+ * seconds. */
 interface VideoToVideoMusicParams {
     video?: VideoInput;
     videoUrl?: string;
     prompt?: string;
-    /** Keep the source speech/vocals in the output. Both this and the legacy
-     * `isolateVocals` are accepted and OR'd server-side. */
+    /** How the music should develop over time. Same shape as
+     * `videoToMusic`'s: the first `start` must be 0. Supplying these skips the
+     * prompt-service plan the server would otherwise derive from `prompt`. */
+    segments?: Segment[];
+    /** Keep the source video's whole original audio track in the result, with
+     * the generated music combined under it. Defaults to `false`, so by
+     * default the returned video's audio is the generated music ALONE and the
+     * source's own audio is removed. Supersedes `preserveSpeech`. */
+    keepOriginalSound?: boolean;
+    /** How the voice and the generated music are combined — not whether a
+     * voice is kept. Default-ON server-side: leave unset for the dynamic duck
+     * (music dips only while the voice is present), pass `false` for a static
+     * voice-forward mix at a fixed offset. Has no effect when there is no
+     * voice source, i.e. neither `keepOriginalSound` nor `preserveSpeech` is
+     * set. Free and best-effort; silently falls back to generated-audio-only
+     * if the source has no usable audio track, voice isolation fails, or the
+     * mix fails. */
+    ducking?: boolean;
+    /** Keep only the source's isolated speech (not the whole track) in the
+     * output. Both this and the legacy `isolateVocals` are accepted and OR'd
+     * server-side. Superseded by `keepOriginalSound`. */
     preserveSpeech?: boolean;
     /** @deprecated Legacy alias for `preserveSpeech`. */
     isolateVocals?: boolean;
@@ -290,9 +335,20 @@ interface VideoToVideoSfxParams {
     prompt?: string;
     segments?: SfxSegment[];
 }
-/** Params for `videoToSound` and `videoToVideoSound`. Both endpoints take the
- * identical form, so they share one params type. */
-interface VideoToSoundParams {
+/** Params for `videoToVideoSound`, and the base every `videoToSound` param
+ * also has. The two endpoints differ in exactly two fields, one in each
+ * direction, and both are enforced at the type level rather than left to the
+ * server to silently ignore:
+ *
+ * - `outputFormat` is **audio-only** — added by `VideoToSoundParams` below, so
+ *   it simply does not exist on this type.
+ * - `keepOriginalSound` is **video-only** — declared here, so
+ *   `VideoToSoundParams` inherits it and has to forbid it explicitly with
+ *   `?: never` (the inheritance runs the other way, so it cannot just be
+ *   omitted the way `outputFormat` is).
+ *
+ * Passing either field to the wrong endpoint is therefore a compile error. */
+interface VideoToVideoSoundParams {
     video?: VideoInput;
     videoUrl?: string;
     /** Style hint for the generated music bed. */
@@ -301,10 +357,20 @@ interface VideoToSoundParams {
     sfxPrompt?: string;
     /** Per-segment SFX descriptions; must start at 0 and be contiguous. */
     segments?: SfxSegment[];
-    /** Keep the source speech in the result. */
+    /** Keep the source video's whole original audio track in the result, with
+     * the generated music + SFX combined under it. Defaults to `false`, so by
+     * default the returned video's audio is the generated music and sound
+     * effects ALONE and the source's own audio is removed — and the result
+     * carries no `music_processed` stem, since with no voice source there is no
+     * processed track. Supersedes `preserveSpeech`. Video endpoint only. */
+    keepOriginalSound?: boolean;
+    /** Keep only the source's isolated speech (not the whole track) in the
+     * result. Superseded by `keepOriginalSound`. */
     preserveSpeech?: boolean;
-    /** Duck the generated music under the source speech. Default-ON
-     * server-side: leave unset to keep it on, pass `false` to opt out. */
+    /** How the voice and the generated bed are combined — not whether a voice
+     * is kept. Default-ON server-side: leave unset for the dynamic duck, pass
+     * `false` for a static voice-forward mix. Has no effect when there is no
+     * voice source. */
     ducking?: boolean;
     /** How many distinct variants to generate in one request (1-10, default
      * 1). Cost scales linearly, and values above 1 are never covered by the
@@ -313,6 +379,22 @@ interface VideoToSoundParams {
      * one entry per variant. */
     variantsNum?: number;
 }
+/** Params for `videoToSound`. Everything `videoToVideoSound` takes, plus the
+ * delivery container for the combined track. */
+interface VideoToSoundParams extends VideoToVideoSoundParams {
+    /** Container for the combined music + SFX track. Defaults to `wav`;
+     * `mp3` is 320 kbps. Applies to the combined output only — the `music`
+     * and `sfx` stems keep their native formats. Not available on
+     * `videoToVideoSound`, which always returns an mp4. */
+    outputFormat?: "wav" | "m4a" | "mp3";
+    /** Not available on this endpoint. `keepOriginalSound` only means something
+     * when the deliverable is a video whose own audio could be preserved;
+     * `videoToSound` returns generated audio, and its default already keeps the
+     * source voice in the mix. Typed `never` so passing it is a compile error
+     * rather than a field the server silently drops — the mirror of how
+     * `outputFormat` is kept off `videoToVideoSound`. */
+    keepOriginalSound?: never;
+}
 /** One variant's outputs on a `videoToSound` / `videoToVideoSound` result.
  * Present even at the default `variantsNum` of 1, as a single-entry array. */
 interface SoundOutputEntry {
@@ -421,7 +503,7 @@ declare class TextToMusic {
     /**
      * Submit an async text-to-music task; poll with
      * `client.tasks.wait<MusicTaskResult>(task.task_id)`. Required for
-     * `outputFormat: "wav"` and `variantsNum` above 1. `stream()`/`generate()`
+     * a non-m4a `outputFormat` and `variantsNum` above 1. `stream()`/`generate()`
      * remain the streaming path.
      */
     submit(params: TextToMusicParams): Promise<SfxTask>;
@@ -435,7 +517,7 @@ declare class VideoToMusic {
     /**
      * Submit an async video-to-music task; poll its result with
      * `client.tasks.wait<MusicTaskResult>(task.task_id)`. Required for
-     * `isolateVocals`/`preserveSpeech`, `outputFormat: "wav"`, and
+     * `isolateVocals`/`preserveSpeech`, a non-m4a `outputFormat`, and
      * `variantsNum` above 1 — the backend rejects all of these on the plain
      * stream, and they only ever run in async mode.
      */
@@ -489,8 +571,8 @@ declare class VideoToSound {
 declare class VideoToVideoSound {
     private readonly client;
     constructor(client: SoniloClient);
-    submit(params: VideoToSoundParams): Promise<SfxTask>;
-    generate(params: VideoToSoundParams, opts?: WaitOptions): Promise<SoundResult>;
+    submit(params: VideoToVideoSoundParams): Promise<SfxTask>;
+    generate(params: VideoToVideoSoundParams, opts?: WaitOptions): Promise<SoundResult>;
 }
 
 /** Dub a video into one or more target languages. Async only; the result
@@ -621,6 +703,6 @@ declare class RequestTimeoutError extends SoniloError {
 declare function download(media: SfxMedia | string | undefined, fetchFn?: typeof globalThis.fetch, timeout?: number): Promise<Uint8Array>;
 
 /** The SDK's own version. Generated by scripts/sync-versions.mjs — do not edit. */
-declare const VERSION = "0.9.0";
+declare const VERSION = "0.11.0";
 
-export { APIError, type AccountServices, type AudioChunkEvent, AuthenticationError, BadRequestError, type BaseTaskResult, type CompleteEvent, type CostEvent, type CostInfo, DEFAULT_TIMEOUT_MS, type DailyUsage, type DubbingLanguage, type DubbingParams, type DubbingResult, type ErrorEvent, GenerationError, type MusicMediaEntry, type MusicMuxEntry, type MusicTaskResult, type MusicTitle, PaymentRequiredError, RateLimitError, RequestTimeoutError, type Segment, type SegmentLabel, type SfxAudioFormat, type SfxError, type SfxMedia, type SfxResult, type SfxSegment, type SfxTask, SoniloClient, type SoniloClientOptions, SoniloError, type SoundOutputEntry, type SoundResult, type StreamEvent, TaskFailedError, TaskTimeoutError, type TextToMusicParams, type TextToSfxParams, type TitleEvent, type Track, TrialExhaustedError, type TrialQuota, type UnknownEvent, type UsageResponse, type UsageSummary, VERSION, type VideoInput, type VideoResult, type VideoToMusicParams, type VideoToSfxParams, type VideoToSoundParams, type VideoToVideoMusicParams, type VideoToVideoSfxParams, type WaitOptions, download, isAudioChunkEvent, isErrorEvent };
+export { APIError, type AccountServices, type AudioChunkEvent, AuthenticationError, BadRequestError, type BaseTaskResult, type CompleteEvent, type CostEvent, type CostInfo, DEFAULT_TIMEOUT_MS, type DailyUsage, type DubbingLanguage, type DubbingParams, type DubbingResult, type ErrorEvent, GenerationError, type MusicMediaEntry, type MusicMuxEntry, type MusicTaskResult, type MusicTitle, PaymentRequiredError, RateLimitError, RequestTimeoutError, type Segment, type SegmentLabel, type SfxAudioFormat, type SfxError, type SfxMedia, type SfxResult, type SfxSegment, type SfxTask, SoniloClient, type SoniloClientOptions, SoniloError, type SoundOutputEntry, type SoundResult, type StreamEvent, TaskFailedError, TaskTimeoutError, type TextToMusicParams, type TextToSfxParams, type TitleEvent, type Track, TrialExhaustedError, type TrialQuota, type UnknownEvent, type UsageResponse, type UsageSummary, VERSION, type VideoInput, type VideoResult, type VideoToMusicParams, type VideoToSfxParams, type VideoToSoundParams, type VideoToVideoMusicParams, type VideoToVideoSfxParams, type VideoToVideoSoundParams, type WaitOptions, download, isAudioChunkEvent, isErrorEvent };

package/dist/index.js

@@ -305,7 +305,7 @@ var TextToMusic = class {
   /**
    * Submit an async text-to-music task; poll with
    * `client.tasks.wait<MusicTaskResult>(task.task_id)`. Required for
-   * `outputFormat: "wav"` and `variantsNum` above 1. `stream()`/`generate()`
+   * a non-m4a `outputFormat` and `variantsNum` above 1. `stream()`/`generate()`
    * remain the streaming path.
    */
   async submit(params) {
@@ -406,7 +406,7 @@ var VideoToMusic = class {
   /**
    * Submit an async video-to-music task; poll its result with
    * `client.tasks.wait<MusicTaskResult>(task.task_id)`. Required for
-   * `isolateVocals`/`preserveSpeech`, `outputFormat: "wav"`, and
+   * `isolateVocals`/`preserveSpeech`, a non-m4a `outputFormat`, and
    * `variantsNum` above 1 — the backend rejects all of these on the plain
    * stream, and they only ever run in async mode.
    */
@@ -415,11 +415,14 @@ var VideoToMusic = class {
       throw new SoniloError("Provide exactly one of video or videoUrl");
     }
     let mode = params.mode;
-    const needsAsync = params.isolateVocals || params.preserveSpeech || params.ducking !== void 0 || params.outputFormat === "wav" || params.variantsNum !== void 0 && params.variantsNum > 1;
+    const needsAsync = params.isolateVocals || params.preserveSpeech || params.ducking !== void 0 || // Any non-m4a container is a finalize-time transcode, so it needs
+    // async. Checking != "m4a" rather than == "wav" keeps this correct
+    // as formats are added (mp3 landed after the original check).
+    params.outputFormat !== void 0 && params.outputFormat !== "m4a" || params.variantsNum !== void 0 && params.variantsNum > 1;
     if (mode === void 0) mode = "async";
     if (needsAsync && mode !== "async") {
       throw new SoniloError(
-        'isolateVocals/preserveSpeech/ducking/outputFormat "wav"/variantsNum > 1 require mode: "async"'
+        'isolateVocals/preserveSpeech/ducking/outputFormat other than "m4a"/variantsNum > 1 require mode: "async"'
       );
     }
     const form = new FormData();
@@ -529,6 +532,13 @@ var VideoToVideoMusic = class {
       form.set("video_url", params.videoUrl);
     }
     if (params.prompt !== void 0) form.set("prompt", params.prompt);
+    if (params.segments !== void 0) {
+      form.set("segments", JSON.stringify(params.segments));
+    }
+    if (params.keepOriginalSound !== void 0) {
+      form.set("keep_original_sound", String(params.keepOriginalSound));
+    }
+    if (params.ducking !== void 0) form.set("ducking", String(params.ducking));
     if (params.preserveSpeech !== void 0) {
       form.set("preserve_speech", String(params.preserveSpeech));
     }
@@ -599,10 +609,16 @@ async function buildSoundForm(params) {
   if (params.segments !== void 0) {
     form.set("segments", JSON.stringify(params.segments));
   }
+  if (params.keepOriginalSound !== void 0) {
+    form.set("keep_original_sound", String(params.keepOriginalSound));
+  }
   if (params.preserveSpeech !== void 0) {
     form.set("preserve_speech", String(params.preserveSpeech));
   }
   if (params.ducking !== void 0) form.set("ducking", String(params.ducking));
+  if (params.outputFormat !== void 0) {
+    form.set("output_format", params.outputFormat);
+  }
   if (params.variantsNum !== void 0) {
     form.set("variants_num", String(params.variantsNum));
   }
@@ -689,7 +705,7 @@ var Dubbing = class {
 };
 
 // src/version.ts
-var VERSION = "0.9.0";
+var VERSION = "0.11.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.sonilo.com";