@ai-sdk/fal 2.0.18 → 2.0.20

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @ai-sdk/fal
 
+## 2.0.20
+
+### Patch Changes
+
+- 99fbed8: feat: normalize provider specific model options type names and ensure they are exported
+
+## 2.0.19
+
+### Patch Changes
+
+- 7168375: feat (ai, provider): default global provider video model resolution
+- Updated dependencies [7168375]
+  - @ai-sdk/provider@3.0.8
+  - @ai-sdk/provider-utils@4.0.14
+
 ## 2.0.18
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,6 +1,7 @@
 import { ProviderV3, ImageModelV3, TranscriptionModelV3, Experimental_VideoModelV3, SpeechModelV3 } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { FetchFunction, InferSchema } from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
 
 type FalImageModelId = 'fal-ai/aura-sr' | 'fal-ai/bria/background/remove' | 'fal-ai/bria/eraser' | 'fal-ai/bria/product-shot' | 'fal-ai/bria/reimagine' | 'bria/text-to-image/3.2' | 'fal-ai/bria/text-to-image/base' | 'fal-ai/bria/text-to-image/fast' | 'fal-ai/bria/text-to-image/hd' | 'fal-ai/bytedance/dreamina/v3.1/text-to-image' | 'fal-ai/ccsr' | 'fal-ai/clarity-upscaler' | 'fal-ai/creative-upscaler' | 'fal-ai/esrgan' | 'fal-ai/flux-general' | 'fal-ai/flux-general/differential-diffusion' | 'fal-ai/flux-general/image-to-image' | 'fal-ai/flux-general/inpainting' | 'fal-ai/flux-general/rf-inversion' | 'fal-ai/flux-kontext-lora/text-to-image' | 'fal-ai/flux-lora' | 'fal-ai/flux-lora/image-to-image' | 'fal-ai/flux-lora/inpainting' | 'fal-ai/flux-pro/kontext' | 'fal-ai/flux-pro/kontext/max' | 'fal-ai/flux-pro/v1.1' | 'fal-ai/flux-pro/v1.1-ultra' | 'fal-ai/flux-pro/v1.1-ultra-finetuned' | 'fal-ai/flux-pro/v1.1-ultra/redux' | 'fal-ai/flux-pro/v1.1/redux' | 'fal-ai/flux/dev' | 'fal-ai/flux/dev/image-to-image' | 'fal-ai/flux/dev/redux' | 'fal-ai/flux/krea' | 'fal-ai/flux/krea/image-to-image' | 'fal-ai/flux/krea/redux' | 'fal-ai/flux/schnell' | 'fal-ai/flux/schnell/redux' | 'fal-ai/ideogram/character' | 'fal-ai/ideogram/character/edit' | 'fal-ai/ideogram/character/remix' | 'fal-ai/imagen4/preview' | 'fal-ai/luma-photon' | 'fal-ai/luma-photon/flash' | 'fal-ai/object-removal' | 'fal-ai/omnigen-v2' | 'fal-ai/qwen-image' | 'fal-ai/recraft/v3/text-to-image' | 'fal-ai/recraft/v3/image-to-image' | 'fal-ai/sana/sprint' | 'fal-ai/sana/v1.5/4.8b' | 'fal-ai/sana/v1.5/1.6b' | 'fal-ai/sky-raccoon' | 'fal-ai/wan/v2.2-5b/text-to-image' | 'fal-ai/wan/v2.2-a14b/text-to-image' | 'fal-ai/fashn/tryon/v1.6' | (string & {});
 
