@shop-os/modelkit 0.2.14 → 0.2.15

package/dist/index.d.cts

@@ -25,10 +25,14 @@ type OutputFormat = "png" | "jpeg" | "webp";
 type MediaRef = {
     url: string;
     label?: string;
+    /** Measured length of a video/audio; the kit never measures it. */
+    durationSeconds?: number;
 } | {
     bytes: Uint8Array;
     mime: string;
     label?: string;
+    /** Measured length of a video/audio; the kit never measures it. */
+    durationSeconds?: number;
 };
 /** Caller-driven Topaz upscale controls; see the topaz row and TopazImageInput. */
 interface UpscaleOptions {
@@ -160,6 +164,16 @@ interface MediaPart {
 }
 type RequiredInput = "firstFrame" | "sourceVideo" | "references";
 type SupportedOption = "seed" | "quality" | "negativePrompt" | "cfgScale" | "generateAudio" | "promptExpansion" | "lastFrame" | "count" | "outputFormat" | "scaleFactor" | "safetySettings" | "temperature" | "upscale" | "watermark" | "safetyChecker" | "taskType" | "instrumental";
+interface VideoSecondsLimits {
+    /** Minimum length of each reference video, in seconds. */
+    min?: number;
+    /** Maximum length of each reference video, in seconds. */
+    max?: number;
+    /** Maximum combined length of the reference videos, in seconds. */
+    total?: number;
+    /** Higher per-video minimum when `taskType` is `edit` (Seedance 2.5: 4 s). */
+    editMin?: number;
+}
 interface ReferenceLimits {
     images?: number;
     /** Lower image cap when a reference video is also sent (Kling V3 Omni: 7 → 4). */
@@ -169,6 +183,8 @@ interface ReferenceLimits {
     total?: number;
     /** Provider rejects a request whose only references are audio. */
     audioOnly?: boolean;
+    /** Per-video length caps (min/max each) and combined total for reference videos. */
+    videoSeconds?: VideoSecondsLimits;
 }
 interface ModelConstraints {
     aspectRatios?: AspectRatio[];
@@ -192,6 +208,11 @@ interface ModelConstraints {
     supports?: SupportedOption[];
     /** Ratio is dropped, with a warning, when one of these inputs is present. */
     ratioIgnoredWith?: ("firstFrame" | "sourceVideo")[];
+    /** Length limits for the source video the row edits or extends. */
+    sourceVideoSeconds?: Omit<VideoSecondsLimits, "total"> & {
+        /** The provider sends the source as a reference video, so it counts toward `references.videoSeconds.total` (Seedance). */
+        inReferenceTotal?: boolean;
+    };
 }
 /** JSON-compatible value. Provider options and raw payloads carry these, never `unknown`. */
 type JsonPrimitive = string | number | boolean | null;
@@ -589,6 +610,12 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
             audios: z.ZodOptional<z.ZodNumber>;
             total: z.ZodOptional<z.ZodNumber>;
             audioOnly: z.ZodOptional<z.ZodBoolean>;
+            videoSeconds: z.ZodOptional<z.ZodObject<{
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                total: z.ZodOptional<z.ZodNumber>;
+                editMin: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
         }, z.core.$loose>>;
         requires: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             references: "references";
@@ -618,15 +645,23 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
             firstFrame: "firstFrame";
             sourceVideo: "sourceVideo";
         }>>>;
+        sourceVideoSeconds: z.ZodOptional<z.ZodObject<{
+            max: z.ZodOptional<z.ZodNumber>;
+            min: z.ZodOptional<z.ZodNumber>;
+            editMin: z.ZodOptional<z.ZodNumber>;
+            inReferenceTotal: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
     }, z.core.$loose>;
     defaults: z.ZodObject<{
         references: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         aspectRatio: z.ZodOptional<z.ZodEnum<{
             "1:1": "1:1";
@@ -681,50 +716,62 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
         firstFrame: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>;
         lastFrame: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>;
         sourceVideo: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>;
         referenceImages: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         referenceVideos: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         referenceAudios: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         resolution: z.ZodOptional<z.ZodEnum<{
             "360p": "360p";
@@ -936,6 +983,12 @@ interface ResolveResult<T> {
 }
 /** Nearest supported ratio in the same orientation bucket, else nearest overall, by log distance. */
 declare function nearestAspectRatio(requested: AspectRatio, supported: AspectRatio[]): AspectRatio;
+/** First length violation for the videos a request sends, as a user-facing message. */
+declare function videoLengthViolation(model: CatalogModel, input: {
+    referenceVideos?: (number | undefined)[];
+    sourceVideo?: number;
+    taskType?: VideoRequest["taskType"];
+}): string | undefined;
 declare function resolveImageOptions(model: CatalogModel, request: ImageRequest, onUnsupported?: OnUnsupported): ResolveResult<ImageRequest>;
 declare function resolveVideoOptions(model: CatalogModel, request: VideoRequest, onUnsupported?: OnUnsupported): ResolveResult<VideoRequest>;
 declare function resolveAudioOptions(model: CatalogModel, request: AudioRequest, onUnsupported?: OnUnsupported): ResolveResult<AudioRequest>;
@@ -1143,4 +1196,4 @@ declare function describeThrown(cause: unknown): ThrownErrorInfo;
 /** Add the AI SDK `GeneratedFile` accessors to adapter image bytes. base64 is computed on first read. */
 declare function toGeneratedImage(image: ImageBytes): GeneratedImage;
 
-export { ADAPTER_IDS, ADAPTER_KEYS, AUDIO_INPUT_SPEC_KEYS, type Adapter, type AdapterContext, type AdapterEndpoints, type AdapterId, type AdapterRegistry, type AiTextProviderOptions, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, CatalogModelSchemaBase, type CatalogOrigin, CatalogSchema, type CatalogSource, type CatalogTextModel, DEFAULT_ADAPTERS, type DataOnlyRow, type DataOnlyVerdict, type DefaultObjectOutput, type Exposure, ExposureSchema, type GeneratedImage, INPUT_SPEC_SUPPORTS_KEYS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type InputSpec, type InputSpecIssue, type InputSpecKey, InputSpecSchema, type JsonObject, JsonObjectSchema, type JsonPrimitive, type JsonValue, JsonValueSchema, type LanguageModelHandle, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKit, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, type ModelkitGenerateObjectOptions, type ModelkitGenerateTextOptions, type ModelkitStreamObjectOptions, type ModelkitStreamTextOptions, type ObjectOutput, type ObjectResult, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, type ReferenceLimits, type RequiredInput, type RequiredKeyName, type ResolveResult, type Routing, SURFACES, type SupportedOption, type Surface, SurfaceSchema, type TextMethods, type TextModelInstance, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_INPUT_SPEC_KEYS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type Warning, adapterServesType, aiSdkTextAdapter, arkAdapter, aspectRatioToSize, classifyHttpError, compareCatalogOrder, createDefaultModelKit, createModelKit, dataOnlyCapable, describe, describeThrown, generateImage as experimental_generateImage, falAdapter, fileCatalogCache, generateAudio, generateImage, generateObject, generateText, generateVideo, googleGenaiAdapter, googleImageAdapter, hasAwsCredentials, higgsfieldAdapter, isInputSpecKey, isListed, isListedOn, isModelKitError, keysFromEnv, languageModel, liveCatalog, liveState, mergeTextProviderOptions, nearestAspectRatio, normalizeExposure, openaiImageAdapter, passthroughTextModel, pollUntil, prepareMediaPart, primeCatalog, prodiaAdapter, readErrorBody, replicateAdapter, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveKeys, resolveVideoOptions, shouldRetry, sleep, sortCatalogRows, streamObject, streamText, textUsageEvent, toGeneratedImage, validateInputSpec, withRetry, xaiVideoAdapter };
+export { ADAPTER_IDS, ADAPTER_KEYS, AUDIO_INPUT_SPEC_KEYS, type Adapter, type AdapterContext, type AdapterEndpoints, type AdapterId, type AdapterRegistry, type AiTextProviderOptions, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, CatalogModelSchemaBase, type CatalogOrigin, CatalogSchema, type CatalogSource, type CatalogTextModel, DEFAULT_ADAPTERS, type DataOnlyRow, type DataOnlyVerdict, type DefaultObjectOutput, type Exposure, ExposureSchema, type GeneratedImage, INPUT_SPEC_SUPPORTS_KEYS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type InputSpec, type InputSpecIssue, type InputSpecKey, InputSpecSchema, type JsonObject, JsonObjectSchema, type JsonPrimitive, type JsonValue, JsonValueSchema, type LanguageModelHandle, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKit, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, type ModelkitGenerateObjectOptions, type ModelkitGenerateTextOptions, type ModelkitStreamObjectOptions, type ModelkitStreamTextOptions, type ObjectOutput, type ObjectResult, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, type ReferenceLimits, type RequiredInput, type RequiredKeyName, type ResolveResult, type Routing, SURFACES, type SupportedOption, type Surface, SurfaceSchema, type TextMethods, type TextModelInstance, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_INPUT_SPEC_KEYS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type VideoSecondsLimits, type Warning, adapterServesType, aiSdkTextAdapter, arkAdapter, aspectRatioToSize, classifyHttpError, compareCatalogOrder, createDefaultModelKit, createModelKit, dataOnlyCapable, describe, describeThrown, generateImage as experimental_generateImage, falAdapter, fileCatalogCache, generateAudio, generateImage, generateObject, generateText, generateVideo, googleGenaiAdapter, googleImageAdapter, hasAwsCredentials, higgsfieldAdapter, isInputSpecKey, isListed, isListedOn, isModelKitError, keysFromEnv, languageModel, liveCatalog, liveState, mergeTextProviderOptions, nearestAspectRatio, normalizeExposure, openaiImageAdapter, passthroughTextModel, pollUntil, prepareMediaPart, primeCatalog, prodiaAdapter, readErrorBody, replicateAdapter, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveKeys, resolveVideoOptions, shouldRetry, sleep, sortCatalogRows, streamObject, streamText, textUsageEvent, toGeneratedImage, validateInputSpec, videoLengthViolation, withRetry, xaiVideoAdapter };

package/dist/index.d.ts

@@ -25,10 +25,14 @@ type OutputFormat = "png" | "jpeg" | "webp";
 type MediaRef = {
     url: string;
     label?: string;
+    /** Measured length of a video/audio; the kit never measures it. */
+    durationSeconds?: number;
 } | {
     bytes: Uint8Array;
     mime: string;
     label?: string;
+    /** Measured length of a video/audio; the kit never measures it. */
+    durationSeconds?: number;
 };
 /** Caller-driven Topaz upscale controls; see the topaz row and TopazImageInput. */
 interface UpscaleOptions {
@@ -160,6 +164,16 @@ interface MediaPart {
 }
 type RequiredInput = "firstFrame" | "sourceVideo" | "references";
 type SupportedOption = "seed" | "quality" | "negativePrompt" | "cfgScale" | "generateAudio" | "promptExpansion" | "lastFrame" | "count" | "outputFormat" | "scaleFactor" | "safetySettings" | "temperature" | "upscale" | "watermark" | "safetyChecker" | "taskType" | "instrumental";
+interface VideoSecondsLimits {
+    /** Minimum length of each reference video, in seconds. */
+    min?: number;
+    /** Maximum length of each reference video, in seconds. */
+    max?: number;
+    /** Maximum combined length of the reference videos, in seconds. */
+    total?: number;
+    /** Higher per-video minimum when `taskType` is `edit` (Seedance 2.5: 4 s). */
+    editMin?: number;
+}
 interface ReferenceLimits {
     images?: number;
     /** Lower image cap when a reference video is also sent (Kling V3 Omni: 7 → 4). */
@@ -169,6 +183,8 @@ interface ReferenceLimits {
     total?: number;
     /** Provider rejects a request whose only references are audio. */
     audioOnly?: boolean;
+    /** Per-video length caps (min/max each) and combined total for reference videos. */
+    videoSeconds?: VideoSecondsLimits;
 }
 interface ModelConstraints {
     aspectRatios?: AspectRatio[];
@@ -192,6 +208,11 @@ interface ModelConstraints {
     supports?: SupportedOption[];
     /** Ratio is dropped, with a warning, when one of these inputs is present. */
     ratioIgnoredWith?: ("firstFrame" | "sourceVideo")[];
+    /** Length limits for the source video the row edits or extends. */
+    sourceVideoSeconds?: Omit<VideoSecondsLimits, "total"> & {
+        /** The provider sends the source as a reference video, so it counts toward `references.videoSeconds.total` (Seedance). */
+        inReferenceTotal?: boolean;
+    };
 }
 /** JSON-compatible value. Provider options and raw payloads carry these, never `unknown`. */
 type JsonPrimitive = string | number | boolean | null;
@@ -589,6 +610,12 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
             audios: z.ZodOptional<z.ZodNumber>;
             total: z.ZodOptional<z.ZodNumber>;
             audioOnly: z.ZodOptional<z.ZodBoolean>;
+            videoSeconds: z.ZodOptional<z.ZodObject<{
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                total: z.ZodOptional<z.ZodNumber>;
+                editMin: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
         }, z.core.$loose>>;
         requires: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             references: "references";
@@ -618,15 +645,23 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
             firstFrame: "firstFrame";
             sourceVideo: "sourceVideo";
         }>>>;
+        sourceVideoSeconds: z.ZodOptional<z.ZodObject<{
+            max: z.ZodOptional<z.ZodNumber>;
+            min: z.ZodOptional<z.ZodNumber>;
+            editMin: z.ZodOptional<z.ZodNumber>;
+            inReferenceTotal: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
     }, z.core.$loose>;
     defaults: z.ZodObject<{
         references: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         aspectRatio: z.ZodOptional<z.ZodEnum<{
             "1:1": "1:1";
@@ -681,50 +716,62 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
         firstFrame: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>;
         lastFrame: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>;
         sourceVideo: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>;
         referenceImages: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         referenceVideos: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         referenceAudios: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         resolution: z.ZodOptional<z.ZodEnum<{
             "360p": "360p";
@@ -936,6 +983,12 @@ interface ResolveResult<T> {
 }
 /** Nearest supported ratio in the same orientation bucket, else nearest overall, by log distance. */
 declare function nearestAspectRatio(requested: AspectRatio, supported: AspectRatio[]): AspectRatio;
+/** First length violation for the videos a request sends, as a user-facing message. */
+declare function videoLengthViolation(model: CatalogModel, input: {
+    referenceVideos?: (number | undefined)[];
+    sourceVideo?: number;
+    taskType?: VideoRequest["taskType"];
+}): string | undefined;
 declare function resolveImageOptions(model: CatalogModel, request: ImageRequest, onUnsupported?: OnUnsupported): ResolveResult<ImageRequest>;
 declare function resolveVideoOptions(model: CatalogModel, request: VideoRequest, onUnsupported?: OnUnsupported): ResolveResult<VideoRequest>;
 declare function resolveAudioOptions(model: CatalogModel, request: AudioRequest, onUnsupported?: OnUnsupported): ResolveResult<AudioRequest>;
@@ -1143,4 +1196,4 @@ declare function describeThrown(cause: unknown): ThrownErrorInfo;
 /** Add the AI SDK `GeneratedFile` accessors to adapter image bytes. base64 is computed on first read. */
 declare function toGeneratedImage(image: ImageBytes): GeneratedImage;
 
-export { ADAPTER_IDS, ADAPTER_KEYS, AUDIO_INPUT_SPEC_KEYS, type Adapter, type AdapterContext, type AdapterEndpoints, type AdapterId, type AdapterRegistry, type AiTextProviderOptions, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, CatalogModelSchemaBase, type CatalogOrigin, CatalogSchema, type CatalogSource, type CatalogTextModel, DEFAULT_ADAPTERS, type DataOnlyRow, type DataOnlyVerdict, type DefaultObjectOutput, type Exposure, ExposureSchema, type GeneratedImage, INPUT_SPEC_SUPPORTS_KEYS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type InputSpec, type InputSpecIssue, type InputSpecKey, InputSpecSchema, type JsonObject, JsonObjectSchema, type JsonPrimitive, type JsonValue, JsonValueSchema, type LanguageModelHandle, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKit, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, type ModelkitGenerateObjectOptions, type ModelkitGenerateTextOptions, type ModelkitStreamObjectOptions, type ModelkitStreamTextOptions, type ObjectOutput, type ObjectResult, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, type ReferenceLimits, type RequiredInput, type RequiredKeyName, type ResolveResult, type Routing, SURFACES, type SupportedOption, type Surface, SurfaceSchema, type TextMethods, type TextModelInstance, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_INPUT_SPEC_KEYS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type Warning, adapterServesType, aiSdkTextAdapter, arkAdapter, aspectRatioToSize, classifyHttpError, compareCatalogOrder, createDefaultModelKit, createModelKit, dataOnlyCapable, describe, describeThrown, generateImage as experimental_generateImage, falAdapter, fileCatalogCache, generateAudio, generateImage, generateObject, generateText, generateVideo, googleGenaiAdapter, googleImageAdapter, hasAwsCredentials, higgsfieldAdapter, isInputSpecKey, isListed, isListedOn, isModelKitError, keysFromEnv, languageModel, liveCatalog, liveState, mergeTextProviderOptions, nearestAspectRatio, normalizeExposure, openaiImageAdapter, passthroughTextModel, pollUntil, prepareMediaPart, primeCatalog, prodiaAdapter, readErrorBody, replicateAdapter, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveKeys, resolveVideoOptions, shouldRetry, sleep, sortCatalogRows, streamObject, streamText, textUsageEvent, toGeneratedImage, validateInputSpec, withRetry, xaiVideoAdapter };
+export { ADAPTER_IDS, ADAPTER_KEYS, AUDIO_INPUT_SPEC_KEYS, type Adapter, type AdapterContext, type AdapterEndpoints, type AdapterId, type AdapterRegistry, type AiTextProviderOptions, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, CatalogModelSchemaBase, type CatalogOrigin, CatalogSchema, type CatalogSource, type CatalogTextModel, DEFAULT_ADAPTERS, type DataOnlyRow, type DataOnlyVerdict, type DefaultObjectOutput, type Exposure, ExposureSchema, type GeneratedImage, INPUT_SPEC_SUPPORTS_KEYS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type InputSpec, type InputSpecIssue, type InputSpecKey, InputSpecSchema, type JsonObject, JsonObjectSchema, type JsonPrimitive, type JsonValue, JsonValueSchema, type LanguageModelHandle, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKit, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, type ModelkitGenerateObjectOptions, type ModelkitGenerateTextOptions, type ModelkitStreamObjectOptions, type ModelkitStreamTextOptions, type ObjectOutput, type ObjectResult, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, type ReferenceLimits, type RequiredInput, type RequiredKeyName, type ResolveResult, type Routing, SURFACES, type SupportedOption, type Surface, SurfaceSchema, type TextMethods, type TextModelInstance, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_INPUT_SPEC_KEYS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type VideoSecondsLimits, type Warning, adapterServesType, aiSdkTextAdapter, arkAdapter, aspectRatioToSize, classifyHttpError, compareCatalogOrder, createDefaultModelKit, createModelKit, dataOnlyCapable, describe, describeThrown, generateImage as experimental_generateImage, falAdapter, fileCatalogCache, generateAudio, generateImage, generateObject, generateText, generateVideo, googleGenaiAdapter, googleImageAdapter, hasAwsCredentials, higgsfieldAdapter, isInputSpecKey, isListed, isListedOn, isModelKitError, keysFromEnv, languageModel, liveCatalog, liveState, mergeTextProviderOptions, nearestAspectRatio, normalizeExposure, openaiImageAdapter, passthroughTextModel, pollUntil, prepareMediaPart, primeCatalog, prodiaAdapter, readErrorBody, replicateAdapter, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveKeys, resolveVideoOptions, shouldRetry, sleep, sortCatalogRows, streamObject, streamText, textUsageEvent, toGeneratedImage, validateInputSpec, videoLengthViolation, withRetry, xaiVideoAdapter };

package/dist/index.js

@@ -1373,7 +1373,8 @@ var VIDEO_MODELS = [
       // reference clip keeps its own framing.
       aspectRatios: [...OMNI_RATIOS],
       durations: [3, 4, 5, 6, 7, 8, 9, 10],
-      references: { images: 6, videos: 1 },
+      references: { images: 6, videos: 1, videoSeconds: { max: 10 } },
+      sourceVideoSeconds: { max: 10 },
       supports: []
     },
     defaults: {},
@@ -1399,7 +1400,8 @@ var VIDEO_MODELS = [
       aspectRatios: [...OMNI_RATIOS],
       resolutions: ["360p", "720p", "1080p", "4k"],
       durations: [3, 4, 5, 6, 7, 8, 9, 10],
-      references: { images: 6, videos: 1 },
+      references: { images: 6, videos: 1, videoSeconds: { max: 10 } },
+      sourceVideoSeconds: { max: 10 },
       supports: []
     },
     defaults: {},
@@ -1427,7 +1429,14 @@ var VIDEO_MODELS = [
       resolutions: ["480p", "720p", "1080p", "4k"],
       durations: { min: 4, max: 15 },
       durationPresets: [4, 6, 8, 10, 12, 15],
-      references: { images: 9, videos: 3, audios: 3, audioOnly: false },
+      references: {
+        images: 9,
+        videos: 3,
+        audios: 3,
+        audioOnly: false,
+        videoSeconds: { min: 2, max: 15, total: 15 }
+      },
+      sourceVideoSeconds: { min: 2, max: 15, inReferenceTotal: true },
       ratioIgnoredWith: ["firstFrame", "sourceVideo"],
       supports: ["generateAudio", "seed", "lastFrame", "watermark"]
     },
@@ -1459,7 +1468,14 @@ var VIDEO_MODELS = [
       aspectRatios: [...SEEDANCE_RATIOS],
       resolutions: ["480p", "720p"],
       durations: { min: 4, max: 15 },
-      references: { images: 9, videos: 3, audios: 3, audioOnly: false },
+      references: {
+        images: 9,
+        videos: 3,
+        audios: 3,
+        audioOnly: false,
+        videoSeconds: { min: 2, max: 15, total: 15 }
+      },
+      sourceVideoSeconds: { min: 2, max: 15, inReferenceTotal: true },
       ratioIgnoredWith: ["firstFrame", "sourceVideo"],
       supports: ["generateAudio", "seed", "lastFrame", "watermark"]
     },
@@ -1493,7 +1509,13 @@ var VIDEO_MODELS = [
       aspectRatios: [...SEEDANCE_RATIOS],
       resolutions: ["480p", "720p", "1080p"],
       durations: { min: 4, max: 30 },
-      references: { images: 30, videos: 10, audios: 10 },
+      references: {
+        images: 30,
+        videos: 10,
+        audios: 10,
+        videoSeconds: { min: 2, max: 30, total: 30, editMin: 4 }
+      },
+      sourceVideoSeconds: { min: 2, max: 30, editMin: 4, inReferenceTotal: true },
       ratioIgnoredWith: ["firstFrame", "sourceVideo"],
       supports: ["generateAudio", "seed", "lastFrame", "watermark", "taskType"]
     },
@@ -1705,7 +1727,14 @@ var VIDEO_MODELS = [
       aspectRatios: [...H3_REFERENCE_RATIOS],
       resolutions: ["480p", "768p", "2k", "4k"],
       durations: { min: 5, max: 15 },
-      references: { images: 9, videos: 3, audios: 3, total: 12, audioOnly: false },
+      references: {
+        images: 9,
+        videos: 3,
+        audios: 3,
+        total: 12,
+        audioOnly: false,
+        videoSeconds: { min: 2, max: 15, total: 15 }
+      },
       supports: ["seed", "promptExpansion", "safetyChecker"]
     },
     defaults: {
@@ -1736,7 +1765,14 @@ var VIDEO_MODELS = [
       aspectRatios: [...H3_REFERENCE_RATIOS],
       resolutions: ["480p", "768p"],
       durations: { min: 5, max: 15 },
-      references: { images: 9, videos: 3, audios: 3, total: 12, audioOnly: false },
+      references: {
+        images: 9,
+        videos: 3,
+        audios: 3,
+        total: 12,
+        audioOnly: false,
+        videoSeconds: { min: 2, max: 15, total: 15 }
+      },
       supports: ["seed", "promptExpansion", "safetyChecker"]
     },
     defaults: {
@@ -1768,6 +1804,7 @@ var VIDEO_MODELS = [
       aspectRatios: [...KLING_RATIOS],
       durations: { min: 3, max: 10 },
       requires: ["sourceVideo"],
+      sourceVideoSeconds: { min: 3, max: 10.05 },
       supports: []
     },
     defaults: { durationSeconds: 5, aspectRatio: "16:9" },
@@ -2127,13 +2164,20 @@ var ProviderOptionValueSchema = z2.lazy(
   ])
 );
 var ProviderOptionsSchema = z2.record(z2.string(), z2.record(z2.string(), ProviderOptionValueSchema));
+var VideoSecondsLimitsSchema = z2.looseObject({
+  min: z2.number().optional(),
+  max: z2.number().optional(),
+  total: z2.number().optional(),
+  editMin: z2.number().optional()
+});
 var ReferenceLimitsSchema = z2.looseObject({
   images: z2.number().optional(),
   imagesWithVideo: z2.number().optional(),
   videos: z2.number().optional(),
   audios: z2.number().optional(),
   total: z2.number().optional(),
-  audioOnly: z2.boolean().optional()
+  audioOnly: z2.boolean().optional(),
+  videoSeconds: VideoSecondsLimitsSchema.optional()
 });
 var ModelConstraintsSchema = z2.looseObject({
   aspectRatios: z2.array(AspectRatioSchema).optional(),
@@ -2146,14 +2190,20 @@ var ModelConstraintsSchema = z2.looseObject({
   references: ReferenceLimitsSchema.optional(),
   requires: z2.array(RequiredInputSchema).optional(),
   supports: z2.array(SupportedOptionSchema).optional(),
-  ratioIgnoredWith: z2.array(z2.enum(["firstFrame", "sourceVideo"])).optional()
+  ratioIgnoredWith: z2.array(z2.enum(["firstFrame", "sourceVideo"])).optional(),
+  sourceVideoSeconds: VideoSecondsLimitsSchema.omit({ total: true }).extend({ inReferenceTotal: z2.boolean().optional() }).optional()
 });
 var MediaRefSchema = z2.union([
-  z2.looseObject({ url: z2.string(), label: z2.string().optional() }),
+  z2.looseObject({
+    url: z2.string(),
+    label: z2.string().optional(),
+    durationSeconds: z2.number().optional()
+  }),
   z2.looseObject({
     bytes: z2.instanceof(Uint8Array),
     mime: z2.string(),
-    label: z2.string().optional()
+    label: z2.string().optional(),
+    durationSeconds: z2.number().optional()
   })
 ]);
 var ImageSafetySettingSchema = z2.looseObject({ category: z2.string(), threshold: z2.string() });
@@ -6540,8 +6590,8 @@ function lyriaAudioInput(req, ctx) {
   if (negative) input.negative_prompt = negative;
   return input;
 }
-function elevenLabsMusicDuration(seconds) {
-  return Math.min(300, Math.max(5, seconds ?? 15));
+function elevenLabsMusicDuration(seconds2) {
+  return Math.min(300, Math.max(5, seconds2 ?? 15));
 }
 function elevenLabsMusicInput(req, ctx) {
   const prompt = req.prompt.trim();
@@ -6606,9 +6656,9 @@ async function generateReplicateAudio(req, ctx, deps) {
   const { url, predictTime, raw } = await runPrediction(ctx, input, deps);
   const usage2 = audioUsage(ctx, req);
   if (ctx.model.usage.unit === "seconds") {
-    const seconds = elevenLabsMusicDuration(req.durationSeconds);
-    usage2.quantity = seconds;
-    usage2.durationSeconds = seconds;
+    const seconds2 = elevenLabsMusicDuration(req.durationSeconds);
+    usage2.quantity = seconds2;
+    usage2.durationSeconds = seconds2;
   } else {
     usage2.quantity = predictTime;
   }
@@ -7248,6 +7298,49 @@ function trim(field, refs, limit, model, warnings) {
   });
   return refs.slice(0, limit);
 }
+function knownLength(value) {
+  return value !== void 0 && Number.isFinite(value) ? value : void 0;
+}
+function seconds(len, limit) {
+  let digits = 1;
+  while (digits < 3 && Number(len.toFixed(digits)) === limit) digits++;
+  return len.toFixed(digits);
+}
+function effectiveMin(limits, taskType) {
+  if (taskType !== "edit" || limits?.editMin === void 0) return limits?.min;
+  return Math.max(limits.min ?? 0, limits.editMin);
+}
+function videoLengthViolation(model, input) {
+  const limits = model.constraints.references?.videoSeconds;
+  const refMin = effectiveMin(limits, input.taskType);
+  const lengths = (input.referenceVideos ?? []).map(knownLength);
+  if (limits?.max !== void 0) {
+    const max = limits.max;
+    const i = lengths.findIndex((len) => len !== void 0 && len > max);
+    if (i >= 0)
+      return `${model.label} takes reference videos up to ${String(max)} s each; video ${i + 1} is ${seconds(lengths[i], max)} s.`;
+  }
+  if (refMin !== void 0) {
+    const i = lengths.findIndex((len) => len !== void 0 && len < refMin);
+    if (i >= 0)
+      return `${model.label} takes reference videos of at least ${String(refMin)} s each; video ${i + 1} is ${seconds(lengths[i], refMin)} s.`;
+  }
+  const source = knownLength(input.sourceVideo);
+  const sourceLimits = model.constraints.sourceVideoSeconds;
+  if (limits?.total !== void 0) {
+    const refSum = lengths.reduce((acc, len) => acc + (len ?? 0), 0);
+    const sum = refSum + (sourceLimits?.inReferenceTotal ? source ?? 0 : 0);
+    if (sum > limits.total)
+      return `${model.label} takes reference videos up to ${String(limits.total)} s combined; these add up to ${seconds(sum, limits.total)} s.`;
+  }
+  if (source === void 0) return void 0;
+  const sourceMin = effectiveMin(sourceLimits, input.taskType);
+  if (sourceLimits?.max !== void 0 && source > sourceLimits.max)
+    return `${model.label} takes a source video up to ${String(sourceLimits.max)} s; this one is ${seconds(source, sourceLimits.max)} s.`;
+  if (sourceMin !== void 0 && source < sourceMin)
+    return `${model.label} takes a source video of at least ${String(sourceMin)} s; this one is ${seconds(source, sourceMin)} s.`;
+  return void 0;
+}
 function resolveImageOptions(model, request, onUnsupported = "error") {
   const warnings = [];
   const c = model.constraints;
@@ -7433,6 +7526,21 @@ function resolveVideoOptions(model, request, onUnsupported = "error") {
       model: model.id
     });
   }
+  const lengthViolation = videoLengthViolation(model, {
+    referenceVideos: videos.map((v) => v.durationSeconds),
+    taskType: merged.taskType,
+    ...merged.sourceVideo?.durationSeconds !== void 0 && {
+      sourceVideo: merged.sourceVideo.durationSeconds
+    }
+  });
+  if (lengthViolation !== void 0) {
+    throw new ModelKitError({
+      code: "unsupported_option",
+      message: lengthViolation,
+      model: model.id,
+      retryable: false
+    });
+  }
   setOrDelete(merged, "referenceImages", images);
   setOrDelete(merged, "referenceVideos", videos);
   setOrDelete(merged, "referenceAudios", audios);
@@ -7990,7 +8098,7 @@ function createModelKit(config, adapters) {
       promptExpansion: _promptExpansion,
       mode: _mode
     } = req;
-    const seconds = duration ?? durationSeconds;
+    const seconds2 = duration ?? durationSeconds;
     const abortSignal = combineSignals(req.abortSignal, call.signal);
     const options = { model, prompt };
     if (call.maxRetries !== void 0) options.maxRetries = call.maxRetries;
@@ -7999,7 +8107,7 @@ function createModelKit(config, adapters) {
     if (ratio) options.aspectRatio = ratio;
     else if (aspectRatio !== void 0)
       pushIgnored(warnings, "aspectRatio", aspectRatio, model.modelId);
-    if (seconds !== void 0) options.duration = seconds;
+    if (seconds2 !== void 0) options.duration = seconds2;
     if (seed !== void 0) options.seed = seed;
     if (generateAudio2 !== void 0) options.generateAudio = generateAudio2;
     const frames = [
@@ -8046,8 +8154,8 @@ function createModelKit(config, adapters) {
         provider: model.provider,
         modality: "VIDEO",
         unit: "seconds",
-        quantity: seconds ?? 0,
-        ...seconds !== void 0 && { durationSeconds: seconds }
+        quantity: seconds2 ?? 0,
+        ...seconds2 !== void 0 && { durationSeconds: seconds2 }
       };
       settled = {
         video: { bytes: result.video.uint8Array, mime: result.video.mediaType },
@@ -8397,6 +8505,7 @@ export {
   textUsageEvent,
   toGeneratedImage,
   validateInputSpec,
+  videoLengthViolation,
   withRetry,
   xaiVideoAdapter
 };