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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,231 @@
1
1
  # @ai-sdk/fal
2
2
 
3
+ ## 3.0.0-beta.30
4
+
5
+ ### Patch Changes
6
+
7
+ - 258c093: chore: ensure consistent import handling and avoid import duplicates or cycles
8
+ - Updated dependencies [9bd6512]
9
+ - Updated dependencies [258c093]
10
+ - Updated dependencies [b6783da]
11
+ - @ai-sdk/provider-utils@5.0.0-beta.29
12
+ - @ai-sdk/provider@4.0.0-beta.14
13
+
14
+ ## 3.0.0-beta.29
15
+
16
+ ### Patch Changes
17
+
18
+ - 9f0e36c: trigger release for all packages after provenance setup
19
+ - Updated dependencies [9f0e36c]
20
+ - @ai-sdk/provider@4.0.0-beta.13
21
+ - @ai-sdk/provider-utils@5.0.0-beta.28
22
+
23
+ ## 3.0.0-beta.28
24
+
25
+ ### Patch Changes
26
+
27
+ - Updated dependencies [785fe16]
28
+ - Updated dependencies [67df0a0]
29
+ - Updated dependencies [befb78c]
30
+ - Updated dependencies [0458559]
31
+ - Updated dependencies [5852c0a]
32
+ - Updated dependencies [fc92055]
33
+ - @ai-sdk/provider-utils@5.0.0-beta.27
34
+
35
+ ## 3.0.0-beta.27
36
+
37
+ ### Patch Changes
38
+
39
+ - Updated dependencies [2e98477]
40
+ - @ai-sdk/provider-utils@5.0.0-beta.26
41
+
42
+ ## 3.0.0-beta.26
43
+
44
+ ### Patch Changes
45
+
46
+ - Updated dependencies [eea8d98]
47
+ - @ai-sdk/provider-utils@5.0.0-beta.25
48
+
49
+ ## 3.0.0-beta.25
50
+
51
+ ### Patch Changes
52
+
53
+ - Updated dependencies [f807e45]
54
+ - @ai-sdk/provider-utils@5.0.0-beta.24
55
+
56
+ ## 3.0.0-beta.24
57
+
58
+ ### Patch Changes
59
+
60
+ - Updated dependencies [350ea38]
61
+ - @ai-sdk/provider-utils@5.0.0-beta.23
62
+
63
+ ## 3.0.0-beta.23
64
+
65
+ ### Patch Changes
66
+
67
+ - Updated dependencies [083947b]
68
+ - @ai-sdk/provider-utils@5.0.0-beta.22
69
+
70
+ ## 3.0.0-beta.22
71
+
72
+ ### Patch Changes
73
+
74
+ - Updated dependencies [add1126]
75
+ - @ai-sdk/provider-utils@5.0.0-beta.21
76
+
77
+ ## 3.0.0-beta.21
78
+
79
+ ### Patch Changes
80
+
81
+ - b3976a2: Add workflow serialization support to all provider models.
82
+
83
+ **`@ai-sdk/provider-utils`:** New `serializeModel()` helper that extracts only serializable properties from a model instance, filtering out functions and objects containing functions. Third-party provider authors can use this to add workflow support to their own models.
84
+
85
+ **All providers:** `headers` is now optional in provider config types. This is non-breaking — existing code that passes `headers` continues to work. Custom provider implementations that construct model configs manually can now omit `headers`, which is useful when models are deserialized from a workflow step boundary where auth is provided separately.
86
+
87
+ All provider model classes now include `WORKFLOW_SERIALIZE` and `WORKFLOW_DESERIALIZE` static methods, enabling them to cross workflow step boundaries without serialization errors.
88
+
89
+ - Updated dependencies [b3976a2]
90
+ - Updated dependencies [ff5eba1]
91
+ - @ai-sdk/provider-utils@5.0.0-beta.20
92
+ - @ai-sdk/provider@4.0.0-beta.12
93
+
94
+ ## 3.0.0-beta.20
95
+
96
+ ### Major Changes
97
+
98
+ - ef992f8: Remove CommonJS exports from all packages. All packages are now ESM-only (`"type": "module"`). Consumers using `require()` must switch to ESM `import` syntax.
99
+
100
+ ### Patch Changes
101
+
102
+ - Updated dependencies [ef992f8]
103
+ - @ai-sdk/provider@4.0.0-beta.11
104
+ - @ai-sdk/provider-utils@5.0.0-beta.19
105
+
106
+ ## 3.0.0-beta.19
107
+
108
+ ### Patch Changes
109
+
110
+ - 90e2d8a: chore: fix unused vars not being flagged by our lint tooling
111
+ - Updated dependencies [90e2d8a]
112
+ - @ai-sdk/provider-utils@5.0.0-beta.18
113
+
114
+ ## 3.0.0-beta.18
115
+
116
+ ### Patch Changes
117
+
118
+ - Updated dependencies [3ae1786]
119
+ - @ai-sdk/provider-utils@5.0.0-beta.17
120
+
121
+ ## 3.0.0-beta.17
122
+
123
+ ### Patch Changes
124
+
125
+ - Updated dependencies [176466a]
126
+ - @ai-sdk/provider@4.0.0-beta.10
127
+ - @ai-sdk/provider-utils@5.0.0-beta.16
128
+
129
+ ## 3.0.0-beta.16
130
+
131
+ ### Patch Changes
132
+
133
+ - Updated dependencies [e311194]
134
+ - @ai-sdk/provider@4.0.0-beta.9
135
+ - @ai-sdk/provider-utils@5.0.0-beta.15
136
+
137
+ ## 3.0.0-beta.15
138
+
139
+ ### Patch Changes
140
+
141
+ - Updated dependencies [34bd95d]
142
+ - Updated dependencies [008271d]
143
+ - @ai-sdk/provider@4.0.0-beta.8
144
+ - @ai-sdk/provider-utils@5.0.0-beta.14
145
+
146
+ ## 3.0.0-beta.14
147
+
148
+ ### Patch Changes
149
+
150
+ - Updated dependencies [b0c2869]
151
+ - Updated dependencies [7e26e81]
152
+ - @ai-sdk/provider-utils@5.0.0-beta.13
153
+
154
+ ## 3.0.0-beta.13
155
+
156
+ ### Patch Changes
157
+
158
+ - Updated dependencies [46d1149]
159
+ - @ai-sdk/provider-utils@5.0.0-beta.12
160
+
161
+ ## 3.0.0-beta.12
162
+
163
+ ### Patch Changes
164
+
165
+ - Updated dependencies [6fd51c0]
166
+ - @ai-sdk/provider-utils@5.0.0-beta.11
167
+ - @ai-sdk/provider@4.0.0-beta.7
168
+
169
+ ## 3.0.0-beta.11
170
+
171
+ ### Patch Changes
172
+
173
+ - Updated dependencies [c29a26f]
174
+ - @ai-sdk/provider-utils@5.0.0-beta.10
175
+ - @ai-sdk/provider@4.0.0-beta.6
176
+
177
+ ## 3.0.0-beta.10
178
+
179
+ ### Patch Changes
180
+
181
+ - 38fc777: Add AI Gateway hint to provider READMEs
182
+
183
+ ## 3.0.0-beta.9
184
+
185
+ ### Patch Changes
186
+
187
+ - Updated dependencies [2e17091]
188
+ - @ai-sdk/provider-utils@5.0.0-beta.9
189
+
190
+ ## 3.0.0-beta.8
191
+
192
+ ### Patch Changes
193
+
194
+ - Updated dependencies [986c6fd]
195
+ - Updated dependencies [493295c]
196
+ - @ai-sdk/provider-utils@5.0.0-beta.8
197
+
198
+ ## 3.0.0-beta.7
199
+
200
+ ### Patch Changes
201
+
202
+ - Updated dependencies [1f509d4]
203
+ - @ai-sdk/provider-utils@5.0.0-beta.7
204
+ - @ai-sdk/provider@4.0.0-beta.5
205
+
206
+ ## 3.0.0-beta.6
207
+
208
+ ### Patch Changes
209
+
210
+ - Updated dependencies [3887c70]
211
+ - @ai-sdk/provider-utils@5.0.0-beta.6
212
+ - @ai-sdk/provider@4.0.0-beta.4
213
+
214
+ ## 3.0.0-beta.5
215
+
216
+ ### Patch Changes
217
+
218
+ - Updated dependencies [776b617]
219
+ - @ai-sdk/provider-utils@5.0.0-beta.5
220
+ - @ai-sdk/provider@4.0.0-beta.3
221
+
222
+ ## 3.0.0-beta.4
223
+
224
+ ### Patch Changes
225
+
226
+ - Updated dependencies [61753c3]
227
+ - @ai-sdk/provider-utils@5.0.0-beta.4
228
+
3
229
  ## 3.0.0-beta.3