@@ -48,6 +49,10 @@ interface FalProvider extends ProviderV3 {
      * Creates a model for video generation.
      */
     video(modelId: FalVideoModelId): Experimental_VideoModelV3;
+    /**
+     * Creates a model for video generation.
+     */
+    videoModel(modelId: FalVideoModelId): Experimental_VideoModelV3;
     /**
      * Creates a model for speech generation.
      */
@@ -66,10 +71,76 @@ declare function createFal(options?: FalProviderSettings): FalProvider;
  */
 declare const fal: FalProvider;
 
-declare const falImageProviderOptionsSchema: _ai_sdk_provider_utils.LazySchema<Record<string, unknown>>;
-type FalImageProviderOptions = InferSchema<typeof falImageProviderOptionsSchema>;
+declare const falImageModelOptionsSchema: _ai_sdk_provider_utils.LazySchema<Record<string, unknown>>;
+type FalImageModelOptions = InferSchema<typeof falImageModelOptionsSchema>;
+
+declare const falSpeechModelOptionsSchema: z.ZodObject<{
+    voice_setting: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        speed: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        vol: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        voice_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        pitch: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        english_normalization: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>;
+        emotion: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            happy: "happy";
+            sad: "sad";
+            angry: "angry";
+            fearful: "fearful";
+            disgusted: "disgusted";
+            surprised: "surprised";
+            neutral: "neutral";
+        }>>>>;
+    }, z.core.$strip>>>;
+    audio_setting: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    language_boost: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        Chinese: "Chinese";
+        "Chinese,Yue": "Chinese,Yue";
+        English: "English";
+        Arabic: "Arabic";
+        Russian: "Russian";
+        Spanish: "Spanish";
+        French: "French";
+        Portuguese: "Portuguese";
+        German: "German";
+        Turkish: "Turkish";
+        Dutch: "Dutch";
+        Ukrainian: "Ukrainian";
+        Vietnamese: "Vietnamese";
+        Indonesian: "Indonesian";
+        Japanese: "Japanese";
+        Italian: "Italian";
+        Korean: "Korean";
+        Thai: "Thai";
+        Polish: "Polish";
+        Romanian: "Romanian";
+        Greek: "Greek";
+        Czech: "Czech";
+        Finnish: "Finnish";
+        Hindi: "Hindi";
+        auto: "auto";
+    }>>>;
+    pronunciation_dict: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+}, z.core.$loose>;
+type FalSpeechModelOptions = z.infer<typeof falSpeechModelOptionsSchema>;
+
+declare const falTranscriptionModelOptionsSchema: z.ZodObject<{
+    language: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+        en: "en";
+    }>, z.ZodString]>>>>;
+    diarize: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>;
+    chunkLevel: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        segment: "segment";
+        word: "word";
+    }>>>>;
+    version: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        3: "3";
+    }>>>>;
+    batchSize: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    numSpeakers: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodNumber>>>;
+}, z.core.$strip>;
+type FalTranscriptionModelOptions = z.infer<typeof falTranscriptionModelOptionsSchema>;
 
