feat (providers/fal): fall back to FAL_KEY for api key environment variable name (#5453)

Author: shaper

.changeset/brave-toes-sit.md

@@ -0,0 +1,5 @@
+---
+'@ai-sdk/fal': patch
+---
+
+feat (providers/fal): fall back to FAL_KEY for api key environment variable name

content/providers/01-ai-sdk-providers/10-fal.mdx

@@ -37,7 +37,7 @@ If you need a customized setup, you can import `createFal` and create a provider
 import { createFal } from '@ai-sdk/fal';
 
 const fal = createFal({
-  apiKey: 'your-api-key', // optional, defaults to FAL_API_KEY environment variable
+  apiKey: 'your-api-key', // optional, defaults to FAL_API_KEY environment variable, falling back to FAL_KEY
   baseURL: 'custom-url', // optional
   headers: {
     /* custom headers */
@@ -55,7 +55,7 @@ You can use the following optional settings to customize the Fal provider instan
 - **apiKey** _string_
 
   API key that is being sent using the `Authorization` header.
-  It defaults to the `FAL_API_KEY` environment variable.
+  It defaults to the `FAL_API_KEY` environment variable, falling back to `FAL_KEY`.
 
 - **headers** _Record<string,string>_
 

packages/fal/src/fal-provider.ts

@@ -1,13 +1,13 @@
 import { ImageModelV1, NoSuchModelError, ProviderV1 } from '@ai-sdk/provider';
 import type { FetchFunction } from '@ai-sdk/provider-utils';
-import { loadApiKey, withoutTrailingSlash } from '@ai-sdk/provider-utils';
+import { withoutTrailingSlash } from '@ai-sdk/provider-utils';
 import { FalImageModel } from './fal-image-model';
 import { FalImageModelId, FalImageSettings } from './fal-image-settings';
 
 export interface FalProviderSettings {
   /**
 fal.ai API key. Default value is taken from the `FAL_API_KEY` environment
-variable.
+variable, falling back to `FAL_KEY`.
   */
   apiKey?: string;
 
@@ -46,16 +46,55 @@ Creates a model for image generation.
 
 const defaultBaseURL = 'https://fal.run';
 
+function loadFalApiKey({
+  apiKey,
+  description = 'fal.ai',
+}: {
+  apiKey: string | undefined;
+  description?: string;
+}): string {
+  if (typeof apiKey === 'string') {
+    return apiKey;
+  }
+
+  if (apiKey != null) {
+    throw new Error(`${description} API key must be a string.`);
+  }
+
+  if (typeof process === 'undefined') {
+    throw new Error(
+      `${description} API key is missing. Pass it using the 'apiKey' parameter. Environment variables are not supported in this environment.`,
+    );
+  }
+
+  let envApiKey = process.env.FAL_API_KEY;
+  if (envApiKey == null) {
+    envApiKey = process.env.FAL_KEY;
+  }
+
+  if (envApiKey == null) {
+    throw new Error(
+      `${description} API key is missing. Pass it using the 'apiKey' parameter or set either the FAL_API_KEY or FAL_KEY environment variable.`,
+    );
+  }
+
+  if (typeof envApiKey !== 'string') {
+    throw new Error(
+      `${description} API key must be a string. The value of the environment variable is not a string.`,
+    );
+  }
+
+  return envApiKey;
+}
+
 /**
 Create a fal.ai provider instance.
  */
 export function createFal(options: FalProviderSettings = {}): FalProvider {
   const baseURL = withoutTrailingSlash(options.baseURL ?? defaultBaseURL);
   const getHeaders = () => ({
-    Authorization: `Key ${loadApiKey({
+    Authorization: `Key ${loadFalApiKey({
       apiKey: options.apiKey,
-      environmentVariableName: 'FAL_API_KEY',
-      description: 'fal.ai',
     })}`,
     ...options.headers,
   });

turbo.json

@@ -15,6 +15,7 @@
         "COHERE_API_KEY",
         "DEEPINFRA_API_KEY",
         "DEEPSEEK_API_KEY",
+        "FAL_KEY",
         "FAL_API_KEY",
         "FIREWORKS_API_KEY",
         "GOOGLE_API_KEY",