4
230
 
5
231
  ### Patch Changes
@@ -235,13 +461,13 @@
235
461
  Before
236
462
 
237
463
  ```ts
238
- model.textEmbeddingModel('my-model-id');
464
+ model.textEmbeddingModel("my-model-id");
239
465
  ```
240
466
 
241
467
  After
242
468
 
243
469
  ```ts
244
- model.embeddingModel('my-model-id');
470
+ model.embeddingModel("my-model-id");
245
471
  ```
246
472
 
247
473
  - 95f65c2: chore: use import \* from zod/v4
@@ -445,13 +671,13 @@
445
671
  Before
446
672
 
447
673
  ```ts
448
- model.textEmbeddingModel('my-model-id');
674
+ model.textEmbeddingModel("my-model-id");
449
675
  ```
450
676
 
451
677
  After
452
678
 
453
679
  ```ts
454
- model.embeddingModel('my-model-id');
680
+ model.embeddingModel("my-model-id");
455
681
  ```
456
682
 
457
683
  - Updated dependencies [8d9e8ad]
@@ -853,7 +1079,7 @@
853
1079
 
854
1080
  ```js
855
1081
  await generateImage({
856
- model: luma.image('photon-flash-1', {
1082
+ model: luma.image("photon-flash-1", {
857
1083
  maxImagesPerCall: 5,
858
1084
  pollIntervalMillis: 500,
859
1085
  }),
@@ -866,7 +1092,7 @@
866
1092
 
867
1093
  ```js