-type FalVideoProviderOptions = {
+type FalVideoModelOptions = {
     loop?: boolean | null;
     motionStrength?: number | null;
     pollIntervalMs?: number | null;
@@ -82,4 +153,4 @@ type FalVideoProviderOptions = {
 
 declare const VERSION: string;
 
-export { type FalImageProviderOptions, type FalProvider, type FalProviderSettings, type FalVideoModelId, type FalVideoProviderOptions, VERSION, createFal, fal };
+export { type FalImageModelOptions, type FalImageModelOptions as FalImageProviderOptions, type FalProvider, type FalProviderSettings, type FalSpeechModelOptions, type FalTranscriptionModelOptions, type FalVideoModelId, type FalVideoModelOptions, type FalVideoModelOptions as FalVideoProviderOptions, VERSION, createFal, fal };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { ProviderV3, ImageModelV3, TranscriptionModelV3, Experimental_VideoModelV3, SpeechModelV3 } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { FetchFunction, InferSchema } from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
 
 type FalImageModelId = 'fal-ai/aura-sr' | 'fal-ai/bria/background/remove' | 'fal-ai/bria/eraser' | 'fal-ai/bria/product-shot' | 'fal-ai/bria/reimagine' | 'bria/text-to-image/3.2' | 'fal-ai/bria/text-to-image/base' | 'fal-ai/bria/text-to-image/fast' | 'fal-ai/bria/text-to-image/hd' | 'fal-ai/bytedance/dreamina/v3.1/text-to-image' | 'fal-ai/ccsr' | 'fal-ai/clarity-upscaler' | 'fal-ai/creative-upscaler' | 'fal-ai/esrgan' | 'fal-ai/flux-general' | 'fal-ai/flux-general/differential-diffusion' | 'fal-ai/flux-general/image-to-image' | 'fal-ai/flux-general/inpainting' | 'fal-ai/flux-general/rf-inversion' | 'fal-ai/flux-kontext-lora/text-to-image' | 'fal-ai/flux-lora' | 'fal-ai/flux-lora/image-to-image' | 'fal-ai/flux-lora/inpainting' | 'fal-ai/flux-pro/kontext' | 'fal-ai/flux-pro/kontext/max' | 'fal-ai/flux-pro/v1.1' | 'fal-ai/flux-pro/v1.1-ultra' | 'fal-ai/flux-pro/v1.1-ultra-finetuned' | 'fal-ai/flux-pro/v1.1-ultra/redux' | 'fal-ai/flux-pro/v1.1/redux' | 'fal-ai/flux/dev' | 'fal-ai/flux/dev/image-to-image' | 'fal-ai/flux/dev/redux' | 'fal-ai/flux/krea' | 'fal-ai/flux/krea/image-to-image' | 'fal-ai/flux/krea/redux' | 'fal-ai/flux/schnell' | 'fal-ai/flux/schnell/redux' | 'fal-ai/ideogram/character' | 'fal-ai/ideogram/character/edit' | 'fal-ai/ideogram/character/remix' | 'fal-ai/imagen4/preview' | 'fal-ai/luma-photon' | 'fal-ai/luma-photon/flash' | 'fal-ai/object-removal' | 'fal-ai/omnigen-v2' | 'fal-ai/qwen-image' | 'fal-ai/recraft/v3/text-to-image' | 'fal-ai/recraft/v3/image-to-image' | 'fal-ai/sana/sprint' | 'fal-ai/sana/v1.5/4.8b' | 'fal-ai/sana/v1.5/1.6b' | 'fal-ai/sky-raccoon' | 'fal-ai/wan/v2.2-5b/text-to-image' | 'fal-ai/wan/v2.2-a14b/text-to-image' | 'fal-ai/fashn/tryon/v1.6' | (string & {});
 
@@ -48,6 +49,10 @@ interface FalProvider extends ProviderV3 {
      * Creates a model for video generation.
      */
     video(modelId: FalVideoModelId): Experimental_VideoModelV3;
+    /**
+     * Creates a model for video generation.
+     */
+    videoModel(modelId: FalVideoModelId): Experimental_VideoModelV3;
     /**
      * Creates a model for speech generation.
      */
@@ -66,10 +71,76 @@ declare function createFal(options?: FalProviderSettings): FalProvider;
  */
 declare const fal: FalProvider;
 
-declare const falImageProviderOptionsSchema: _ai_sdk_provider_utils.LazySchema<Record<string, unknown>>;
-type FalImageProviderOptions = InferSchema<typeof falImageProviderOptionsSchema>;
+declare const falImageModelOptionsSchema: _ai_sdk_provider_utils.LazySchema<Record<string, unknown>>;
+type FalImageModelOptions = InferSchema<typeof falImageModelOptionsSchema>;
+
+declare const falSpeechModelOptionsSchema: z.ZodObject<{
+    voice_setting: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        speed: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        vol: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        voice_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        pitch: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        english_normalization: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>;
+        emotion: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            happy: "happy";
+            sad: "sad";
+            angry: "angry";
+            fearful: "fearful";
+            disgusted: "disgusted";
+            surprised: "surprised";
+            neutral: "neutral";
+        }>>>>;
+    }, z.core.$strip>>>;
+    audio_setting: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    language_boost: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        Chinese: "Chinese";
+        "Chinese,Yue": "Chinese,Yue";
+        English: "English";
+        Arabic: "Arabic";
+        Russian: "Russian";
+        Spanish: "Spanish";
+        French: "French";
+        Portuguese: "Portuguese";
+        German: "German";
+        Turkish: "Turkish";
+        Dutch: "Dutch";
+        Ukrainian: "Ukrainian";
+        Vietnamese: "Vietnamese";
+        Indonesian: "Indonesian";
+        Japanese: "Japanese";
+        Italian: "Italian";
+        Korean: "Korean";
+        Thai: "Thai";
+        Polish: "Polish";
+        Romanian: "Romanian";
+        Greek: "Greek";
+        Czech: "Czech";
+        Finnish: "Finnish";
+        Hindi: "Hindi";
+        auto: "auto";
+    }>>>;
+    pronunciation_dict: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+}, z.core.$loose>;
+type FalSpeechModelOptions = z.infer<typeof falSpeechModelOptionsSchema>;
+
+declare const falTranscriptionModelOptionsSchema: z.ZodObject<{
+    language: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
+        en: "en";
+    }>, z.ZodString]>>>>;
+    diarize: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>;
+    chunkLevel: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        segment: "segment";
+        word: "word";
+    }>>>>;
+    version: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        3: "3";
+    }>>>>;
+    batchSize: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    numSpeakers: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodNumber>>>;
+}, z.core.$strip>;
+type FalTranscriptionModelOptions = z.infer<typeof falTranscriptionModelOptionsSchema>;
 
