@ai-sdk/fal 3.0.0-beta.3 → 3.0.0-beta.30

package/src/fal-provider.ts

@@ -1,24 +1,24 @@
 import {
-  Experimental_VideoModelV3,
-  ImageModelV3,
   NoSuchModelError,
-  ProviderV3,
-  SpeechModelV3,
-  TranscriptionModelV3,
+  type Experimental_VideoModelV4,
+  type ImageModelV4,
+  type ProviderV4,
+  type SpeechModelV4,
+  type TranscriptionModelV4,
 } from '@ai-sdk/provider';
-import type { FetchFunction } from '@ai-sdk/provider-utils';
 import {
   withoutTrailingSlash,
   withUserAgentSuffix,
+  type FetchFunction,
 } from '@ai-sdk/provider-utils';
 import { FalImageModel } from './fal-image-model';
-import { FalImageModelId } from './fal-image-settings';
-import { FalTranscriptionModelId } from './fal-transcription-options';
+import type { FalImageModelId } from './fal-image-settings';
+import type { FalTranscriptionModelId } from './fal-transcription-options';
 import { FalTranscriptionModel } from './fal-transcription-model';
-import { FalSpeechModelId } from './fal-speech-settings';
+import type { FalSpeechModelId } from './fal-speech-settings';
 import { FalSpeechModel } from './fal-speech-model';
 import { FalVideoModel } from './fal-video-model';
-import { FalVideoModelId } from './fal-video-settings';
+import type { FalVideoModelId } from './fal-video-settings';
 import { VERSION } from './version';
 
 export interface FalProviderSettings {
@@ -46,36 +46,36 @@ export interface FalProviderSettings {
   fetch?: FetchFunction;
 }
 
-export interface FalProvider extends ProviderV3 {
+export interface FalProvider extends ProviderV4 {
   /**
    * Creates a model for image generation.
    */
-  image(modelId: FalImageModelId): ImageModelV3;
+  image(modelId: FalImageModelId): ImageModelV4;
 
   /**
    * Creates a model for image generation.
    */
-  imageModel(modelId: FalImageModelId): ImageModelV3;
+  imageModel(modelId: FalImageModelId): ImageModelV4;
 
   /**
    * Creates a model for transcription.
    */
-  transcription(modelId: FalTranscriptionModelId): TranscriptionModelV3;
+  transcription(modelId: FalTranscriptionModelId): TranscriptionModelV4;
 
   /**
    * Creates a model for video generation.
    */
-  video(modelId: FalVideoModelId): Experimental_VideoModelV3;
+  video(modelId: FalVideoModelId): Experimental_VideoModelV4;
 
   /**
    * Creates a model for video generation.
    */
-  videoModel(modelId: FalVideoModelId): Experimental_VideoModelV3;
+  videoModel(modelId: FalVideoModelId): Experimental_VideoModelV4;
 
   /**
    * Creates a model for speech generation.
    */
-  speech(modelId: FalSpeechModelId): SpeechModelV3;
+  speech(modelId: FalSpeechModelId): SpeechModelV4;
 
   /**
    * @deprecated Use `embeddingModel` instead.
@@ -182,7 +182,7 @@ export function createFal(options: FalProviderSettings = {}): FalProvider {
   };
 
   return {
-    specificationVersion: 'v3' as const,
+    specificationVersion: 'v4' as const,
     imageModel: createImageModel,
     image: createImageModel,
     languageModel: (modelId: string) => {

package/src/fal-speech-model.ts

@@ -1,4 +1,4 @@
-import { SpeechModelV3, SharedV3Warning } from '@ai-sdk/provider';
+import type { SpeechModelV4, SharedV4Warning } from '@ai-sdk/provider';
 import {
   combineHeaders,
   createBinaryResponseHandler,
@@ -7,12 +7,15 @@ import {
   getFromApi,
   parseProviderOptions,
   postJsonToApi,
+  serializeModelOptions,
+  WORKFLOW_SERIALIZE,
+  WORKFLOW_DESERIALIZE,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
-import { FalConfig } from './fal-config';
+import type { FalConfig } from './fal-config';
 import { falFailedResponseHandler } from './fal-error';
 import { FAL_EMOTIONS, FAL_LANGUAGE_BOOSTS } from './fal-api-types';
-import { FalSpeechModelId } from './fal-speech-settings';
+import type { FalSpeechModelId } from './fal-speech-settings';
 
 const falSpeechModelOptionsSchema = z.looseObject({
   voice_setting: z
@@ -39,13 +42,27 @@ interface FalSpeechModelConfig extends FalConfig {
   };
 }
 
-export class FalSpeechModel implements SpeechModelV3 {
-  readonly specificationVersion = 'v3';
+export class FalSpeechModel implements SpeechModelV4 {
+  readonly specificationVersion = 'v4';
 
   get provider(): string {
     return this.config.provider;
   }
 
+  static [WORKFLOW_SERIALIZE](model: FalSpeechModel) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config,
+    });
+  }
+
+  static [WORKFLOW_DESERIALIZE](options: {
+    modelId: FalSpeechModelId;
+    config: FalSpeechModelConfig;
+  }) {
+    return new FalSpeechModel(options.modelId, options.config);
+  }
+
   constructor(
     readonly modelId: FalSpeechModelId,
     private readonly config: FalSpeechModelConfig,
@@ -58,8 +75,8 @@ export class FalSpeechModel implements SpeechModelV3 {
     speed,
     language,
     providerOptions,
-  }: Parameters<SpeechModelV3['doGenerate']>[0]) {
-    const warnings: SharedV3Warning[] = [];
+  }: Parameters<SpeechModelV4['doGenerate']>[0]) {
+    const warnings: SharedV4Warning[] = [];
 
     const falOptions = await parseProviderOptions({
       provider: 'fal',
@@ -98,8 +115,8 @@ export class FalSpeechModel implements SpeechModelV3 {
   }
 
   async doGenerate(
-    options: Parameters<SpeechModelV3['doGenerate']>[0],
-  ): Promise<Awaited<ReturnType<SpeechModelV3['doGenerate']>>> {
+    options: Parameters<SpeechModelV4['doGenerate']>[0],
+  ): Promise<Awaited<ReturnType<SpeechModelV4['doGenerate']>>> {
     const currentDate = this.config._internal?.currentDate?.() ?? new Date();
     const { requestBody, warnings } = await this.getArgs(options);
 
@@ -112,7 +129,7 @@ export class FalSpeechModel implements SpeechModelV3 {
         path: `https://fal.run/${this.modelId}`,
         modelId: this.modelId,
       }),
-      headers: combineHeaders(this.config.headers(), options.headers),
+      headers: combineHeaders(this.config.headers?.(), options.headers),
       body: requestBody,
       failedResponseHandler: falFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(

package/src/fal-transcription-model.ts

@@ -1,7 +1,7 @@
 import {
   AISDKError,
-  TranscriptionModelV3,
-  SharedV3Warning,
+  type TranscriptionModelV4,
+  type SharedV4Warning,
 } from '@ai-sdk/provider';
 import {
   combineHeaders,
@@ -12,12 +12,15 @@ import {
   getFromApi,
   parseProviderOptions,
   postJsonToApi,
+  serializeModelOptions,
+  WORKFLOW_SERIALIZE,
+  WORKFLOW_DESERIALIZE,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
-import { FalConfig } from './fal-config';
+import type { FalConfig } from './fal-config';
 import { falErrorDataSchema, falFailedResponseHandler } from './fal-error';
-import { FalTranscriptionModelId } from './fal-transcription-options';
-import { FalTranscriptionAPITypes } from './fal-api-types';
+import type { FalTranscriptionModelId } from './fal-transcription-options';
+import type { FalTranscriptionAPITypes } from './fal-api-types';
 
 // https://fal.ai/models/fal-ai/whisper/api?platform=http
 const falTranscriptionModelOptionsSchema = z.object({
@@ -67,13 +70,27 @@ interface FalTranscriptionModelConfig extends FalConfig {
   };
 }
 
-export class FalTranscriptionModel implements TranscriptionModelV3 {
-  readonly specificationVersion = 'v3';
+export class FalTranscriptionModel implements TranscriptionModelV4 {
+  readonly specificationVersion = 'v4';
 
   get provider(): string {
     return this.config.provider;
   }
 
+  static [WORKFLOW_SERIALIZE](model: FalTranscriptionModel) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config,
+    });
+  }
+
+  static [WORKFLOW_DESERIALIZE](options: {
+    modelId: FalTranscriptionModelId;
+    config: FalTranscriptionModelConfig;
+  }) {
+    return new FalTranscriptionModel(options.modelId, options.config);
+  }
+
   constructor(
     readonly modelId: FalTranscriptionModelId,
     private readonly config: FalTranscriptionModelConfig,
@@ -81,8 +98,8 @@ export class FalTranscriptionModel implements TranscriptionModelV3 {
 
   private async getArgs({
     providerOptions,
-  }: Parameters<TranscriptionModelV3['doGenerate']>[0]) {
-    const warnings: SharedV3Warning[] = [];
+  }: Parameters<TranscriptionModelV4['doGenerate']>[0]) {
+    const warnings: SharedV4Warning[] = [];
 
     // Parse provider options
     const falOptions = await parseProviderOptions({
@@ -121,8 +138,8 @@ export class FalTranscriptionModel implements TranscriptionModelV3 {
   }
 
   async doGenerate(
-    options: Parameters<TranscriptionModelV3['doGenerate']>[0],
-  ): Promise<Awaited<ReturnType<TranscriptionModelV3['doGenerate']>>> {
+    options: Parameters<TranscriptionModelV4['doGenerate']>[0],
+  ): Promise<Awaited<ReturnType<TranscriptionModelV4['doGenerate']>>> {
     const currentDate = this.config._internal?.currentDate?.() ?? new Date();
     const { body, warnings } = await this.getArgs(options);
 
@@ -138,7 +155,7 @@ export class FalTranscriptionModel implements TranscriptionModelV3 {
         path: `https://queue.fal.run/fal-ai/${this.modelId}`,
         modelId: this.modelId,
       }),
-      headers: combineHeaders(this.config.headers(), options.headers),
+      headers: combineHeaders(this.config.headers?.(), options.headers),
       body: {
         ...body,
         audio_url: audioUrl,
@@ -170,7 +187,7 @@ export class FalTranscriptionModel implements TranscriptionModelV3 {
             path: `https://queue.fal.run/fal-ai/${this.modelId}/requests/${queueResponse.request_id}`,
             modelId: this.modelId,
           }),
-          headers: combineHeaders(this.config.headers(), options.headers),
+          headers: combineHeaders(this.config.headers?.(), options.headers),
           failedResponseHandler: async ({
             requestBodyValues,
             response,

package/src/fal-video-model.ts

@@ -1,7 +1,7 @@
 import {
   AISDKError,
-  type Experimental_VideoModelV3,
-  type SharedV3Warning,
+  type Experimental_VideoModelV4,
+  type SharedV4Warning,
 } from '@ai-sdk/provider';
 import {
   combineHeaders,
@@ -63,8 +63,8 @@ interface FalVideoModelConfig extends FalConfig {
   };
 }
 
-export class FalVideoModel implements Experimental_VideoModelV3 {
-  readonly specificationVersion = 'v3';
+export class FalVideoModel implements Experimental_VideoModelV4 {
+  readonly specificationVersion = 'v4';
   readonly maxVideosPerCall = 1; // FAL video models support 1 video at a time
 
   get provider(): string {
@@ -81,10 +81,10 @@ export class FalVideoModel implements Experimental_VideoModelV3 {
   ) {}
 
   async doGenerate(
-    options: Parameters<Experimental_VideoModelV3['doGenerate']>[0],
-  ): Promise<Awaited<ReturnType<Experimental_VideoModelV3['doGenerate']>>> {
+    options: Parameters<Experimental_VideoModelV4['doGenerate']>[0],
+  ): Promise<Awaited<ReturnType<Experimental_VideoModelV4['doGenerate']>>> {
     const currentDate = this.config._internal?.currentDate?.() ?? new Date();
-    const warnings: SharedV3Warning[] = [];
+    const warnings: SharedV4Warning[] = [];
 
     const falOptions = (await parseProviderOptions({
       provider: 'fal',
@@ -158,7 +158,7 @@ export class FalVideoModel implements Experimental_VideoModelV3 {
         path: `https://queue.fal.run/fal-ai/${this.normalizedModelId}`,
         modelId: this.modelId,
       }),
-      headers: combineHeaders(this.config.headers(), options.headers),
+      headers: combineHeaders(this.config.headers?.(), options.headers),
       body,
       failedResponseHandler: falFailedResponseHandler,
       successfulResponseHandler:
@@ -189,7 +189,7 @@ export class FalVideoModel implements Experimental_VideoModelV3 {
               path: responseUrl,
               modelId: this.modelId,
             }),
-            headers: combineHeaders(this.config.headers(), options.headers),
+            headers: combineHeaders(this.config.headers?.(), options.headers),
             failedResponseHandler: async ({
               response,
               url,

package/dist/index.d.mts

@@ -1,156 +0,0 @@
-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 & {});
-
-type FalTranscriptionModelId = 'whisper' | 'wizper' | (string & {});
-
-type FalSpeechModelId = 'fal-ai/minimax/voice-clone' | 'fal-ai/minimax/voice-design' | 'fal-ai/dia-tts/voice-clone' | 'fal-ai/minimax/speech-02-hd' | 'fal-ai/minimax/speech-02-turbo' | 'fal-ai/dia-tts' | 'resemble-ai/chatterboxhd/text-to-speech' | (string & {});
-
-type FalVideoModelId = 'luma-dream-machine' | 'luma-ray-2' | 'luma-ray-2-flash' | 'minimax-video' | 'minimax-video-01' | 'hunyuan-video' | (string & {});
-
-interface FalProviderSettings {
-    /**
-     * fal.ai API key. Default value is taken from the `FAL_API_KEY` environment
-     * variable, falling back to `FAL_KEY`.
-     */
-    apiKey?: string;
-    /**
-     * Base URL for the API calls.
-     * The default prefix is `https://fal.run`.
-     */
-    baseURL?: string;
-    /**
-     * Custom headers to include in the requests.
-     */
-    headers?: Record<string, string>;
-    /**
-     * Custom fetch implementation. You can use it as a middleware to intercept
-     * requests, or to provide a custom fetch implementation for e.g. testing.
-     */
-    fetch?: FetchFunction;
-}
-interface FalProvider extends ProviderV3 {
-    /**
-     * Creates a model for image generation.
-     */
-    image(modelId: FalImageModelId): ImageModelV3;
-    /**
-     * Creates a model for image generation.
-     */
-    imageModel(modelId: FalImageModelId): ImageModelV3;
-    /**
-     * Creates a model for transcription.
-     */
-    transcription(modelId: FalTranscriptionModelId): TranscriptionModelV3;
-    /**
-     * 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.
-     */
-    speech(modelId: FalSpeechModelId): SpeechModelV3;
-    /**
-     * @deprecated Use `embeddingModel` instead.
-     */
-    textEmbeddingModel(modelId: string): never;
-}
-/**
- * Create a fal.ai provider instance.
- */
-declare function createFal(options?: FalProviderSettings): FalProvider;
-/**
- * Default fal.ai provider instance.
- */
-declare const fal: FalProvider;
-
-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 FalVideoModelOptions = {
-    loop?: boolean | null;
-    motionStrength?: number | null;
-    pollIntervalMs?: number | null;
-    pollTimeoutMs?: number | null;
-    resolution?: string | null;
-    negativePrompt?: string | null;
-    promptOptimizer?: boolean | null;
-    [key: string]: unknown;
-};
-
-declare const VERSION: string;
-
-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 };