@ai-sdk/provider 4.0.6 → 4.0.8

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @ai-sdk/provider
 
+## 4.0.8
+
+### Patch Changes
+
+- 591d25b: feat: add batch completion webhooks. `experimental_startTextBatch` accepts a `webhookUrl`, and the gateway provider registers it through the batch `callbackUrl` contract and exports typed async-job metadata. Direct Anthropic and OpenAI batch providers return an unsupported warning when the option is provided.
+
+## 4.0.7
+
+### Patch Changes
+
+- ad6a650: 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`, `VideoModelV4CallOptions`, and
+  `experimental_generateVideo` is now `` `${number}:${number}` | 'adaptive' ``, so
+  those calls no longer need a type assertion. Support is provider-specific.
+
 ## 4.0.6
 
 ### Patch Changes

package/dist/index.d.ts

@@ -365,6 +365,12 @@ type BatchV4StartOptions<REQUEST> = {
     readonly providerOptions?: SharedV4ProviderOptions;
     readonly abortSignal?: AbortSignal;
     readonly headers?: Record<string, string | undefined>;
+    /**
+     * URL the provider notifies when the batch reaches a terminal state.
+     * Providers that do not support completion webhooks should return an
+     * unsupported warning.
+     */
+    readonly webhookUrl?: string;
 };
 /**
  * Result of starting a batch.
@@ -7299,11 +7305,12 @@ type VideoModelV4CallOptions = {
     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')
@@ -7750,11 +7757,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')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/provider",
-  "version": "4.0.6",
+  "version": "4.0.8",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -31,9 +31,9 @@
   "devDependencies": {
     "@types/json-schema": "7.0.15",
     "@types/node": "22.19.19",
+    "@vercel/ai-tsconfig": "0.0.0",
     "tsup": "^8.5.1",
-    "typescript": "5.8.3",
-    "@vercel/ai-tsconfig": "0.0.0"
+    "typescript": "5.8.3"
   },
   "engines": {
     "node": ">=22"

package/src/batch/v4/batch-v4.ts

@@ -40,6 +40,13 @@ export type BatchV4StartOptions<REQUEST> = {
   readonly providerOptions?: SharedV4ProviderOptions;
   readonly abortSignal?: AbortSignal;
   readonly headers?: Record<string, string | undefined>;
+
+  /**
+   * URL the provider notifies when the batch reaches a terminal state.
+   * Providers that do not support completion webhooks should return an
+   * unsupported warning.
+   */
+  readonly webhookUrl?: string;
 };
 
 /**

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.

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

@@ -16,11 +16,12 @@ export type VideoModelV4CallOptions = {
 
   /**
    * 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.