@ai-sdk/provider 3.0.13 → 3.0.15

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @ai-sdk/provider
 
+## 3.0.15
+
+### Patch Changes
+
+- 2171d15: feat(video): allow `aspectRatio: 'adaptive'` on `generateVideo`
+
+  Some video models derive the output ratio from the input and reject explicit
+  `{width}:{height}` values — BytePlus Seedance 2.5 does this for first-frame,
+  first-and-last-frame, editing, and extension tasks. `aspectRatio` on
+  `VideoModelV3CallOptions`, and
+  `experimental_generateVideo` is now `` `${number}:${number}` | 'adaptive' ``, so
+  those calls no longer need a type assertion. Support is provider-specific.
+
+## 3.0.14
+
+### Patch Changes
+
+- e1af05f: feat (video): support video (not just image) reference inputs in `inputReferences` for reference-to-video generation
+
 ## 3.0.13
 
 ### Patch Changes

package/dist/index.d.mts

@@ -3837,6 +3837,12 @@ type VideoModelV3File = {
      * The URL of the video or image file.
      */
     url: string;
+    /**
+     * The media type of the referenced file, when known.
+     * Video types: 'video/mp4', 'video/webm', 'video/quicktime'
+     * Image types: 'image/png', 'image/jpeg', 'image/webp'
+     */
+    mediaType?: string;
     /**
      * Optional provider-specific metadata for the file part.
      */
@@ -3876,11 +3882,12 @@ type VideoModelV3CallOptions = {
     n: number;
     /**
      * Aspect ratio of the videos to generate.
-     * Must have the format `{width}:{height}`.
+     * Must have the format `{width}:{height}`, or `'adaptive'` to inherit the
+     * ratio from the input media.
      * `undefined` will use the provider's default aspect ratio.
      * Common values: '16:9', '9:16', '1:1', '21:9', '4:3'
      */
-    aspectRatio: `${number}:${number}` | undefined;
+    aspectRatio: `${number}:${number}` | 'adaptive' | undefined;
     /**
      * Resolution of the video to generate.
      * Format: `{width}x{height}` (e.g., '1280x720', '1920x1080')
@@ -3916,7 +3923,11 @@ type VideoModelV3CallOptions = {
      */
     frameImages: Array<VideoModelV3FrameImage> | undefined;
     /**
-     * Reference image inputs for reference-to-video generation.
+     * Reference inputs for reference-to-video generation.
+     *
+     * Each entry is an image or video file. Providers route each reference by
+     * its media type (image vs. video) and warn when a reference kind is
+     * unsupported.
      */
     inputReferences: Array<VideoModelV3File> | undefined;
     /**

package/dist/index.d.ts

@@ -3837,6 +3837,12 @@ type VideoModelV3File = {
      * The URL of the video or image file.
      */
     url: string;
+    /**
+     * The media type of the referenced file, when known.
+     * Video types: 'video/mp4', 'video/webm', 'video/quicktime'
+     * Image types: 'image/png', 'image/jpeg', 'image/webp'
+     */
+    mediaType?: string;
     /**
      * Optional provider-specific metadata for the file part.
      */
@@ -3876,11 +3882,12 @@ type VideoModelV3CallOptions = {
     n: number;
     /**
      * Aspect ratio of the videos to generate.
-     * Must have the format `{width}:{height}`.
+     * Must have the format `{width}:{height}`, or `'adaptive'` to inherit the
+     * ratio from the input media.
      * `undefined` will use the provider's default aspect ratio.
      * Common values: '16:9', '9:16', '1:1', '21:9', '4:3'
      */
-    aspectRatio: `${number}:${number}` | undefined;
+    aspectRatio: `${number}:${number}` | 'adaptive' | undefined;
     /**
      * Resolution of the video to generate.
      * Format: `{width}x{height}` (e.g., '1280x720', '1920x1080')
@@ -3916,7 +3923,11 @@ type VideoModelV3CallOptions = {
      */
     frameImages: Array<VideoModelV3FrameImage> | undefined;
     /**
-     * Reference image inputs for reference-to-video generation.
+     * Reference inputs for reference-to-video generation.
+     *
+     * Each entry is an image or video file. Providers route each reference by
+     * its media type (image vs. video) and warn when a reference kind is
+     * unsupported.
      */
     inputReferences: Array<VideoModelV3File> | undefined;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/provider",
-  "version": "3.0.13",
+  "version": "3.0.15",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",

package/src/video-model/v3/video-model-v3-call-options.ts

@@ -16,11 +16,12 @@ export type VideoModelV3CallOptions = {
 
   /**
    * Aspect ratio of the videos to generate.
-   * Must have the format `{width}:{height}`.
+   * Must have the format `{width}:{height}`, or `'adaptive'` to inherit the
+   * ratio from the input media.
    * `undefined` will use the provider's default aspect ratio.
    * Common values: '16:9', '9:16', '1:1', '21:9', '4:3'
    */
-  aspectRatio: `${number}:${number}` | undefined;
+  aspectRatio: `${number}:${number}` | 'adaptive' | undefined;
 
   /**
    * Resolution of the video to generate.
@@ -63,7 +64,11 @@ export type VideoModelV3CallOptions = {
   frameImages: Array<VideoModelV3FrameImage> | undefined;
 
   /**
-   * Reference image inputs for reference-to-video generation.
+   * Reference inputs for reference-to-video generation.
+   *
+   * Each entry is an image or video file. Providers route each reference by
+   * its media type (image vs. video) and warn when a reference kind is
+   * unsupported.
    */
   inputReferences: Array<VideoModelV3File> | undefined;
 

package/src/video-model/v3/video-model-v3-file.ts

@@ -33,6 +33,13 @@ export type VideoModelV3File =
        */
       url: string;
 
+      /**
+       * The media type of the referenced file, when known.
+       * Video types: 'video/mp4', 'video/webm', 'video/quicktime'
+       * Image types: 'image/png', 'image/jpeg', 'image/webp'
+       */
+      mediaType?: string;
+
       /**
        * Optional provider-specific metadata for the file part.
        */