@nodaro/sdk 1.4.0 → 1.5.0

package/dist/index.d.cts

@@ -3387,10 +3387,16 @@ declare class VoicesResource {
         voiceId: string;
         audioUrl?: string;
         videoUrl?: string;
+        /** Speech-to-speech model id. Defaults to the server-configured default when omitted. */
+        model?: string;
         stability?: number;
         similarityBoost?: number;
         /** Style exaggeration (0–1). Default 0; >0 amplifies delivery at the cost of latency/stability. */
         style?: number;
+        /** ElevenLabs speaker boost — sharpens fidelity to the target speaker (small latency cost). */
+        useSpeakerBoost?: boolean;
+        /** Deterministic speech-to-speech seed (integer 0–4294967295) for reproducible output. Omit for random. */
+        seed?: number;
         removeBackgroundNoise?: boolean;
     }): Promise<{
         jobId: string;
@@ -3465,6 +3471,49 @@ declare class VoicesResource {
     exportMix(input: VcpExportInput): Promise<{
         jobId: string;
     }>;
+    /**
+     * Design a brand-new synthetic voice from a text description
+     * (`POST /v1/voice-design`) — ElevenLabs text-to-voice. `text` (100–1000 chars)
+     * is a preview line spoken in the designed voice; `voiceDescription` describes
+     * the voice to create. Costs credits and runs async — poll `jobs.get(jobId)`
+     * for the preview + the reusable voice id.
+     */
+    design(input: VoiceDesignInput): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Generate speech in a voice described in natural language, without cloning
+     * (`POST /v1/voice-remix`). `text` (1–5000 chars) is spoken in a voice matching
+     * `voiceDescription`. Costs credits and runs async — poll `jobs.get(jobId)`.
+     */
+    remix(input: VoiceRemixInput): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Dub an audio clip into another language while preserving each speaker's voice
+     * (`POST /v1/dubbing`). `targetLanguage` is an ISO code (e.g. `"es"`, `"fr"`);
+     * `sourceLanguage` is auto-detected when omitted. Costs credits and runs async
+     * — poll `jobs.get(jobId)`.
+     */
+    dub(input: DubbingInput): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Clone a voice from an audio FILE you hold in memory
+     * (`POST /v1/voice-clones`, multipart) — the counterpart to
+     * {@link VoicesResource.createClone}, which clones from an already-uploaded
+     * URL. Pass the raw audio `file` (a `Blob`/`File` in the browser, or a
+     * `Uint8Array`/`Buffer` in Node) plus a `name`. Costs credits. Returns the new
+     * {@link VoiceClone} (`elevenlabsVoiceId` is the id to recast/synthesize with).
+     */
+    createCloneFromFile(input: {
+        name: string;
+        file: Blob | Uint8Array | ArrayBuffer;
+        /** File name for the upload part (default `sample`). */
+        filename?: string;
+        /** MIME type when `file` is a raw buffer (default `audio/mpeg`). */
+        contentType?: string;
+    }): Promise<VoiceClone>;
 }
 /**
  * One entry in {@link VoiceChangerProInput.orderedVoices}. Either a bare voice id
@@ -3646,6 +3695,226 @@ interface VcpExportInput {
      */
     voiceFx?: VoiceChangerProInput["voiceFx"];
 }