-type FalVideoProviderOptions = {
+type FalVideoModelOptions = {
     loop?: boolean | null;
     motionStrength?: number | null;
     pollIntervalMs?: number | null;
@@ -82,4 +153,4 @@ type FalVideoProviderOptions = {
 
 declare const VERSION: string;
 
-export { type FalImageProviderOptions, type FalProvider, type FalProviderSettings, type FalVideoModelId, type FalVideoProviderOptions, VERSION, createFal, fal };
+export { type FalImageModelOptions, type FalImageModelOptions as FalImageProviderOptions, type FalProvider, type FalProviderSettings, type FalSpeechModelOptions, type FalTranscriptionModelOptions, type FalVideoModelId, type FalVideoModelOptions, type FalVideoModelOptions as FalVideoProviderOptions, VERSION, createFal, fal };

package/dist/index.js

@@ -37,7 +37,7 @@ var import_v42 = require("zod/v4");
 // src/fal-image-options.ts
 var import_provider_utils = require("@ai-sdk/provider-utils");
 var import_v4 = require("zod/v4");
-var falImageProviderOptionsSchema = (0, import_provider_utils.lazySchema)(
+var falImageModelOptionsSchema = (0, import_provider_utils.lazySchema)(
   () => (0, import_provider_utils.zodSchema)(
     import_v4.z.object({
       /** @deprecated use prompt.images instead */
@@ -165,7 +165,7 @@ var FalImageModel = class {
     const falOptions = await (0, import_provider_utils2.parseProviderOptions)({
       provider: "fal",
       providerOptions,
-      schema: falImageProviderOptionsSchema
+      schema: falImageModelOptionsSchema
     });
     const requestBody = {
       prompt,
@@ -422,7 +422,7 @@ var falFailedResponseHandler2 = (0, import_provider_utils3.createJsonErrorRespon
 });
 
 // src/fal-transcription-model.ts
-var falProviderOptionsSchema = import_v44.z.object({
+var falTranscriptionModelOptionsSchema = import_v44.z.object({
   /**
    * Language of the audio file. If set to null, the language will be automatically detected. Defaults to null.
    *
@@ -467,7 +467,7 @@ var FalTranscriptionModel = class {
     const falOptions = await (0, import_provider_utils4.parseProviderOptions)({
       provider: "fal",
       providerOptions,
-      schema: falProviderOptionsSchema
+      schema: falTranscriptionModelOptionsSchema
     });
     const body = {
       task: "transcribe",
@@ -653,7 +653,7 @@ var FAL_EMOTIONS = [
 ];
 
 // src/fal-speech-model.ts
-var falSpeechProviderOptionsSchema = import_v45.z.looseObject({
+var falSpeechModelOptionsSchema = import_v45.z.looseObject({
   voice_setting: import_v45.z.object({
     speed: import_v45.z.number().nullish(),
     vol: import_v45.z.number().nullish(),
@@ -687,7 +687,7 @@ var FalSpeechModel = class {
     const falOptions = await (0, import_provider_utils5.parseProviderOptions)({
       provider: "fal",
       providerOptions,
-      schema: falSpeechProviderOptionsSchema
+      schema: falSpeechModelOptionsSchema
     });
     const requestBody = {
       text,
@@ -767,7 +767,7 @@ var falSpeechResponseSchema = import_v45.z.object({
 var import_provider2 = require("@ai-sdk/provider");
 var import_provider_utils6 = require("@ai-sdk/provider-utils");
 var import_v46 = require("zod/v4");
-var falVideoProviderOptionsSchema = (0, import_provider_utils6.lazySchema)(
+var falVideoModelOptionsSchema = (0, import_provider_utils6.lazySchema)(
   () => (0, import_provider_utils6.zodSchema)(
     import_v46.z.object({
       // Video loop - only for Luma models
@@ -806,7 +806,7 @@ var FalVideoModel = class {
     const falOptions = await (0, import_provider_utils6.parseProviderOptions)({
       provider: "fal",
       providerOptions: options.providerOptions,
-      schema: falVideoProviderOptionsSchema
+      schema: falVideoModelOptionsSchema
     });
     const body = {};
     if (options.prompt != null) {
@@ -1002,7 +1002,7 @@ var falVideoResponseSchema = import_v46.z.object({
 });
 
 // src/version.ts
-var VERSION = true ? "2.0.18" : "0.0.0-test";
+var VERSION = true ? "2.0.20" : "0.0.0-test";
 
 // src/fal-provider.ts
 var defaultBaseURL = "https://fal.run";
@@ -1083,7 +1083,6 @@ function createFal(options = {}) {
     specificationVersion: "v3",
     imageModel: createImageModel,
     image: createImageModel,
-    video: createVideoModel,
     languageModel: (modelId) => {
       throw new import_provider3.NoSuchModelError({
         modelId,
@@ -1093,7 +1092,9 @@ function createFal(options = {}) {
     speech: createSpeechModel,
     embeddingModel,
     textEmbeddingModel: embeddingModel,
-    transcription: createTranscriptionModel
+    transcription: createTranscriptionModel,
+    video: createVideoModel,
+    videoModel: createVideoModel
   };
 }
 var fal = createFal();