868
1094
  await generateImage({
869
- model: luma.image('photon-flash-1'),
1095
+ model: luma.image("photon-flash-1"),
870
1096
  prompt,
871
1097
  n: 10,
872
1098
  maxImagesPerCall: 5,
@@ -1108,7 +1334,7 @@
1108
1334
 
1109
1335
  ```js
1110
1336
  await generateImage({
1111
- model: luma.image('photon-flash-1', {
1337
+ model: luma.image("photon-flash-1", {
1112
1338
  maxImagesPerCall: 5,
1113
1339
  pollIntervalMillis: 500,
1114
1340
  }),
@@ -1121,7 +1347,7 @@
1121
1347
 
1122
1348
  ```js
1123
1349
  await generateImage({
1124
- model: luma.image('photon-flash-1'),
1350
+ model: luma.image("photon-flash-1"),
1125
1351
  prompt,
1126
1352
  n: 10,
1127
1353
  maxImagesPerCall: 5,
package/README.md CHANGED
@@ -2,6 +2,8 @@
2
2
 
3
3
  The **[fal provider](https://ai-sdk.dev/providers/ai-sdk-providers/fal)** for the [AI SDK](https://ai-sdk.dev/docs) contains image model support for the [fal.ai API](https://fal.ai/).
4
4
 
5
+ > **Deploying to Vercel?** With Vercel's AI Gateway you can access fal (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).
6
+
5
7
  ## Setup
6
8
 
7
9
  The fal provider is available in the `@ai-sdk/fal` module. You can install it with
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { ProviderV3, ImageModelV3, TranscriptionModelV3, Experimental_VideoModelV3, SpeechModelV3 } from '@ai-sdk/provider';
1
+ import { ProviderV4, ImageModelV4, TranscriptionModelV4, Experimental_VideoModelV4, SpeechModelV4 } from '@ai-sdk/provider';
2
2
  import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
3
3
  import { FetchFunction, InferSchema } from '@ai-sdk/provider-utils';
4
4
  import { z } from 'zod/v4';
@@ -32,31 +32,31 @@ interface FalProviderSettings {
32
32
  */
33
33
  fetch?: FetchFunction;
34
34
  }
35
- interface FalProvider extends ProviderV3 {
35
+ interface FalProvider extends ProviderV4 {
36
36
  /**
37
37
  * Creates a model for image generation.
38
38
  */
39
- image(modelId: FalImageModelId): ImageModelV3;
39
+ image(modelId: FalImageModelId): ImageModelV4;
40
40
  /**
41
41
  * Creates a model for image generation.
42
42
  */
43
- imageModel(modelId: FalImageModelId): ImageModelV3;
43
+ imageModel(modelId: FalImageModelId): ImageModelV4;
44
44
  /**
45
45
  * Creates a model for transcription.
46
46
  */
47
- transcription(modelId: FalTranscriptionModelId): TranscriptionModelV3;
47
+ transcription(modelId: FalTranscriptionModelId): TranscriptionModelV4;
48
48
  /**
49
49
  * Creates a model for video generation.
50
50
  */
51
- video(modelId: FalVideoModelId): Experimental_VideoModelV3;
51
+ video(modelId: FalVideoModelId): Experimental_VideoModelV4;
52
52
  /**
53
53
  * Creates a model for video generation.
54
54
  */
55
- videoModel(modelId: FalVideoModelId): Experimental_VideoModelV3;
55
+ videoModel(modelId: FalVideoModelId): Experimental_VideoModelV4;
56
56
  /**
57
57
  * Creates a model for speech generation.
58
58
  */
59
- speech(modelId: FalSpeechModelId): SpeechModelV3;
59
+ speech(modelId: FalSpeechModelId): SpeechModelV4;
60
60
  /**
61
61
  * @deprecated Use `embeddingModel` instead.
62
62
  */