+/** Input for {@link VoicesResource.design}. */
+interface VoiceDesignInput {
+    /** A preview line (100–1000 chars) spoken in the designed voice. */
+    text: string;
+    /** Natural-language description of the voice to create. */
+    voiceDescription: string;
+    /** Voice-design model id. Defaults to the server-configured default. */
+    model?: string;
+    /** Output loudness (-1..1). */
+    loudness?: number;
+    /** How strongly the description steers the design (0–100). */
+    guidanceScale?: number;
+    /** Deterministic seed for a reproducible design. */
+    seed?: number;
+    /** Design quality knob (provider-specific). */
+    quality?: number;
+    /** Enhance the generated voice. */
+    shouldEnhance?: boolean;
+    /** Optional extra prompt context (≤8000 chars). */
+    userPrompt?: string;
+}
+/** Input for {@link VoicesResource.remix}. */
+interface VoiceRemixInput {
+    /** The text (1–5000 chars) to speak in the described voice. */
+    text: string;
+    /** Natural-language description of the voice to speak in. */
+    voiceDescription: string;
+    /** Optional extra prompt context (≤8000 chars). */
+    userPrompt?: string;
+}
+/** Input for {@link VoicesResource.dub}. */
+interface DubbingInput {
+    /** URL of the audio to dub. */
+    audioUrl: string;
+    /** Target language ISO code (2–10 chars), e.g. `"es"`, `"pt-BR"`. */
+    targetLanguage: string;
+    /** Source language ISO code; auto-detected when omitted. */
+    sourceLanguage?: string;
+    /** Expected number of speakers (1–20) — improves separation when known. */
+    numSpeakers?: number;
+    /** Keep the original voices instead of cloning them into the target language. */
+    disableVoiceCloning?: boolean;
+    /** Drop the background/music bed from the dubbed output. */
+    dropBackgroundAudio?: boolean;
+}
+
+/**
+ * Media ingestion + trimming — the source-preparation steps a Voice Changer Pro
+ * flow (or any pipeline) needs before it has a clip to work on: pull a social
+ * video into storage, copy a remote URL into storage, trim a video/audio to a
+ * range, and probe a video's metadata. Each generation-style op returns a job id
+ * to poll (`jobs.get(jobId)`); `videoMetadata` is a direct read.
+ */
+declare class MediaResource {
+    private client;
+    constructor(client: NodaroClient);
+    /**
+     * Download a social video (YouTube / TikTok / Instagram / X / Facebook) into
+     * your storage (`POST /v1/download-video`). `maxHeight` caps the resolution
+     * (default "best"); `sectionStartSec` + `sectionEndSec` (both-or-neither) fetch
+     * ONLY that time range instead of the whole video. Returns a `downloadId`;
+     * progress streams from `GET /v1/download-video/progress/:downloadId`
+     * (server-sent events) and the finished file lands in your library.
+     */
+    downloadVideo(input: {
+        url: string;
+        maxHeight?: number;
+        sectionStartSec?: number;
+        sectionEndSec?: number;
+    }): Promise<{
+        downloadId: string;
+    }>;
+    /**
+     * Copy an external media URL into your Nodaro storage (`POST /v1/save-to-storage`)
+     * — a server-side fetch, so nothing round-trips through the client. Poll
+     * `jobs.get(jobId)`.
+     */
+    saveToStorage(input: {
+        mediaUrl: string;
+        filename?: string;
+        mediaType?: "image" | "video" | "audio";
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Trim a video to a range (`POST /v1/trim-video`). Give the range in whichever
+     * unit fits: `startTime`/`endTime` seconds, `trim*Frames`, `trim*Seconds`, or
+     * `keepFirst`/`keepLastSeconds`. Poll `jobs.get(jobId)`.
+     */
+    trimVideo(input: {
+        videoUrl: string;
+        startTime?: number;
+        endTime?: number;
+        trimStartFrames?: number;
+        trimEndFrames?: number;
+        trimStartSeconds?: number;
+        trimEndSeconds?: number;
+        keepFirstSeconds?: number;
+        keepLastSeconds?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Trim (and extract) audio from a video or audio source
+     * (`POST /v1/trim-audio`) to `[startTime, endTime]` seconds, in `audioFormat`
+     * (`mp3` default / `wav` / `aac`). Poll `jobs.get(jobId)`.
+     */
+    trimAudio(input: {
+        videoUrl?: string;
+        audioUrl?: string;
+        audioFormat?: "mp3" | "wav" | "aac";
+        startTime?: number;
+        endTime?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,
+     * dimensions, title, live status — WITHOUT downloading it. A direct read, not a
+     * job. Use it to decide whether to trim before importing.
+     */
+    videoMetadata(input: {
+        url: string;
+    }): Promise<VideoMetadata>;
+}
+/** Result of {@link MediaResource.videoMetadata}. Fields are best-effort — a probe may omit some. */
+interface VideoMetadata {
+    durationSec?: number | null;
+    width?: number | null;
+    height?: number | null;
+    title?: string | null;
+    isLive?: boolean;
+    [key: string]: unknown;
+}
+
+/**
+ * Audio primitives — the building blocks Voice Changer Pro composes internally
+ * (separation, isolation, effect, mix, level), exposed standalone so a consumer
+ * can run any single step or assemble its own pipeline. Each returns a job id to
+ * poll (`jobs.get(jobId)`).
+ */
+declare class AudioResource {
+    private client;
+    constructor(client: NodaroClient);
+    /**
+     * Separate an audio track into stems (`POST /v1/audio-separation`, Demucs).
+     * `mode` `"vocal_instrumental"` (default) splits voice from music/SFX;
+     * `"stems"` returns the full drums/bass/other/… breakdown. `quality`
+     * `auto` (default) / `fast` / `best`.
+     */
+    separate(input: {
+        audioUrl: string;
+        mode?: "vocal_instrumental" | "stems";
+        quality?: "auto" | "fast" | "best";
+    }): Promise<{
+        jobId: string;
+    }>;
+    /** Isolate the primary voice and strip background noise (`POST /v1/audio-isolation`, ElevenLabs). */
+    isolate(input: {
+        audioUrl: string;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Apply a reverb / echo / telephone / megaphone effect to an audio track
+     * (`POST /v1/audio-fx`) — the same presets VCP's `voiceFx` uses, standalone.
+     * `mix` (0–100) is the reverb wet/dry; `delayMs` + `decay` drive `echo`/`custom`;
+     * `eqLow`/`eqHigh` (dB) shape telephone/megaphone.
+     */
+    applyFx(input: {
+        audioUrl: string;
+        preset?: AudioFxPreset;
+        mix?: number;
+        delayMs?: number;
+        decay?: number;
+        eqLow?: number;
+        eqHigh?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Layer multiple audio tracks into one (`POST /v1/mix-audio`). `audioUrls`
+     * (2–20) are summed; optional `trackVolumes` (0–200% each, positionally) set
+     * per-track level.
+     */
+    mix(input: {
+        audioUrls: string[];
+        trackVolumes?: number[];
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Adjust an audio (or a video's audio) level (`POST /v1/adjust-volume`):
+     * `volume` % (default 100), `normalize` to loudnorm, and `fadeIn`/`fadeOut`
+     * seconds. Provide `audioUrl` or `videoUrl`.
+     */
+    adjustVolume(input: {
+        audioUrl?: string;
+        videoUrl?: string;
+        volume?: number;
+        normalize?: boolean;
+        fadeIn?: number;
+        fadeOut?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Concatenate audio segments end-to-end (`POST /v1/combine-audio`). Each
+     * segment is a `url` with an optional `[startTime, endTime]` sub-range.
+     */
+    combine(input: {
+        segments: Array<{
+            url: string;
+            startTime?: number;
+            endTime?: number;
+        }>;
+    }): Promise<{
+        jobId: string;
+    }>;
+}
 
 /**
  * Authenticated user's credit balance — the shape of `GET /v1/user/credits`'s
@@ -4082,6 +4351,8 @@ declare class NodaroClient {
     readonly reduce: ReduceResource;
     readonly promptHelper: PromptHelperResource;
     readonly voices: VoicesResource;
+    readonly media: MediaResource;
+    readonly audio: AudioResource;
     readonly credits: CreditsResource;
     readonly uploads: UploadsResource;
     readonly library: LibraryResource;
@@ -4176,4 +4447,4 @@ interface ApiErrorBody {
 }
 declare function throwFromResponse(status: number, body: ApiErrorBody): never;
 
-export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, CommunityResource, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateProjectInput, type CreateWorkflowInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DuplicateCharacterInput, type EnhanceInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type Job, JobAbortedError, JobFailedError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type ModelCostsResult, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RotateSecretResult, type RunAndWaitOptions, type RunManyResult, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, StaticTokenAuth, StorageExceededError, type StructuredReferenceParams, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VoiceChangerProInput, type VoiceChangerProVoice, VoicesResource, type Workflow, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };
+export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, CommunityResource, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateProjectInput, type CreateWorkflowInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DubbingInput, type DuplicateCharacterInput, type EnhanceInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type Job, JobAbortedError, JobFailedError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, MediaResource, type ModelCostsResult, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RotateSecretResult, type RunAndWaitOptions, type RunManyResult, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, StaticTokenAuth, StorageExceededError, type StructuredReferenceParams, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoMetadata, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };

package/dist/index.d.ts

@@ -3387,10 +3387,16 @@ declare class VoicesResource {
         voiceId: string;
         audioUrl?: string;
         videoUrl?: string;
+        /** Speech-to-speech model id. Defaults to the server-configured default when omitted. */
+        model?: string;
         stability?: number;
         similarityBoost?: number;
         /** Style exaggeration (0–1). Default 0; >0 amplifies delivery at the cost of latency/stability. */
         style?: number;
+        /** ElevenLabs speaker boost — sharpens fidelity to the target speaker (small latency cost). */
+        useSpeakerBoost?: boolean;
+        /** Deterministic speech-to-speech seed (integer 0–4294967295) for reproducible output. Omit for random. */
+        seed?: number;
         removeBackgroundNoise?: boolean;
     }): Promise<{
         jobId: string;
@@ -3465,6 +3471,49 @@ declare class VoicesResource {
     exportMix(input: VcpExportInput): Promise<{
         jobId: string;
     }>;
+    /**
+     * Design a brand-new synthetic voice from a text description
+     * (`POST /v1/voice-design`) — ElevenLabs text-to-voice. `text` (100–1000 chars)
+     * is a preview line spoken in the designed voice; `voiceDescription` describes
+     * the voice to create. Costs credits and runs async — poll `jobs.get(jobId)`
+     * for the preview + the reusable voice id.
+     */
+    design(input: VoiceDesignInput): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Generate speech in a voice described in natural language, without cloning
+     * (`POST /v1/voice-remix`). `text` (1–5000 chars) is spoken in a voice matching
+     * `voiceDescription`. Costs credits and runs async — poll `jobs.get(jobId)`.
+     */
+    remix(input: VoiceRemixInput): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Dub an audio clip into another language while preserving each speaker's voice
+     * (`POST /v1/dubbing`). `targetLanguage` is an ISO code (e.g. `"es"`, `"fr"`);
+     * `sourceLanguage` is auto-detected when omitted. Costs credits and runs async
+     * — poll `jobs.get(jobId)`.
+     */
+    dub(input: DubbingInput): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Clone a voice from an audio FILE you hold in memory
+     * (`POST /v1/voice-clones`, multipart) — the counterpart to
+     * {@link VoicesResource.createClone}, which clones from an already-uploaded
+     * URL. Pass the raw audio `file` (a `Blob`/`File` in the browser, or a
+     * `Uint8Array`/`Buffer` in Node) plus a `name`. Costs credits. Returns the new
+     * {@link VoiceClone} (`elevenlabsVoiceId` is the id to recast/synthesize with).
+     */
+    createCloneFromFile(input: {
+        name: string;
+        file: Blob | Uint8Array | ArrayBuffer;
+        /** File name for the upload part (default `sample`). */
+        filename?: string;
+        /** MIME type when `file` is a raw buffer (default `audio/mpeg`). */
+        contentType?: string;
+    }): Promise<VoiceClone>;
 }
 /**
  * One entry in {@link VoiceChangerProInput.orderedVoices}. Either a bare voice id
@@ -3646,6 +3695,226 @@ interface VcpExportInput {
      */
     voiceFx?: VoiceChangerProInput["voiceFx"];
 }
+/** Input for {@link VoicesResource.design}. */
+interface VoiceDesignInput {
+    /** A preview line (100–1000 chars) spoken in the designed voice. */
+    text: string;
+    /** Natural-language description of the voice to create. */
+    voiceDescription: string;
+    /** Voice-design model id. Defaults to the server-configured default. */
+    model?: string;
+    /** Output loudness (-1..1). */
+    loudness?: number;
+    /** How strongly the description steers the design (0–100). */
+    guidanceScale?: number;
+    /** Deterministic seed for a reproducible design. */
+    seed?: number;
+    /** Design quality knob (provider-specific). */
+    quality?: number;
+    /** Enhance the generated voice. */
+    shouldEnhance?: boolean;
+    /** Optional extra prompt context (≤8000 chars). */
+    userPrompt?: string;
+}
+/** Input for {@link VoicesResource.remix}. */
+interface VoiceRemixInput {
+    /** The text (1–5000 chars) to speak in the described voice. */
+    text: string;
+    /** Natural-language description of the voice to speak in. */
+    voiceDescription: string;
+    /** Optional extra prompt context (≤8000 chars). */
+    userPrompt?: string;
+}
+/** Input for {@link VoicesResource.dub}. */
+interface DubbingInput {
+    /** URL of the audio to dub. */
+    audioUrl: string;
+    /** Target language ISO code (2–10 chars), e.g. `"es"`, `"pt-BR"`. */
+    targetLanguage: string;
+    /** Source language ISO code; auto-detected when omitted. */
+    sourceLanguage?: string;
+    /** Expected number of speakers (1–20) — improves separation when known. */
+    numSpeakers?: number;
+    /** Keep the original voices instead of cloning them into the target language. */
+    disableVoiceCloning?: boolean;
+    /** Drop the background/music bed from the dubbed output. */
+    dropBackgroundAudio?: boolean;
+}
+
+/**
+ * Media ingestion + trimming — the source-preparation steps a Voice Changer Pro
+ * flow (or any pipeline) needs before it has a clip to work on: pull a social
+ * video into storage, copy a remote URL into storage, trim a video/audio to a
+ * range, and probe a video's metadata. Each generation-style op returns a job id
+ * to poll (`jobs.get(jobId)`); `videoMetadata` is a direct read.
+ */
+declare class MediaResource {
+    private client;
+    constructor(client: NodaroClient);
+    /**
+     * Download a social video (YouTube / TikTok / Instagram / X / Facebook) into
+     * your storage (`POST /v1/download-video`). `maxHeight` caps the resolution
+     * (default "best"); `sectionStartSec` + `sectionEndSec` (both-or-neither) fetch
+     * ONLY that time range instead of the whole video. Returns a `downloadId`;
+     * progress streams from `GET /v1/download-video/progress/:downloadId`
+     * (server-sent events) and the finished file lands in your library.
+     */
+    downloadVideo(input: {
+        url: string;
+        maxHeight?: number;
+        sectionStartSec?: number;
+        sectionEndSec?: number;
+    }): Promise<{
+        downloadId: string;
+    }>;
+    /**
+     * Copy an external media URL into your Nodaro storage (`POST /v1/save-to-storage`)
+     * — a server-side fetch, so nothing round-trips through the client. Poll
+     * `jobs.get(jobId)`.
+     */
+    saveToStorage(input: {
+        mediaUrl: string;
+        filename?: string;
+        mediaType?: "image" | "video" | "audio";
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Trim a video to a range (`POST /v1/trim-video`). Give the range in whichever
+     * unit fits: `startTime`/`endTime` seconds, `trim*Frames`, `trim*Seconds`, or
+     * `keepFirst`/`keepLastSeconds`. Poll `jobs.get(jobId)`.
+     */
+    trimVideo(input: {
+        videoUrl: string;
+        startTime?: number;
+        endTime?: number;
+        trimStartFrames?: number;
+        trimEndFrames?: number;
+        trimStartSeconds?: number;
+        trimEndSeconds?: number;
+        keepFirstSeconds?: number;
+        keepLastSeconds?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Trim (and extract) audio from a video or audio source
+     * (`POST /v1/trim-audio`) to `[startTime, endTime]` seconds, in `audioFormat`
+     * (`mp3` default / `wav` / `aac`). Poll `jobs.get(jobId)`.
+     */
+    trimAudio(input: {
+        videoUrl?: string;
+        audioUrl?: string;
+        audioFormat?: "mp3" | "wav" | "aac";
+        startTime?: number;
+        endTime?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,
+     * dimensions, title, live status — WITHOUT downloading it. A direct read, not a
+     * job. Use it to decide whether to trim before importing.
+     */
+    videoMetadata(input: {
+        url: string;
+    }): Promise<VideoMetadata>;
+}
+/** Result of {@link MediaResource.videoMetadata}. Fields are best-effort — a probe may omit some. */
+interface VideoMetadata {
+    durationSec?: number | null;
+    width?: number | null;
+    height?: number | null;
+    title?: string | null;
+    isLive?: boolean;
+    [key: string]: unknown;
+}
+
+/**
+ * Audio primitives — the building blocks Voice Changer Pro composes internally
+ * (separation, isolation, effect, mix, level), exposed standalone so a consumer
+ * can run any single step or assemble its own pipeline. Each returns a job id to
+ * poll (`jobs.get(jobId)`).
+ */
+declare class AudioResource {
+    private client;
+    constructor(client: NodaroClient);
+    /**
+     * Separate an audio track into stems (`POST /v1/audio-separation`, Demucs).
+     * `mode` `"vocal_instrumental"` (default) splits voice from music/SFX;
+     * `"stems"` returns the full drums/bass/other/… breakdown. `quality`
+     * `auto` (default) / `fast` / `best`.
+     */
+    separate(input: {
+        audioUrl: string;
+        mode?: "vocal_instrumental" | "stems";
+        quality?: "auto" | "fast" | "best";
+    }): Promise<{
+        jobId: string;
+    }>;
+    /** Isolate the primary voice and strip background noise (`POST /v1/audio-isolation`, ElevenLabs). */
+    isolate(input: {
+        audioUrl: string;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Apply a reverb / echo / telephone / megaphone effect to an audio track
+     * (`POST /v1/audio-fx`) — the same presets VCP's `voiceFx` uses, standalone.
+     * `mix` (0–100) is the reverb wet/dry; `delayMs` + `decay` drive `echo`/`custom`;
+     * `eqLow`/`eqHigh` (dB) shape telephone/megaphone.
+     */
+    applyFx(input: {
+        audioUrl: string;
+        preset?: AudioFxPreset;
+        mix?: number;
+        delayMs?: number;
+        decay?: number;
+        eqLow?: number;
+        eqHigh?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Layer multiple audio tracks into one (`POST /v1/mix-audio`). `audioUrls`
+     * (2–20) are summed; optional `trackVolumes` (0–200% each, positionally) set
+     * per-track level.
+     */
+    mix(input: {
+        audioUrls: string[];
+        trackVolumes?: number[];
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Adjust an audio (or a video's audio) level (`POST /v1/adjust-volume`):
+     * `volume` % (default 100), `normalize` to loudnorm, and `fadeIn`/`fadeOut`
+     * seconds. Provide `audioUrl` or `videoUrl`.
+     */
+    adjustVolume(input: {
+        audioUrl?: string;
+        videoUrl?: string;
+        volume?: number;
+        normalize?: boolean;
+        fadeIn?: number;
+        fadeOut?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Concatenate audio segments end-to-end (`POST /v1/combine-audio`). Each
+     * segment is a `url` with an optional `[startTime, endTime]` sub-range.
+     */
+    combine(input: {
+        segments: Array<{
+            url: string;
+            startTime?: number;
+            endTime?: number;
+        }>;
+    }): Promise<{
+        jobId: string;
+    }>;
+}
 
 /**
  * Authenticated user's credit balance — the shape of `GET /v1/user/credits`'s
@@ -4082,6 +4351,8 @@ declare class NodaroClient {
     readonly reduce: ReduceResource;
     readonly promptHelper: PromptHelperResource;
     readonly voices: VoicesResource;
+    readonly media: MediaResource;
+    readonly audio: AudioResource;
     readonly credits: CreditsResource;
     readonly uploads: UploadsResource;
     readonly library: LibraryResource;
@@ -4176,4 +4447,4 @@ interface ApiErrorBody {
 }
 declare function throwFromResponse(status: number, body: ApiErrorBody): never;
 
-export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, CommunityResource, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateProjectInput, type CreateWorkflowInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DuplicateCharacterInput, type EnhanceInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type Job, JobAbortedError, JobFailedError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type ModelCostsResult, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RotateSecretResult, type RunAndWaitOptions, type RunManyResult, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, StaticTokenAuth, StorageExceededError, type StructuredReferenceParams, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VoiceChangerProInput, type VoiceChangerProVoice, VoicesResource, type Workflow, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };
+export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, CommunityResource, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateProjectInput, type CreateWorkflowInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DubbingInput, type DuplicateCharacterInput, type EnhanceInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type Job, JobAbortedError, JobFailedError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, MediaResource, type ModelCostsResult, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RotateSecretResult, type RunAndWaitOptions, type RunManyResult, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, StaticTokenAuth, StorageExceededError, type StructuredReferenceParams, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoMetadata, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };