@tanstack/ai-fal 1.1.0 → 1.2.0

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.
Files changed (82) hide show
  1. package/dist/esm/adapters/audio.d.ts +1 -0
  2. package/dist/esm/adapters/audio.js +6 -7
  3. package/dist/esm/adapters/audio.js.map +1 -1
  4. package/dist/esm/adapters/files.d.ts +1 -0
  5. package/dist/esm/adapters/files.js +5 -6
  6. package/dist/esm/adapters/files.js.map +1 -1
  7. package/dist/esm/adapters/image.d.ts +1 -0
  8. package/dist/esm/adapters/image.js +6 -7
  9. package/dist/esm/adapters/image.js.map +1 -1
  10. package/dist/esm/adapters/live.js +1 -2
  11. package/dist/esm/adapters/model3d.d.ts +98 -0
  12. package/dist/esm/adapters/model3d.js +170 -0
  13. package/dist/esm/adapters/model3d.js.map +1 -0
  14. package/dist/esm/adapters/motion.d.ts +58 -0
  15. package/dist/esm/adapters/motion.js +150 -0
  16. package/dist/esm/adapters/motion.js.map +1 -0
  17. package/dist/esm/adapters/speech.d.ts +1 -0
  18. package/dist/esm/adapters/speech.js +6 -7
  19. package/dist/esm/adapters/speech.js.map +1 -1
  20. package/dist/esm/adapters/transcription.d.ts +1 -0
  21. package/dist/esm/adapters/transcription.js +6 -7
  22. package/dist/esm/adapters/transcription.js.map +1 -1
  23. package/dist/esm/adapters/video.d.ts +2 -1
  24. package/dist/esm/adapters/video.js +13 -18
  25. package/dist/esm/adapters/video.js.map +1 -1
  26. package/dist/esm/byok.js +1 -2
  27. package/dist/esm/client/index.d.ts +65 -0
  28. package/dist/esm/client/index.js +306 -0
  29. package/dist/esm/client/index.js.map +1 -0
  30. package/dist/esm/image/generated/image-field-overrides.d.ts +459 -294
  31. package/dist/esm/image/generated/image-field-overrides.js +312 -190
  32. package/dist/esm/image/generated/image-field-overrides.js.map +1 -1
  33. package/dist/esm/image/image-inputs.js +7 -4
  34. package/dist/esm/image/image-inputs.js.map +1 -1
  35. package/dist/esm/image/image-provider-options.js +1 -2
  36. package/dist/esm/image/legacy-image-field-overrides.d.ts +13 -0
  37. package/dist/esm/image/legacy-image-field-overrides.js +91 -0
  38. package/dist/esm/image/legacy-image-field-overrides.js.map +1 -0
  39. package/dist/esm/index.d.ts +6 -2
  40. package/dist/esm/index.js +5 -2
  41. package/dist/esm/model-meta.d.ts +49 -0
  42. package/dist/esm/model3d/generated/mesh-field-overrides.d.ts +20 -0
  43. package/dist/esm/model3d/generated/mesh-field-overrides.js +20 -0
  44. package/dist/esm/model3d/generated/mesh-field-overrides.js.map +1 -0
  45. package/dist/esm/model3d/model3d-inputs.d.ts +39 -0
  46. package/dist/esm/model3d/model3d-inputs.js +206 -0
  47. package/dist/esm/model3d/model3d-inputs.js.map +1 -0
  48. package/dist/esm/model3d/model3d-output.d.ts +25 -0
  49. package/dist/esm/model3d/model3d-output.js +181 -0
  50. package/dist/esm/model3d/model3d-output.js.map +1 -0
  51. package/dist/esm/utils/billing.js +1 -2
  52. package/dist/esm/utils/client.d.ts +16 -1
  53. package/dist/esm/utils/client.js +31 -9
  54. package/dist/esm/utils/client.js.map +1 -1
  55. package/dist/esm/utils/configure.d.ts +12 -0
  56. package/dist/esm/utils/configure.js +19 -0
  57. package/dist/esm/utils/configure.js.map +1 -0
  58. package/dist/esm/utils/index.d.ts +2 -1
  59. package/dist/esm/video/video-provider-options.js +20 -31
  60. package/dist/esm/video/video-provider-options.js.map +1 -1
  61. package/package.json +8 -7
  62. package/src/adapters/audio.ts +7 -6
  63. package/src/adapters/files.ts +5 -4
  64. package/src/adapters/image.ts +8 -7
  65. package/src/adapters/model3d.ts +219 -0
  66. package/src/adapters/motion.ts +237 -0
  67. package/src/adapters/speech.ts +7 -6
  68. package/src/adapters/transcription.ts +8 -7
  69. package/src/adapters/video.ts +16 -18
  70. package/src/client/index.ts +456 -0
  71. package/src/image/generated/image-field-overrides.ts +159 -110
  72. package/src/image/image-inputs.ts +9 -4
  73. package/src/image/legacy-image-field-overrides.ts +94 -0
  74. package/src/index.ts +20 -1
  75. package/src/model-meta.ts +106 -0
  76. package/src/model3d/generated/mesh-field-overrides.ts +46 -0
  77. package/src/model3d/model3d-inputs.ts +232 -0
  78. package/src/model3d/model3d-output.ts +216 -0
  79. package/src/utils/client.ts +37 -4
  80. package/src/utils/configure.ts +17 -0
  81. package/src/utils/index.ts +2 -1
  82. package/src/video/video-provider-options.ts +9 -27
@@ -2,7 +2,7 @@
2
2
  // ---------------------------------------------------------------------------
3
3
  // AUTO-GENERATED — do not edit by hand.
4
4
  //
5
- // Generated from @fal-ai/client@1.10.1 EndpointTypeMap by
5
+ // Generated from @fal-ai/client@1.11.0 EndpointTypeMap by
6
6
  // scripts/generate-fal-image-field-map.ts. Regenerate after bumping
7
7
  // @fal-ai/client:
8
8
  //
@@ -18,7 +18,7 @@ import type { EndpointTypeMap } from '@fal-ai/client/endpoints'
18
18
 
19
19
  /** sha256 of the endpoints.d.ts this file was generated from. */
20
20
  export const FAL_ENDPOINTS_DTS_SHA256 =
21
- 'a071f97905b8a1068f924c74108b881362f20c9054620b70359c200404e23b4e'
21
+ 'be36a2f9a11b0c7d011036915e1615f80e60bfc341ec6b770e897770c63cb511'
22
22
 
23
23
  /** Every input field name the image-input mappers may emit. */
24
24
  export type FalImageFieldName =
@@ -61,8 +61,38 @@ type InputFieldOf<K extends keyof EndpointTypeMap> = Extract<
61
61
  >
62
62
 
