@ai-sdk/black-forest-labs 2.0.20 → 2.0.21

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @ai-sdk/black-forest-labs
 
+## 2.0.21
+
+### Patch Changes
+
+- 53f1bc4: Add video model support to the Black Forest Labs provider (`blackForestLabs.video`) for the FLUX 3 video model, including text-to-video, image-to-video keyframes, video continuation, draft/draft-enhance generation, and AI SDK Core polling.
+- Updated dependencies [1bec07d]
+  - @ai-sdk/provider-utils@5.0.21
+
 ## 2.0.20
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,6 @@
 # AI SDK - Black Forest Labs Provider
 
-The **[Black Forest Labs provider](https://ai-sdk.dev/providers/ai-sdk-providers/black-forest-labs)** for the [AI SDK](https://ai-sdk.dev/docs) adds image model support for the [Black Forest Labs API](https://docs.bfl.ai/).
+The **[Black Forest Labs provider](https://ai-sdk.dev/providers/ai-sdk-providers/black-forest-labs)** for the [AI SDK](https://ai-sdk.dev/docs) adds image and video model support for the [Black Forest Labs API](https://docs.bfl.ai/).
 
 > **Deploying to Vercel?** With Vercel's AI Gateway you can access Black Forest Labs (and hundreds of models from other providers) — no additional packages, API keys, or extra cost. [Get started with AI Gateway](https://vercel.com/ai-gateway).
 
@@ -45,6 +45,20 @@ fs.writeFileSync(filename, image.uint8Array);
 console.log(`Image saved to ${filename}`);
 ```
 
+## Video Generation Example
+
+```ts
+import { blackForestLabs } from '@ai-sdk/black-forest-labs';
+import { experimental_generateVideo as generateVideo } from 'ai';
+
+const { video } = await generateVideo({
+  model: blackForestLabs.video('flux-3-video'),
+  prompt: 'A white kitten chases a butterfly across a sunlit garden.',
+  aspectRatio: '16:9',
+  duration: 8,
+});
+```
+
 ## Additional Options
 
 If you want to pass additional inputs to the model besides the prompt, use the `providerOptions.blackForestLabs` property:
@@ -83,7 +97,7 @@ const blackForestLabs = createBlackForestLabs({
 
 ## Configuring Polling
 
-You can customize how often the client polls for image completion and how long it waits before timing out:
+You can customize how often the client polls for completion and how long it waits before timing out. The defaults differ by model type: 500ms / 60s for images, and 2s / 10 minutes for video.
 
 ```ts
 import { createBlackForestLabs } from '@ai-sdk/black-forest-labs';

package/dist/index.d.ts

@@ -1,10 +1,12 @@
-import { ProviderV4, ImageModelV4 } from '@ai-sdk/provider';
+import { ProviderV4, ImageModelV4, Experimental_VideoModelV4 } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { FetchFunction, InferSchema } from '@ai-sdk/provider-utils';
 
 type BlackForestLabsImageModelId = 'flux-kontext-pro' | 'flux-kontext-max' | 'flux-pro-1.1-ultra' | 'flux-pro-1.1' | 'flux-pro-1.0-fill' | (string & {});
 type BlackForestLabsAspectRatio = `${number}:${number}`;
 
+type BlackForestLabsVideoModelId = 'flux-3-video' | (string & {});
+
 interface BlackForestLabsProviderSettings {
     /**
      * Black Forest Labs API key. Default value is taken from the `BFL_API_KEY` environment variable.
@@ -24,11 +26,13 @@ interface BlackForestLabsProviderSettings {
      */
     fetch?: FetchFunction;
     /**
-     * Poll interval in milliseconds between status checks. Defaults to 500ms.
+     * Poll interval in milliseconds between status checks. Defaults to 500ms for
+     * images and 2s for video.
      */
     pollIntervalMillis?: number;
     /**
-     * Overall timeout in milliseconds for polling before giving up. Defaults to 60s.
+     * Overall timeout in milliseconds for polling before giving up. Defaults to
+     * 60s for images and 10 minutes for video.
      */
     pollTimeoutMillis?: number;
 }
@@ -41,6 +45,14 @@ interface BlackForestLabsProvider extends ProviderV4 {
      * Creates a model for image generation.
      */
     imageModel(modelId: BlackForestLabsImageModelId): ImageModelV4;
+    /**
+     * Creates a model for video generation.
+     */
+    video(modelId: BlackForestLabsVideoModelId): Experimental_VideoModelV4;
+    /**
+     * Creates a model for video generation.
+     */
+    videoModel(modelId: BlackForestLabsVideoModelId): Experimental_VideoModelV4;
     /**
      * @deprecated Use `embeddingModel` instead.
      */
@@ -77,6 +89,17 @@ declare const blackForestLabsImageModelOptionsSchema: _ai_sdk_provider_utils.Laz
 }>;
 type BlackForestLabsImageModelOptions = InferSchema<typeof blackForestLabsImageModelOptionsSchema>;
 
+declare const blackForestLabsVideoModelOptionsSchema: _ai_sdk_provider_utils.LazySchema<{
+    resolution?: "hd" | "fhd" | undefined;
+    aspectRatio?: "21:9" | "2:1" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "auto" | undefined;
+    keyframes?: string[] | [number, string][] | undefined;
+    safetyTolerance?: number | undefined;
+    draft?: boolean | undefined;
+    draftCache?: string | undefined;
+    version?: "latest" | undefined;
+}>;
+type BlackForestLabsVideoModelOptions = InferSchema<typeof blackForestLabsVideoModelOptionsSchema>;
+
 declare const VERSION: string;
 
-export { type BlackForestLabsAspectRatio, type BlackForestLabsImageModelId, type BlackForestLabsImageModelOptions, type BlackForestLabsImageModelOptions as BlackForestLabsImageProviderOptions, type BlackForestLabsProvider, type BlackForestLabsProviderSettings, VERSION, blackForestLabs, createBlackForestLabs };
+export { type BlackForestLabsAspectRatio, type BlackForestLabsImageModelId, type BlackForestLabsImageModelOptions, type BlackForestLabsImageModelOptions as BlackForestLabsImageProviderOptions, type BlackForestLabsProvider, type BlackForestLabsProviderSettings, type BlackForestLabsVideoModelId, type BlackForestLabsVideoModelOptions, VERSION, blackForestLabs, createBlackForestLabs };