63
63
  export const FAL_IMAGE_FIELD_OVERRIDES = {
64
- 'bytedance/lynx': { start: 'image_url' },
65
- 'decart/lucy-i2v': { start: 'image_url' },
64
+ 'alibaba/happy-horse/image-to-video': { start: 'image_url' },
65
+ 'alibaba/happy-horse/reference-to-video': { single: 'image_urls', reference: 'image_urls' },
66
+ 'alibaba/happy-horse/v1.1/image-to-video': { start: 'image_url' },
67
+ 'alibaba/happy-horse/v1.1/reference-to-video': { single: 'image_urls', reference: 'image_urls' },
68
+ 'alibaba/happy-horse/video-edit': { multi: 'reference_image_urls' },
69
+ 'alibaba/qwen-image-3/edit': { single: 'image_urls', reference: 'image_urls' },
70
+ 'alibaba/wan-3.0-prime/reference-to-video': { multi: 'reference_image_urls' },
71
+ 'alibaba/wan-3.0/reference-to-video': { multi: 'reference_image_urls' },
72
+ 'blackforestlabs/flux-3-max/image-to-video': { start: 'image_url' },
73
+ 'blackforestlabs/flux-3/edit-image': { single: 'image_urls', reference: 'image_urls' },
74
+ 'blackforestlabs/flux-3/image-to-video': { start: 'image_url' },
75
+ 'blackforestlabs/flux-3/image-to-video/draft': { start: 'image_url' },
76
+ 'blackforestlabs/flux-3/klein/base/edit-image/lora': { single: 'image_urls', reference: 'image_urls' },
77
+ 'blackforestlabs/flux-3/klein/edit-image': { single: 'image_urls', reference: 'image_urls' },
78
+ 'blackforestlabs/flux-3/klein/edit-image/lora': { single: 'image_urls', reference: 'image_urls' },
79
+ 'bria/fibo-2/edit': { single: 'image_urls', reference: 'image_urls' },
80
+ 'bria/fibo-edit-1.5/edit': { single: 'image_urls', reference: 'image_urls' },
81
+ 'bytedance/omnihuman/v2': { start: 'image_url' },
82
+ 'bytedance/seedance-2.0/fast/image-to-video': { start: 'image_url' },
83
+ 'bytedance/seedance-2.0/fast/reference-to-video': { single: 'image_urls', reference: 'image_urls' },
84
+ 'bytedance/seedance-2.0/mini/image-to-video': { start: 'image_url' },
85
+ 'bytedance/seedance-2.0/mini/reference-to-video': { single: 'image_urls', reference: 'image_urls' },
86
+ 'bytedance/seedance-2.0/us/image-to-video': { start: 'image_url' },
87
+ 'bytedance/seedance-2.0/us/reference-to-video': { single: 'image_urls', reference: 'image_urls' },
88
+ 'bytedance/seedance-2.5/us/image-to-video': { start: 'image_url' },
89
+ 'bytedance/seedance-2.5/us/reference-to-video': { single: 'image_urls', reference: 'image_urls' },
90
+ 'bytedance/seedream/v5/flash/edit': { single: 'image_urls', reference: 'image_urls' },
91
+ 'bytedance/seedream/v5/lite/edit': { single: 'image_urls', reference: 'image_urls' },
92
+ 'bytedance/seedream/v5/pro/edit': { single: 'image_urls', reference: 'image_urls' },
93
+ 'creatify/boreal': { start: 'image_url' },
94
+ 'decart/lucy-2-5/realtime': { reference: 'reference_image_url' },
95
+ 'decart/lucy2-vton/realtime': { reference: 'reference_image_url' },
66
96
  'fal-ai/ai-avatar/multi': { start: 'image_url' },
67
97
  'fal-ai/ai-avatar/multi-text': { start: 'image_url' },
68
98
  'fal-ai/ai-avatar/single-text': { start: 'image_url' },
@@ -71,26 +101,16 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
71
101
  'fal-ai/bytedance/omnihuman/v1.5': { start: 'image_url' },
72
102
  'fal-ai/bytedance/seed/v2/mini': { single: 'image_urls', reference: 'image_urls' },
73
103
  'fal-ai/bytedance/seedance/v1.5/pro/image-to-video': { start: 'image_url' },
74
- 'fal-ai/bytedance/seedance/v1/lite/image-to-video': { start: 'image_url' },
75
- 'fal-ai/bytedance/seedance/v1/lite/reference-to-video': { multi: 'reference_image_urls' },
76
104
  'fal-ai/bytedance/seedance/v1/pro/fast/image-to-video': { start: 'image_url' },
77
105
  'fal-ai/bytedance/seedance/v1/pro/image-to-video': { start: 'image_url' },
78
106
  'fal-ai/bytedance/seedream/v4.5/edit': { single: 'image_urls', reference: 'image_urls' },
79
107
  'fal-ai/bytedance/seedream/v4/edit': { single: 'image_urls', reference: 'image_urls' },
80
- 'fal-ai/bytedance/seedream/v5/lite/edit': { single: 'image_urls', reference: 'image_urls' },
81
- 'fal-ai/cogvideox-5b/image-to-video': { start: 'image_url' },
82
- 'fal-ai/controlnext': { start: 'image_url' },
83
- 'fal-ai/cosmos-predict-2.5/image-to-video': { start: 'image_url' },
84
108
  'fal-ai/creatify/aurora': { start: 'image_url' },
85
109
  'fal-ai/davinci-magihuman': { start: 'image_url' },
86
- 'fal-ai/dreamomni2/edit': { single: 'image_urls', reference: 'image_urls' },
87
110
  'fal-ai/echomimic-v3': { start: 'image_url' },
88
- 'fal-ai/fast-svd-lcm': { start: 'image_url' },
89
- 'fal-ai/firered-image-edit': { single: 'image_urls', reference: 'image_urls' },
90
111
  'fal-ai/firered-image-edit-v1.1': { single: 'image_urls', reference: 'image_urls' },
112
+ 'fal-ai/flashhead': { start: 'image_url' },
91
113
  'fal-ai/flux-2-flex/edit': { single: 'image_urls', reference: 'image_urls' },
92
- 'fal-ai/flux-2-klein-4b-base-trainer': { single: 'image_data_url' },
93
- 'fal-ai/flux-2-klein-4b-base-trainer/edit': { single: 'image_data_url' },
94
114
  'fal-ai/flux-2-klein-9b-base-trainer': { single: 'image_data_url' },
95
115
  'fal-ai/flux-2-klein-9b-base-trainer/edit': { single: 'image_data_url' },
96
116
  'fal-ai/flux-2-lora-gallery/add-background': { single: 'image_urls', reference: 'image_urls' },
@@ -107,6 +127,7 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
107
127
  'fal-ai/flux-2/edit': { single: 'image_urls', reference: 'image_urls' },
108
128
  'fal-ai/flux-2/flash/edit': { single: 'image_urls', reference: 'image_urls' },
109
129
  'fal-ai/flux-2/klein/4b/base/edit': { single: 'image_urls', reference: 'image_urls' },
130
+ 'fal-ai/flux-2/klein/4b/base/edit/lora': { single: 'image_urls', reference: 'image_urls' },
110
131
  'fal-ai/flux-2/klein/4b/edit': { single: 'image_urls', reference: 'image_urls' },
111
132
  'fal-ai/flux-2/klein/4b/edit/lora': { single: 'image_urls', reference: 'image_urls' },
112
133
  'fal-ai/flux-2/klein/9b/base/edit': { single: 'image_urls', reference: 'image_urls' },
@@ -120,6 +141,7 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
120
141
  'fal-ai/flux-general/image-to-image': { reference: 'reference_image_url' },
121
142
  'fal-ai/flux-general/inpainting': { reference: 'reference_image_url' },
122
143
  'fal-ai/flux-general/rf-inversion': { reference: 'reference_image_url' },
144
+ 'fal-ai/flux-kontext-lora/inpaint': { reference: 'reference_image_url' },
123
145
  'fal-ai/flux-kontext-trainer': { single: 'image_data_url' },
124
146
  'fal-ai/flux-pro/kontext/max/multi': { single: 'image_urls', reference: 'image_urls' },
125
147
  'fal-ai/flux-pro/kontext/multi': { single: 'image_urls', reference: 'image_urls' },
@@ -133,26 +155,20 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
133
155
  'fal-ai/gemini-25-flash-image/edit': { single: 'image_urls', reference: 'image_urls' },
134
156
  'fal-ai/gemini-3-pro-image-preview/edit': { single: 'image_urls', reference: 'image_urls' },
135
157
  'fal-ai/gemini-3.1-flash-image-preview/edit': { single: 'image_urls', reference: 'image_urls' },
136
- 'fal-ai/gemini-flash-edit/multi': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
137
158
  'fal-ai/glm-image/image-to-image': { single: 'image_urls', reference: 'image_urls' },
138
- 'fal-ai/goal-force': { start: 'image_url' },
139
- 'fal-ai/got-ocr/v2': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
140
159
  'fal-ai/gpt-image-1-mini/edit': { single: 'image_urls', reference: 'image_urls' },
141
160
  'fal-ai/gpt-image-1.5/edit': { single: 'image_urls', mask: 'mask_image_url', reference: 'image_urls' },
142
- 'fal-ai/gpt-image-1/edit-image': { single: 'image_urls', reference: 'image_urls' },
143
161
  'fal-ai/heygen/avatar4/image-to-video': { start: 'image_url' },
162
+ 'fal-ai/hidream-o1-image': { multi: 'reference_image_urls' },
163
+ 'fal-ai/hidream-o1-image/dev': { multi: 'reference_image_urls' },
164
+ 'fal-ai/hidream-o1-image/dev/edit': { multi: 'reference_image_urls' },
165
+ 'fal-ai/hidream-o1-image/edit': { multi: 'reference_image_urls' },
144
166
  'fal-ai/hunyuan-3d/v3.1/pro/image-to-3d': { single: 'input_image_url' },
145
167
  'fal-ai/hunyuan-3d/v3.1/rapid/image-to-3d': { single: 'input_image_url' },
146
- 'fal-ai/hunyuan-avatar': { start: 'image_url' },
147
- 'fal-ai/hunyuan-custom': { start: 'image_url' },
148
168
  'fal-ai/hunyuan-image/v3/instruct/edit': { single: 'image_urls', reference: 'image_urls' },
149
- 'fal-ai/hunyuan-portrait': { start: 'image_url' },
150
169
  'fal-ai/hunyuan-video-image-to-video': { start: 'image_url' },
151
- 'fal-ai/hunyuan-video-img2vid-lora': { start: 'image_url' },
152
170
  'fal-ai/hunyuan-video-v1.5/image-to-video': { start: 'image_url' },
153
- 'fal-ai/hunyuan3d-v21': { single: 'input_image_url' },
154
171
  'fal-ai/hunyuan3d-v3/image-to-3d': { single: 'input_image_url' },
155
- 'fal-ai/hunyuan3d-v3/sketch-to-3d': { single: 'input_image_url' },
156
172
  'fal-ai/hunyuan3d/v2': { single: 'input_image_url' },
157
173
  'fal-ai/hunyuan3d/v2/mini': { single: 'input_image_url' },
158
174
  'fal-ai/hunyuan3d/v2/mini/turbo': { single: 'input_image_url' },
@@ -160,16 +176,20 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
160
176
  'fal-ai/hy-wu-edit': { single: 'image_urls', reference: 'image_urls' },
161
177
  'fal-ai/hyper3d/rodin': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
162
178
  'fal-ai/hyper3d/rodin/v2': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
179
+ 'fal-ai/hyper3d/rodin/v2.5': { single: 'image_urls', reference: 'image_urls' },
180
+ 'fal-ai/hyper3d/rodin/v2.5/fast': { single: 'image_urls', reference: 'image_urls' },
163
181
  'fal-ai/iclight-v2': { mask: 'mask_image_url' },
182
+ 'fal-ai/id-v2v': { start: 'image_url' },
183
+ 'fal-ai/id-v2v/relight': { start: 'image_url' },
164
184
  'fal-ai/ideogram/character': { single: 'image_urls' },
165
185
  'fal-ai/ideogram/v3': { single: 'image_urls', reference: 'image_urls' },
166
186
  'fal-ai/ideogram/v3/edit': { reference: 'image_urls' },
167
187
  'fal-ai/ideogram/v3/reframe': { reference: 'image_urls' },
168
188
  'fal-ai/ideogram/v3/remix': { reference: 'image_urls' },
169
189
  'fal-ai/ideogram/v3/replace-background': { reference: 'image_urls' },
170
- 'fal-ai/infinitalk': { start: 'image_url' },
171
- 'fal-ai/infinitalk/single-text': { start: 'image_url' },
172
190
  'fal-ai/kandinsky5-pro/image-to-video': { start: 'image_url' },
191
+ 'fal-ai/kandinsky6-lite/image-to-video': { start: 'image_url' },
192
+ 'fal-ai/kandinsky6-pro/image-to-video': { start: 'image_url' },
173
193
  'fal-ai/kling-image/o1': { single: 'image_urls', reference: 'image_urls' },
174
194
  'fal-ai/kling-image/o3/image-to-image': { single: 'image_urls', reference: 'image_urls' },
175
195
  'fal-ai/kling-video/ai-avatar/v2/pro': { start: 'image_url' },
@@ -180,6 +200,10 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
180
200
  'fal-ai/kling-video/o1/standard/video-to-video/reference': { single: 'image_urls', reference: 'image_urls' },
181
201
  'fal-ai/kling-video/o1/video-to-video/edit': { single: 'image_urls', reference: 'image_urls' },
182
202
  'fal-ai/kling-video/o1/video-to-video/reference': { single: 'image_urls', reference: 'image_urls' },
203
+ 'fal-ai/kling-video/o3/4k/image-to-video': { start: 'image_url' },
204
+ 'fal-ai/kling-video/o3/4k/reference-to-video': { single: 'image_urls', reference: 'image_urls' },
205
+ 'fal-ai/kling-video/o3/4k/video-to-video/edit': { single: 'image_urls', reference: 'image_urls' },
206
+ 'fal-ai/kling-video/o3/4k/video-to-video/reference': { single: 'image_urls', reference: 'image_urls' },
183
207
  'fal-ai/kling-video/o3/pro/image-to-video': { start: 'image_url' },
184
208
  'fal-ai/kling-video/o3/pro/reference-to-video': { single: 'image_urls', reference: 'image_urls' },
185
209
  'fal-ai/kling-video/o3/pro/video-to-video/edit': { single: 'image_urls', reference: 'image_urls' },
@@ -189,66 +213,53 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
189
213
  'fal-ai/kling-video/o3/standard/video-to-video/edit': { single: 'image_urls', reference: 'image_urls' },
190
214
  'fal-ai/kling-video/o3/standard/video-to-video/reference': { single: 'image_urls', reference: 'image_urls' },
191
215
  'fal-ai/kling-video/v1.5/pro/effects': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
192
- 'fal-ai/kling-video/v1.5/pro/image-to-video': { start: 'image_url', end: 'tail_image_url' },
193
216
  'fal-ai/kling-video/v1.6/pro/effects': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
194
- 'fal-ai/kling-video/v1.6/pro/elements': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
195
- 'fal-ai/kling-video/v1.6/pro/image-to-video': { start: 'image_url', end: 'tail_image_url' },
196
217
  'fal-ai/kling-video/v1.6/standard/effects': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
197
- 'fal-ai/kling-video/v1.6/standard/elements': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
198
- 'fal-ai/kling-video/v1.6/standard/image-to-video': { start: 'image_url' },
199
218
  'fal-ai/kling-video/v1/pro/ai-avatar': { start: 'image_url' },
200
219
  'fal-ai/kling-video/v1/standard/ai-avatar': { start: 'image_url' },
201
220
  'fal-ai/kling-video/v1/standard/effects': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
202
- 'fal-ai/kling-video/v1/standard/image-to-video': { start: 'image_url', end: 'tail_image_url' },
203
- 'fal-ai/kling-video/v2.1/master/image-to-video': { start: 'image_url' },
204
- 'fal-ai/kling-video/v2.1/standard/image-to-video': { start: 'image_url' },
205
221
  'fal-ai/kling-video/v2.5-turbo/pro/image-to-video': { start: 'image_url', end: 'tail_image_url' },
206
222
  'fal-ai/kling-video/v2.5-turbo/standard/image-to-video': { start: 'image_url' },
207
223
  'fal-ai/kling-video/v2.6/pro/motion-control': { start: 'image_url' },
208
224
  'fal-ai/kling-video/v2.6/standard/motion-control': { start: 'image_url' },
209
- 'fal-ai/kling-video/v2/master/image-to-video': { start: 'image_url' },
210
225
  'fal-ai/kling-video/v3/pro/motion-control': { start: 'image_url' },
211
226
  'fal-ai/kling-video/v3/standard/motion-control': { start: 'image_url' },
212
- 'fal-ai/live-avatar': { start: 'image_url' },
227
+ 'fal-ai/kling-video/v3/turbo/pro/image-to-video': { start: 'image_url' },
228
+ 'fal-ai/kling-video/v3/turbo/standard/image-to-video': { start: 'image_url' },
229
+ 'fal-ai/krea-2/turbo/style': { multi: 'reference_image_urls' },
213
230
  'fal-ai/live-portrait': { start: 'image_url' },
214
- 'fal-ai/longcat-multi-avatar/image-audio-to-video': { start: 'image_url' },
215
231
  'fal-ai/longcat-single-avatar/image-audio-to-video': { start: 'image_url' },
216
232
  'fal-ai/longcat-video/distilled/image-to-video/480p': { start: 'image_url' },
217
233
  'fal-ai/longcat-video/distilled/image-to-video/720p': { start: 'image_url' },
218
234
  'fal-ai/longcat-video/image-to-video/480p': { start: 'image_url' },
219
235
  'fal-ai/longcat-video/image-to-video/720p': { start: 'image_url' },
220
- 'fal-ai/ltx-2-19b/audio-to-video': { start: 'image_url' },
221
- 'fal-ai/ltx-2-19b/audio-to-video/lora': { start: 'image_url' },
222
- 'fal-ai/ltx-2-19b/distilled/audio-to-video': { start: 'image_url' },
223
- 'fal-ai/ltx-2-19b/distilled/audio-to-video/lora': { start: 'image_url' },
224
- 'fal-ai/ltx-2-19b/distilled/image-to-video': { start: 'image_url' },
225
- 'fal-ai/ltx-2-19b/distilled/video-to-video': { start: 'image_url' },
226
- 'fal-ai/ltx-2-19b/distilled/video-to-video/lora': { start: 'image_url' },
227
- 'fal-ai/ltx-2-19b/image-to-video': { start: 'image_url' },
228
- 'fal-ai/ltx-2-19b/image-to-video/lora': { start: 'image_url' },
229
- 'fal-ai/ltx-2-19b/video-to-video': { start: 'image_url' },
230
- 'fal-ai/ltx-2-19b/video-to-video/lora': { start: 'image_url' },
236
+ 'fal-ai/ltx-2.3-22b/audio-to-video': { start: 'image_url' },
237
+ 'fal-ai/ltx-2.3-22b/audio-to-video/lora': { start: 'image_url' },
238
+ 'fal-ai/ltx-2.3-22b/distilled/audio-to-video': { start: 'image_url' },
239
+ 'fal-ai/ltx-2.3-22b/distilled/audio-to-video/lora': { start: 'image_url' },
240
+ 'fal-ai/ltx-2.3-22b/distilled/image-to-video': { start: 'image_url' },
241
+ 'fal-ai/ltx-2.3-22b/distilled/image-to-video/lora': { start: 'image_url' },
242
+ 'fal-ai/ltx-2.3-22b/distilled/reference-video-to-video': { start: 'image_url' },
243
+ 'fal-ai/ltx-2.3-22b/distilled/reference-video-to-video/lora': { start: 'image_url' },
244
+ 'fal-ai/ltx-2.3-22b/image-to-video': { start: 'image_url' },
245
+ 'fal-ai/ltx-2.3-22b/image-to-video/lora': { start: 'image_url' },
246
+ 'fal-ai/ltx-2.3-22b/reference-video-to-video': { start: 'image_url' },
247
+ 'fal-ai/ltx-2.3-22b/reference-video-to-video/lora': { start: 'image_url' },
248
+ 'fal-ai/ltx-2.3-quality/audio-to-video': { start: 'image_url' },
249
+ 'fal-ai/ltx-2.3-quality/audio-to-video/lora': { start: 'image_url' },
250
+ 'fal-ai/ltx-2.3-quality/image-to-video': { start: 'image_url' },
251
+ 'fal-ai/ltx-2.3-quality/image-to-video/lora': { start: 'image_url' },
252
+ 'fal-ai/ltx-2.3-quality/ingredient': { start: 'image_url' },
253
+ 'fal-ai/ltx-2.3-quality/reference-video-to-video': { start: 'image_url' },
254
+ 'fal-ai/ltx-2.3-quality/reference-video-to-video/lora': { start: 'image_url' },
255
+ 'fal-ai/ltx-2.3-quality/render-to-real': { start: 'image_url' },
231
256
  'fal-ai/ltx-2.3/audio-to-video': { start: 'image_url' },
232
257
  'fal-ai/ltx-2.3/image-to-video': { start: 'image_url' },
233
258
  'fal-ai/ltx-2.3/image-to-video/fast': { start: 'image_url' },
234
- 'fal-ai/ltx-2/audio-to-video': { start: 'image_url' },
235
- 'fal-ai/ltx-2/image-to-video': { start: 'image_url' },
236
- 'fal-ai/ltx-2/image-to-video/fast': { start: 'image_url' },
237
- 'fal-ai/ltx-video-13b-dev/image-to-video': { start: 'image_url' },
238
259
  'fal-ai/ltx-video-13b-distilled/image-to-video': { start: 'image_url' },
239
- 'fal-ai/ltx-video-lora/image-to-video': { start: 'image_url' },
240
- 'fal-ai/ltx-video-v095/image-to-video': { start: 'image_url' },
241
- 'fal-ai/ltx-video-v097/image-to-video': { start: 'image_url' },
242
260
  'fal-ai/ltx-video/image-to-video': { start: 'image_url' },
243
261
  'fal-ai/ltxv-13b-098-distilled/image-to-video': { start: 'image_url' },
244
- 'fal-ai/luma-dream-machine/ray-2-flash/image-to-video': { start: 'image_url' },
245
- 'fal-ai/luma-dream-machine/ray-2-flash/modify': { start: 'image_url' },
246
- 'fal-ai/luma-dream-machine/ray-2-flash/reframe': { start: 'image_url' },
247
- 'fal-ai/luma-dream-machine/ray-2/image-to-video': { start: 'image_url' },
248
- 'fal-ai/luma-dream-machine/ray-2/reframe': { start: 'image_url' },
249
262
  'fal-ai/magi-distilled/image-to-video': { start: 'image_url' },
250
- 'fal-ai/magi/image-to-video': { start: 'image_url' },
251
- 'fal-ai/meshy/v5/multi-image-to-3d': { single: 'image_urls', reference: 'image_urls' },
252
263
  'fal-ai/minimax/hailuo-02-fast/image-to-video': { start: 'image_url' },
253
264
  'fal-ai/minimax/hailuo-02/pro/image-to-video': { start: 'image_url' },
254
265
  'fal-ai/minimax/hailuo-02/standard/image-to-video': { start: 'image_url' },
@@ -259,23 +270,24 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
259
270
  'fal-ai/minimax/video-01-director/image-to-video': { start: 'image_url' },
260
271
  'fal-ai/minimax/video-01-live/image-to-video': { start: 'image_url' },
261
272
  'fal-ai/minimax/video-01/image-to-video': { start: 'image_url' },
262
- 'fal-ai/muse-pose': { start: 'image_url' },
273
+ 'fal-ai/motion-to-code/glsl': { start: 'image_url' },
274
+ 'fal-ai/motion-to-code/gsap': { start: 'image_url' },
263
275
  'fal-ai/nano-banana-2/edit': { single: 'image_urls', reference: 'image_urls' },
264
276
  'fal-ai/nano-banana-pro/edit': { single: 'image_urls', reference: 'image_urls' },
265
277
  'fal-ai/nano-banana/edit': { single: 'image_urls', reference: 'image_urls' },
266
- 'fal-ai/omnigen-v1': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
267
278
  'fal-ai/omnigen-v2': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
268
- 'fal-ai/omnipart': { single: 'input_image_url' },
279
+ 'fal-ai/one-to-all-animation/1.3b': { start: 'image_url' },
280
+ 'fal-ai/one-to-all-animation/14b': { start: 'image_url' },
281
+ 'fal-ai/ovi/image-to-video': { start: 'image_url' },
269
282
  'fal-ai/phota/create-profile': { single: 'image_data_url' },
270
283
  'fal-ai/phota/edit': { single: 'image_urls', reference: 'image_urls' },
271
- 'fal-ai/pika/v1.5/pikaffects': { start: 'image_url' },
272
- 'fal-ai/pika/v2.1/image-to-video': { start: 'image_url' },
273
- 'fal-ai/pika/v2.2/image-to-video': { start: 'image_url' },
274
- 'fal-ai/pika/v2.2/pikaframes': { single: 'image_urls', reference: 'image_urls' },
275
- 'fal-ai/pika/v2/pikadditions': { start: 'image_url' },
276
- 'fal-ai/pika/v2/turbo/image-to-video': { start: 'image_url' },
284
+ 'fal-ai/pixverse/c1/image-to-video': { start: 'image_url' },
285
+ 'fal-ai/pixverse/c1/transition': { start: 'first_image_url' },
277
286
  'fal-ai/pixverse/swap': { start: 'image_url' },
287
+ 'fal-ai/pixverse/v3.5/effects': { start: 'image_url' },
278
288
  'fal-ai/pixverse/v3.5/image-to-video': { start: 'image_url' },
289
+ 'fal-ai/pixverse/v3.5/image-to-video/fast': { start: 'image_url' },
290
+ 'fal-ai/pixverse/v3.5/transition': { start: 'first_image_url' },
279
291
  'fal-ai/pixverse/v4.5/effects': { start: 'image_url' },
280
292
  'fal-ai/pixverse/v4.5/image-to-video': { start: 'image_url' },
281
293
  'fal-ai/pixverse/v4.5/image-to-video/fast': { start: 'image_url' },
@@ -293,10 +305,7 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
293
305
  'fal-ai/pixverse/v5/transition': { start: 'first_image_url' },
294
306
  'fal-ai/pixverse/v6/image-to-video': { start: 'image_url' },
295
307
  'fal-ai/pixverse/v6/transition': { start: 'first_image_url' },
296
- 'fal-ai/qwen-image-2/edit': { single: 'image_urls', reference: 'image_urls' },
297
- 'fal-ai/qwen-image-2/pro/edit': { single: 'image_urls', reference: 'image_urls' },
298
308
  'fal-ai/qwen-image-2512-trainer': { single: 'image_data_url' },
299
- 'fal-ai/qwen-image-2512-trainer-v2': { single: 'image_data_url' },
300
309
  'fal-ai/qwen-image-edit-2509': { single: 'image_urls', reference: 'image_urls' },
301
310
  'fal-ai/qwen-image-edit-2509-lora': { single: 'image_urls', reference: 'image_urls' },
302
311
  'fal-ai/qwen-image-edit-2509-lora-gallery/add-background': { single: 'image_urls', reference: 'image_urls' },
@@ -312,7 +321,6 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
312
321
  'fal-ai/qwen-image-edit-2509-trainer': { single: 'image_data_url' },
313
322
  'fal-ai/qwen-image-edit-2511': { single: 'image_urls', reference: 'image_urls' },
314
323
  'fal-ai/qwen-image-edit-2511-multiple-angles': { single: 'image_urls', reference: 'image_urls' },
315
- 'fal-ai/qwen-image-edit-2511-trainer': { single: 'image_data_url' },
316
324
  'fal-ai/qwen-image-edit-2511/lora': { single: 'image_urls', reference: 'image_urls' },
317
325
  'fal-ai/qwen-image-edit-plus': { single: 'image_urls', reference: 'image_urls' },
318
326
  'fal-ai/qwen-image-edit-plus-lora': { single: 'image_urls', reference: 'image_urls' },
@@ -326,34 +334,13 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
326
334
  'fal-ai/qwen-image-edit-plus-lora-gallery/remove-element': { single: 'image_urls', reference: 'image_urls' },
327
335
  'fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting': { single: 'image_urls', reference: 'image_urls' },
328
336
  'fal-ai/qwen-image-edit-plus-lora-gallery/shirt-design': { single: 'image_urls', reference: 'image_urls' },
329
- 'fal-ai/qwen-image-edit-plus-trainer': { single: 'image_data_url' },
330
- 'fal-ai/qwen-image-edit-trainer': { single: 'image_data_url' },
331
- 'fal-ai/qwen-image-layered-trainer': { single: 'image_data_url' },
332
- 'fal-ai/qwen-image-max/edit': { single: 'image_urls', reference: 'image_urls' },
333
- 'fal-ai/qwen-image-trainer': { single: 'image_data_url' },
334
- 'fal-ai/qwen-image-trainer-v2': { single: 'image_data_url' },
335
- 'fal-ai/scail': { start: 'image_url' },
336
- 'fal-ai/skyreels-i2v': { start: 'image_url' },
337
- 'fal-ai/sora-2/image-to-video': { start: 'image_url' },
338
- 'fal-ai/sora-2/image-to-video/pro': { start: 'image_url' },
339
- 'fal-ai/stable-avatar': { start: 'image_url' },
340
- 'fal-ai/stable-video': { start: 'image_url' },
341
- 'fal-ai/steady-dancer': { start: 'image_url' },
337
+ 'fal-ai/reconviagen-0.5': { single: 'image_urls', reference: 'image_urls' },
338
+ 'fal-ai/scail-2': { start: 'image_url' },
339
+ 'fal-ai/sync-lipsync/v3/image-to-video': { start: 'image_url' },
342
340
  'fal-ai/trellis/multi': { single: 'image_urls', reference: 'image_urls' },
343
- 'fal-ai/uno': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
344
341
  'fal-ai/uso': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
345
342
  'fal-ai/vecglypher/image-to-svg': { multi: 'reference_image_urls' },
346
- 'fal-ai/veo2/image-to-video': { start: 'image_url' },
347
- 'fal-ai/veo3.1/fast/first-last-frame-to-video': { start: 'first_frame_url', end: 'last_frame_url' },
348
- 'fal-ai/veo3.1/fast/image-to-video': { start: 'image_url' },
349
- 'fal-ai/veo3.1/first-last-frame-to-video': { start: 'first_frame_url', end: 'last_frame_url' },
350
- 'fal-ai/veo3.1/image-to-video': { start: 'image_url' },
351
- 'fal-ai/veo3.1/lite/first-last-frame-to-video': { start: 'first_frame_url', end: 'last_frame_url' },
352
- 'fal-ai/veo3.1/lite/image-to-video': { start: 'image_url' },
353
- 'fal-ai/veo3.1/reference-to-video': { single: 'image_urls', reference: 'image_urls' },
354
- 'fal-ai/veo3/fast/image-to-video': { start: 'image_url' },
355
- 'fal-ai/veo3/image-to-video': { start: 'image_url' },
356
- 'fal-ai/video-as-prompt': { start: 'image_url' },
343
+ 'fal-ai/vggt-1b': { single: 'image_urls', reference: 'image_urls' },
357
344
  'fal-ai/vidu/image-to-video': { start: 'image_url' },
358
345
  'fal-ai/vidu/q1/image-to-video': { start: 'image_url' },
359
346
  'fal-ai/vidu/q1/reference-to-video': { multi: 'reference_image_urls' },
@@ -363,26 +350,21 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
363
350
  'fal-ai/vidu/q2/reference-to-video/pro': { multi: 'reference_image_urls' },
364
351
  'fal-ai/vidu/q3/image-to-video': { start: 'image_url' },
365
352
  'fal-ai/vidu/q3/image-to-video/turbo': { start: 'image_url' },
353
+ 'fal-ai/vidu/q3/reference-to-video/mix': { multi: 'reference_image_urls' },
354
+ 'fal-ai/vidu/q4/image-to-video': { start: 'image_url' },
355
+ 'fal-ai/vidu/q4/reference-to-video': { multi: 'reference_image_urls' },
366
356
  'fal-ai/vidu/reference-to-image': { multi: 'reference_image_urls' },
367
357
  'fal-ai/vidu/reference-to-video': { multi: 'reference_image_urls' },
368
358
  'fal-ai/vidu/template-to-video': { single: 'input_image_urls', multi: 'input_image_urls', reference: 'input_image_urls' },
369
359
  'fal-ai/wan-22-vace-fun-a14b/depth': { multi: 'ref_image_urls', reference: 'ref_image_urls', start: 'first_frame_url', end: 'last_frame_url' },
370
360
  'fal-ai/wan-22-vace-fun-a14b/inpainting': { multi: 'ref_image_urls', mask: 'mask_image_url', reference: 'ref_image_urls', start: 'first_frame_url', end: 'last_frame_url' },
371
361
  'fal-ai/wan-22-vace-fun-a14b/outpainting': { multi: 'ref_image_urls', reference: 'ref_image_urls', start: 'first_frame_url', end: 'last_frame_url' },
372
- 'fal-ai/wan-22-vace-fun-a14b/pose': { multi: 'ref_image_urls', reference: 'ref_image_urls', start: 'first_frame_url', end: 'last_frame_url' },
373
362
  'fal-ai/wan-22-vace-fun-a14b/reframe': { start: 'first_frame_url', end: 'last_frame_url' },
374
363
  'fal-ai/wan-25-preview/image-to-image': { single: 'image_urls', reference: 'image_urls' },
375
364
  'fal-ai/wan-25-preview/image-to-video': { start: 'image_url' },
376
- 'fal-ai/wan-ati': { start: 'image_url' },
377
- 'fal-ai/wan-effects': { start: 'image_url' },
378
- 'fal-ai/wan-fun-control': { reference: 'reference_image_url' },
379
365
  'fal-ai/wan-i2v': { start: 'image_url' },
380
366
  'fal-ai/wan-i2v-lora': { start: 'image_url' },
381
- 'fal-ai/wan-motion': { start: 'image_url' },
382
- 'fal-ai/wan-move': { start: 'image_url' },
383
367
  'fal-ai/wan-pro/image-to-video': { start: 'image_url' },
384
- 'fal-ai/wan-vace': { multi: 'ref_image_urls', mask: 'mask_image_url', reference: 'ref_image_urls' },
385
- 'fal-ai/wan-vace-1-3b': { multi: 'ref_image_urls', mask: 'mask_image_url', reference: 'ref_image_urls' },
386
368
  'fal-ai/wan-vace-14b': { multi: 'ref_image_urls', mask: 'mask_image_url', reference: 'ref_image_urls', start: 'first_frame_url', end: 'last_frame_url' },
387
369
  'fal-ai/wan-vace-14b/depth': { multi: 'ref_image_urls', reference: 'ref_image_urls', start: 'first_frame_url', end: 'last_frame_url' },
388
370
  'fal-ai/wan-vace-14b/inpainting': { multi: 'ref_image_urls', mask: 'mask_image_url', reference: 'ref_image_urls', start: 'first_frame_url', end: 'last_frame_url' },
@@ -401,18 +383,80 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
401
383
  'fal-ai/wan/v2.7/image-to-video': { start: 'image_url' },
402
384
  'fal-ai/wan/v2.7/pro/edit': { single: 'image_urls', reference: 'image_urls' },
403
385
  'fal-ai/wan/v2.7/reference-to-video': { multi: 'reference_image_urls' },
386
+ 'fal-ai/workflow-utilities/pick-image-by-index': { single: 'image_urls', reference: 'image_urls' },
404
387
  'fal-ai/x-ailab/nsfw': { single: 'image_urls', reference: 'image_urls' },
405
- 'fal-ai/z-image-base-trainer': { single: 'image_data_url' },
406
388
  'fal-ai/z-image-trainer': { single: 'image_data_url' },
407
389
  'fal-ai/z-image-turbo-trainer-v2': { single: 'image_data_url' },
408
390
  'fal-ai/z-image/turbo/inpaint': { mask: 'mask_image_url' },
409
391
  'fal-ai/z-image/turbo/inpaint/lora': { mask: 'mask_image_url' },
410
392
  'fal-ai/z-image/turbo/tiling': { mask: 'mask_image_url' },
411
393
  'fal-ai/z-image/turbo/tiling/lora': { mask: 'mask_image_url' },
394
+ 'google/gemini-omni-flash/image-to-video': { start: 'image_url' },
395
+ 'google/gemini-omni-flash/reference-to-video': { single: 'image_urls', reference: 'image_urls' },
396
+ 'google/gemini-omni-flash/v1.1/image-to-video': { start: 'image_url' },
397
+ 'google/gemini-omni-flash/v1.1/reference-to-video': { single: 'image_urls', reference: 'image_urls' },
398
+ 'google/nano-banana-2.1/edit': { single: 'image_urls', reference: 'image_urls' },
399
+ 'google/nano-banana-lite/edit': { single: 'image_urls', reference: 'image_urls' },
400
+ 'heygen/heygen-video/image-to-video': { start: 'image_url' },
401
+ 'heygen/heygen-video/reference-to-video': { multi: 'reference_image_urls' },
402
+ 'ideogram/v4.5/edit': { multi: 'reference_image_urls' },
403
+ 'ideogram/vector/text-to-vector': { single: 'image_urls', reference: 'image_urls' },
404
+ 'kling/v4/reference-to-video': { single: 'image_urls', reference: 'image_urls' },
405
+ 'kling/v4/video-to-video/edit': { single: 'image_urls', reference: 'image_urls' },
406
+ 'krea/v3/edit': { single: 'image_urls', reference: 'image_urls' },
407
+ 'lightricks/ltx-2.5/audio-to-video/fast': { start: 'image_url' },
408
+ 'lightricks/ltx-2.5/audio-to-video/pro': { start: 'image_url' },
409
+ 'lightricks/ltx-2.5/image-to-video/fast': { start: 'image_url' },
410
+ 'lightricks/ltx-2.5/image-to-video/pro': { start: 'image_url' },
411
+ 'luma/agent/ray/v3.2/image-to-video': { start: 'image_url' },
412
+ 'luma/agent/uni-1/v1/edit': { multi: 'reference_image_urls' },
413
+ 'luma/agent/uni-1/v1/max': { multi: 'reference_image_urls' },
414
+ 'luma/agent/uni-1/v1/max/edit': { multi: 'reference_image_urls' },
415
+ 'luma/agent/uni-1/v1/text-to-image': { multi: 'reference_image_urls' },
416
+ 'meshy/v7.1/multi-image-to-3d': { single: 'image_urls', reference: 'image_urls' },
417
+ 'meshy/v7/multi-image-to-3d': { single: 'image_urls', reference: 'image_urls' },
418
+ 'meta/muse-image/edit': { single: 'image_urls', reference: 'image_urls' },
419
+ 'microsoft/mai-image-2.5/edit': { single: 'image_urls', reference: 'image_urls' },
420
+ 'minimax/h3-max-turbo/image-to-video': { start: 'image_url' },
421
+ 'minimax/h3-max-turbo/reference-to-video': { multi: 'reference_image_urls' },
422
+ 'minimax/h3-max/3d-to-video': { multi: 'reference_image_urls' },
423
+ 'minimax/h3-max/camera-controls': { start: 'image_url' },
424
+ 'minimax/h3-max/image-to-video': { start: 'image_url' },
425
+ 'minimax/h3-max/insert-video': { multi: 'reference_image_urls' },
426
+ 'minimax/h3-max/lip-sync/image-to-video': { start: 'image_url' },
427
+ 'minimax/h3-max/recast': { multi: 'reference_image_urls' },
428
+ 'minimax/h3-max/reference-to-video': { multi: 'reference_image_urls', start: 'image_url' },
429
+ 'minimax/h3-max/relight': { reference: 'reference_image_url' },
430
+ 'minimax/h3-max/styles/16bit-pixel': { start: 'image_url' },
431
+ 'minimax/h3-max/styles/hand-drawn': { start: 'image_url' },
432
+ 'minimax/h3-max/styles/low-poly': { start: 'image_url' },
433
+ 'minimax/h3-max/styles/retro-toon-70s': { start: 'image_url' },
434
+ 'minimax/h3-max/styles/vhs': { start: 'image_url' },
435
+ 'minimax/h3/image-to-video': { start: 'image_url' },
436
+ 'minimax/h3/image-to-video/lora': { start: 'image_url' },
437
+ 'minimax/h3/reference-to-video': { multi: 'reference_image_urls' },
438
+ 'minimax/h3/reference-to-video/lora': { multi: 'reference_image_urls' },
412
439
  'moonvalley/marey/i2v': { start: 'image_url' },
413
440
  'moonvalley/marey/motion-transfer': { reference: 'reference_image_url' },
414
441
  'moonvalley/marey/pose-transfer': { reference: 'reference_image_url' },
442
+ 'nvidia/cosmos-3-super/image-to-video': { start: 'image_url' },
443
+ 'openai/gpt-image-2.5/flare/edit': { single: 'image_urls', reference: 'image_urls' },
444
+ 'openai/gpt-image-2.5/sunburst/edit': { single: 'image_urls', reference: 'image_urls' },
445
+ 'openai/gpt-image-2/edit': { single: 'image_urls', reference: 'image_urls' },
446
+ 'openrouter/router/decisions': { single: 'image_urls', reference: 'image_urls' },
447
+ 'openrouter/router/openai/v1/chat/completions': { single: 'image_urls', reference: 'image_urls' },
448
+ 'openrouter/router/openai/v1/responses': { single: 'image_urls', reference: 'image_urls' },
415
449
  'openrouter/router/vision': { single: 'image_urls', reference: 'image_urls' },
450
+ 'pixelcut/looping-video': { start: 'image_url' },
451
+ 'pixverse/music-video/vibemv': { start: 'image_url' },
452
+ 'recraft/v4/create-style': { single: 'image_urls', reference: 'image_urls' },
453
+ 'recraft/v4/pro/create-style': { single: 'image_urls', reference: 'image_urls' },
454
+ 'recraft/v4/style/pro/text-to-image': { single: 'image_urls', reference: 'image_urls' },
455
+ 'recraft/v4/style/pro/text-to-vector': { single: 'image_urls', reference: 'image_urls' },
456
+ 'recraft/v4/style/text-to-image': { single: 'image_urls', reference: 'image_urls' },
457
+ 'recraft/v4/style/text-to-vector': { single: 'image_urls', reference: 'image_urls' },
458
+ 'tbc/mischief-1/image-to-video': { start: 'image_url' },
459
+ 'tripo3d/h3.1/multiview-to-3d': { single: 'image_urls', reference: 'image_urls' },
416
460
  'veed/fabric-1.0': { start: 'image_url' },
417
461
  'veed/fabric-1.0/fast': { start: 'image_url' },
418
462
  'veed/fabric-1.0/text': { start: 'image_url' },
@@ -421,8 +465,13 @@ export const FAL_IMAGE_FIELD_OVERRIDES = {
421
465
  'wan/v2.6/image-to-video/flash': { start: 'image_url' },
422
466
  'wan/v2.6/reference-to-video/flash': { single: 'image_urls', reference: 'image_urls' },
423
467
  'xai/grok-imagine-image/edit': { single: 'image_urls', reference: 'image_urls' },
468
+ 'xai/grok-imagine-image/quality/edit': { single: 'image_urls', reference: 'image_urls' },
469
+ 'xai/grok-imagine-image/v2.0/edit': { single: 'image_urls', reference: 'image_urls' },
424
470
  'xai/grok-imagine-video/image-to-video': { start: 'image_url' },
425
471
  'xai/grok-imagine-video/reference-to-video': { multi: 'reference_image_urls' },
472
+ 'xai/grok-imagine-video/v1.5/image-to-video': { start: 'image_url' },
473
+ 'xai/grok-imagine-video/v1.5/lite/image-to-video': { start: 'image_url' },
474
+ 'xai/grok-imagine-video/v1.5/reference-to-video': { multi: 'reference_image_urls' },
426
475
  } as const satisfies {
427
476
  [K in keyof EndpointTypeMap]?: {
428
477
  [Role in keyof FalImageFieldOverride]?: InputFieldOf<K>
@@ -1,5 +1,6 @@
1
1
  import { fileReferenceFor, isFileSource } from '@tanstack/ai'
2
2
  import { FAL_IMAGE_FIELD_OVERRIDES } from './generated/image-field-overrides'
3
+ import { FAL_LEGACY_IMAGE_FIELD_OVERRIDES } from './legacy-image-field-overrides'
3
4
  import type {
4
5
  FalImageFieldName,
5
6
  FalImageFieldOverride,
@@ -66,11 +67,15 @@ const LIST_FIELDS = new Set<string>([
66
67
  'reference_image_urls',
67
68
  ])
68
69
 
69
- /** Resolve the per-role field names for a model: defaults + generated overrides. */
70
+ /**
71
+ * Resolve the per-role field names for a model: defaults, then the generated
72
+ * overrides, or the hand-kept ones for live endpoints the SDK has no types for.
73
+ */
70
74
  function fieldSpecFor(model: string): Required<FalImageFieldOverride> {
71
- const overrides = (
72
- FAL_IMAGE_FIELD_OVERRIDES as Record<string, FalImageFieldOverride>
73
- )[model]
75
+ const overrides =
76
+ (FAL_IMAGE_FIELD_OVERRIDES as Record<string, FalImageFieldOverride>)[
77
+ model
78
+ ] ?? FAL_LEGACY_IMAGE_FIELD_OVERRIDES[model]
74
79
  return { ...DEFAULT_FIELDS, ...overrides }
75
80
  }
76
81
 
@@ -0,0 +1,94 @@
1
+ import type {
2
+ FalImageFieldName,
3
+ FalImageFieldOverride,
4
+ } from './generated/image-field-overrides'
5
+
6
+ /**
7
+ * Hand-kept field overrides for fal endpoints that are still live but have no
8
+ * types in `@fal-ai/client`, so the generator cannot find them. The generated
9
+ * `FAL_IMAGE_FIELD_OVERRIDES` wins when it has the same endpoint.
10
+ *
11
+ * Before you add or remove an entry, check that the endpoint is live:
12
+ * `https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=<id>` returns
13
+ * 200 for a live endpoint and 404 for a removed one.
14
+ */
15
+ export const FAL_LEGACY_IMAGE_FIELD_OVERRIDES: Record<
16
+ string,
17
+ { [Role in keyof FalImageFieldOverride]?: FalImageFieldName }
18
+ > = {
19
+ 'decart/lucy-i2v': { start: 'image_url' },
20
+ 'fal-ai/bytedance/seedance/v1/lite/image-to-video': { start: 'image_url' },
21
+ 'fal-ai/bytedance/seedance/v1/lite/reference-to-video': {
22
+ multi: 'reference_image_urls',
23
+ },
24
+ 'fal-ai/bytedance/seedream/v5/lite/edit': {
25
+ single: 'image_urls',
26
+ reference: 'image_urls',
27
+ },
28
+ 'fal-ai/infinitalk': { start: 'image_url' },
29
+ 'fal-ai/infinitalk/single-text': { start: 'image_url' },
30
+ 'fal-ai/kling-video/v1.5/pro/image-to-video': {
31
+ start: 'image_url',
32
+ end: 'tail_image_url',
33
+ },
34
+ 'fal-ai/kling-video/v1.6/pro/image-to-video': {
35
+ start: 'image_url',
36
+ end: 'tail_image_url',
37
+ },
38
+ 'fal-ai/kling-video/v1.6/standard/image-to-video': { start: 'image_url' },
39
+ 'fal-ai/kling-video/v1/standard/image-to-video': {
40
+ start: 'image_url',
41
+ end: 'tail_image_url',
42
+ },
43
+ 'fal-ai/kling-video/v2.1/master/image-to-video': { start: 'image_url' },
44
+ 'fal-ai/kling-video/v2.1/standard/image-to-video': { start: 'image_url' },
45
+ 'fal-ai/kling-video/v2/master/image-to-video': { start: 'image_url' },
46
+ 'fal-ai/ltx-2-19b/audio-to-video': { start: 'image_url' },
47
+ 'fal-ai/ltx-2-19b/audio-to-video/lora': { start: 'image_url' },
48
+ 'fal-ai/ltx-2-19b/distilled/audio-to-video': { start: 'image_url' },
49
+ 'fal-ai/ltx-2-19b/distilled/audio-to-video/lora': { start: 'image_url' },
50
+ 'fal-ai/ltx-2-19b/distilled/image-to-video': { start: 'image_url' },
51
+ 'fal-ai/ltx-2-19b/distilled/video-to-video': { start: 'image_url' },
52
+ 'fal-ai/ltx-2-19b/distilled/video-to-video/lora': { start: 'image_url' },
53
+ 'fal-ai/ltx-2-19b/image-to-video': { start: 'image_url' },
54
+ 'fal-ai/ltx-2-19b/image-to-video/lora': { start: 'image_url' },
55
+ 'fal-ai/ltx-2-19b/video-to-video': { start: 'image_url' },
56
+ 'fal-ai/ltx-2-19b/video-to-video/lora': { start: 'image_url' },
57
+ 'fal-ai/pika/v1.5/pikaffects': { start: 'image_url' },
58
+ 'fal-ai/pika/v2.1/image-to-video': { start: 'image_url' },
59
+ 'fal-ai/pika/v2/pikadditions': { start: 'image_url' },
60
+ 'fal-ai/pika/v2/turbo/image-to-video': { start: 'image_url' },
61
+ 'fal-ai/qwen-image-2/edit': { single: 'image_urls', reference: 'image_urls' },
62
+ 'fal-ai/qwen-image-2/pro/edit': {
63
+ single: 'image_urls',
64
+ reference: 'image_urls',
65
+ },
66
+ 'fal-ai/veo3.1/fast/first-last-frame-to-video': {
67
+ start: 'first_frame_url',
68
+ end: 'last_frame_url',
69
+ },
70
+ 'fal-ai/veo3.1/fast/image-to-video': { start: 'image_url' },
71
+ 'fal-ai/veo3.1/first-last-frame-to-video': {
72
+ start: 'first_frame_url',
73
+ end: 'last_frame_url',
74
+ },
75
+ 'fal-ai/veo3.1/image-to-video': { start: 'image_url' },
76
+ 'fal-ai/veo3.1/lite/first-last-frame-to-video': {
77
+ start: 'first_frame_url',
78
+ end: 'last_frame_url',
79
+ },
80
+ 'fal-ai/veo3.1/lite/image-to-video': { start: 'image_url' },
81
+ 'fal-ai/veo3.1/reference-to-video': {
82
+ single: 'image_urls',
83
+ reference: 'image_urls',
84
+ },
85
+ 'fal-ai/veo3/fast/image-to-video': { start: 'image_url' },
86
+ 'fal-ai/veo3/image-to-video': { start: 'image_url' },
87
+ 'fal-ai/wan-22-vace-fun-a14b/pose': {
88
+ multi: 'ref_image_urls',
89
+ reference: 'ref_image_urls',
90
+ start: 'first_frame_url',
91
+ end: 'last_frame_url',
92
+ },
93
+ 'fal-ai/wan-motion': { start: 'image_url' },
94
+ }