@henjicc/ai-sdk 0.8.0 → 0.10.0

package/dist/catalog/fal/ltx-2.3.model.d.ts

@@ -0,0 +1,2 @@
+export declare const falLtx23Model: import("../../index.js").ModelRuntimeDefinition;
+export default falLtx23Model;

package/dist/catalog/fal/ltx-2.3.model.js

@@ -0,0 +1,223 @@
+import { defineModel } from "../defineModel.js";
+import { hasUploadedImage, resolveUploadedAudioDurationSeconds, resolveUploadedAudioSources, resolveUploadedImageSources, resolveUploadedVideoSources } from "../shared/mediaPresence.js";
+// 价格与字段来源：docs/model-adaptation/LTX-2.3/LTX-2.3_Fal.md（Fal 模型页与 OpenAPI，2026-11-07 读取）
+const RATES = {
+    fast: { '1080p': 0.06, '1440p': 0.12, '2160p': 0.24 },
+    pro: { '1080p': 0.08, '1440p': 0.16, '2160p': 0.32 }
+};
+// 快速档 12–20 秒只支持 1080p + 25fps，其余组合最长 10 秒。
+const LONG_DURATIONS = [12, 14, 16, 18, 20];
+// 音频生视频：输出视频跟随输入音频长度，音频须为 2–20 秒；读不到时长时按最长 20 秒估，宁高勿低。
+const AUDIO_MIN_SECONDS = 2;
+const AUDIO_MAX_SECONDS = 20;
+function mode(params) {
+    return ['video-extension', 'retake-video', 'audio-to-video'].includes(String(params.falLtx23Mode)) ? String(params.falLtx23Mode) : 'text-image-to-video';
+}
+const showsAspectRatio = (params) => ['text-image-to-video', 'audio-to-video'].includes(mode(params));
+function choice(value, values, fallback) {
+    return values.includes(value) ? value : fallback;
+}
+function clampSeconds(value, min, max, fallback) {
+    const number = Number(value);
+    return Number.isFinite(number) ? Math.min(max, Math.max(min, number)) : fallback;
+}
+export const falLtx23Model = defineModel({
+    meta: {
+        id: 'fal-ai-ltx-2.3', canonicalModelId: 'ltx-2.3', seriesId: 'ltx', seriesRank: 2.3,
+        provider: 'fal', type: 'video',
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'video-to-video', 'video-extension', 'audio-to-video'],
+        polling: { interval: 3000, maxAttempts: 300, expectedAttempts: 40 }
+    },
+    inputLimits: {
+        images: { max: 2 }, videos: { max: 0 }, audios: { max: 0 },
+        rules: [
+            { when: 'falLtx23Mode === "video-extension"', images: { max: 0 }, videos: { exact: 1 } },
+            { when: 'falLtx23Mode === "retake-video"', images: { max: 0 }, videos: { exact: 1 } },
+            { when: 'falLtx23Mode === "audio-to-video"', images: { max: 1 }, videos: { max: 0 }, audios: { exact: 1 } }
+        ]
+    },
+    requirements: [
+        {
+            id: 'fal-ltx-2.3-source-video',
+            when: 'falLtx23Mode === "video-extension" || falLtx23Mode === "retake-video"',
+            require: { videos: { exact: 1 } },
+            message: { title: '视频必需', message: '延长视频和视频重拍需要上传 1 个视频', type: 'warning' }
+        }
+    ],
+    params: [
+        {
+            id: 'falLtx23Mode', type: 'dropdown', order: 1,
+            default: 'text-image-to-video',
+            options: [{ value: 'text-image-to-video' }, { value: 'video-extension' }, { value: 'retake-video' }, { value: 'audio-to-video' }]
+        },
+        {
+            id: 'falLtx23AspectRatio', type: 'dropdown', order: 2,
+            default: 'smart',
+            visible: { condition: showsAspectRatio },
+            options: [{ value: 'smart' }, { value: '16:9' }, { value: '9:16' }]
+        },
+        {
+            id: 'falLtx23Resolution', type: 'dropdown', order: 3,
+            default: '1080p',
+            visible: { condition: (params) => mode(params) === 'text-image-to-video' },
+            options: [{ value: '1080p' }, { value: '1440p' }, { value: '2160p' }]
+        },
+        {
+            id: 'falLtx23Duration', type: 'dropdown', order: 4,
+            default: 6,
+            visible: { condition: (params) => mode(params) === 'text-image-to-video' },
+            options: [6, 8, 10, ...LONG_DURATIONS].map((value) => ({ value }))
+        },
+        {
+            id: 'falLtx23ExtendDuration', type: 'number', order: 5,
+            default: 5, min: 2, max: 20, step: 1,
+            visible: { condition: (params) => mode(params) === 'video-extension' }
+        },
+        {
+            id: 'falLtx23ExtendDirection', type: 'dropdown', order: 6,
+            default: 'end',
+            visible: { condition: (params) => mode(params) === 'video-extension' },
+            options: [{ value: 'end' }, { value: 'start' }]
+        },
+        {
+            id: 'falLtx23RetakeStartTime', type: 'number', order: 7,
+            default: 0, min: 0, max: 20, step: 0.5,
+            visible: { condition: (params) => mode(params) === 'retake-video' }
+        },
+        {
+            id: 'falLtx23RetakeDuration', type: 'number', order: 8,
+            default: 5, min: 2, max: 20, step: 0.5,
+            visible: { condition: (params) => mode(params) === 'retake-video' }
+        },
+        {
+            id: 'falLtx23RetakeMode', type: 'dropdown', order: 9,
+            default: 'replace_audio_and_video',
+            visible: { condition: (params) => mode(params) === 'retake-video' },
+            options: [{ value: 'replace_audio_and_video' }, { value: 'replace_video' }, { value: 'replace_audio' }]
+        },
+        {
+            id: 'falLtx23Fps', type: 'dropdown', order: 10,
+            default: 25,
+            visible: { condition: (params) => mode(params) === 'text-image-to-video' },
+            options: [24, 25, 48, 50].map((value) => ({ value }))
+        },
+        {
+            id: 'falLtx23GenerateAudio', type: 'switch', order: 11,
+            default: true,
+            visible: { condition: (params) => mode(params) === 'text-image-to-video' }
+        },
+        {
+            id: 'falLtx23FastMode', type: 'switch', order: 12,
+            default: true,
+            visible: { condition: (params) => mode(params) === 'text-image-to-video' }
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            const current = mode(params);
+            if (current === 'video-extension')
+                return 'fal-ai/ltx-2.3/extend-video';
+            if (current === 'retake-video')
+                return 'fal-ai/ltx-2.3/retake-video';
+            if (current === 'audio-to-video')
+                return 'fal-ai/ltx-2.3/audio-to-video';
+            const route = hasUploadedImage(params) ? 'image-to-video' : 'text-to-video';
+            return params.falLtx23FastMode === false ? `fal-ai/ltx-2.3/${route}` : `fal-ai/ltx-2.3/${route}/fast`;
+        }
+    },
+    request: {
+        builder: (params) => {
+            const prompt = typeof params.prompt === 'string' ? params.prompt.trim() : '';
+            const current = mode(params);
+            if (current === 'audio-to-video') {
+                const audio = resolveUploadedAudioSources(params)[0];
+                if (!audio)
+                    throw new Error('LTX-2.3 音频生视频需要上传 1 段音频');
+                const image = resolveUploadedImageSources(params)[0];
+                if (!image && !prompt)
+                    throw new Error('LTX-2.3 音频生视频不传首帧图时需要填写提示词');
+                const ratio = String(params.falLtx23AspectRatio || 'smart');
+                const body = {
+                    audio_url: audio,
+                    aspect_ratio: ratio === '9:16' || ratio === '16:9' ? ratio : 'auto'
+                };
+                if (image)
+                    body.image_url = image;
+                if (prompt)
+                    body.prompt = prompt;
+                return body;
+            }
+            if (current !== 'text-image-to-video') {
+                const video = resolveUploadedVideoSources(params)[0];
+                if (!video)
+                    throw new Error('LTX-2.3 延长视频和视频重拍需要上传 1 个视频');
+                if (current === 'video-extension') {
+                    const body = {
+                        video_url: video,
+                        duration: clampSeconds(params.falLtx23ExtendDuration, 2, 20, 5),
+                        mode: choice(params.falLtx23ExtendDirection, ['end', 'start'], 'end')
+                    };
+                    if (prompt)
+                        body.prompt = prompt;
+                    return body;
+                }
+                if (!prompt)
+                    throw new Error('LTX-2.3 视频重拍需要填写提示词');
+                return {
+                    prompt,
+                    video_url: video,
+                    start_time: clampSeconds(params.falLtx23RetakeStartTime, 0, 20, 0),
+                    duration: clampSeconds(params.falLtx23RetakeDuration, 2, 20, 5),
+                    retake_mode: choice(params.falLtx23RetakeMode, ['replace_audio', 'replace_video', 'replace_audio_and_video'], 'replace_audio_and_video')
+                };
+            }
+            if (!prompt)
+                throw new Error('LTX-2.3 的提示词不能为空');
+            const fast = params.falLtx23FastMode !== false;
+            const resolution = choice(params.falLtx23Resolution, ['1080p', '1440p', '2160p'], '1080p');
+            const fps = choice(Number(params.falLtx23Fps), [24, 25, 48, 50], 25);
+            const duration = choice(Number(params.falLtx23Duration), [6, 8, 10, ...LONG_DURATIONS], 6);
+            if (duration > 10 && !(fast && resolution === '1080p' && fps === 25))
+                throw new Error('LTX-2.3 超过 10 秒只支持快速模式、1080p 和 25 FPS');
+            const images = resolveUploadedImageSources(params);
+            const ratio = String(params.falLtx23AspectRatio || 'smart');
+            const body = {
+                prompt,
+                duration,
+                resolution,
+                fps,
+                generate_audio: params.falLtx23GenerateAudio !== false
+            };
+            if (images.length > 0) {
+                body.image_url = images[0];
+                if (images.length > 1)
+                    body.end_image_url = images[1];
+                body.aspect_ratio = ratio === '9:16' || ratio === '16:9' ? ratio : 'auto';
+            }
+            else {
+                body.aspect_ratio = ratio === '9:16' ? '9:16' : '16:9';
+            }
+            return body;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const current = mode(params);
+            if (current === 'video-extension')
+                return 0.1 * clampSeconds(params.falLtx23ExtendDuration, 2, 20, 5);
+            if (current === 'retake-video')
+                return 0.1 * clampSeconds(params.falLtx23RetakeDuration, 2, 20, 5);
+            if (current === 'audio-to-video')
+                return 0.1 * clampSeconds(resolveUploadedAudioDurationSeconds(params, AUDIO_MAX_SECONDS), AUDIO_MIN_SECONDS, AUDIO_MAX_SECONDS, AUDIO_MAX_SECONDS);
+            const rates = params.falLtx23FastMode === false ? RATES.pro : RATES.fast;
+            const resolution = choice(params.falLtx23Resolution, ['1080p', '1440p', '2160p'], '1080p');
+            return rates[resolution] * choice(Number(params.falLtx23Duration), [6, 8, 10, ...LONG_DURATIONS], 6);
+        },
+        mediaContext: [
+            { targetParam: '__audioDurationSeconds', mediaType: 'audio', metric: 'durationSeconds', when: (params) => mode(params) === 'audio-to-video' }
+        ],
+        description: '快速：1080p $0.06/秒、1440p $0.12/秒、2160p $0.24/秒；标准：$0.08/$0.16/$0.32 每秒；延长视频与视频重拍 $0.10/秒；音频生视频 $0.10/秒，按音频时长计算（视频与音频等长），读不到时长时按最长 20 秒估'
+    }
+});
+export default falLtx23Model;

package/dist/catalog/fal/ltx-2.model.js

@@ -5,7 +5,8 @@ export const ltx2Model = defineModel({
         canonicalModelId: 'ltx-2',
         provider: 'fal',
         type: 'video',
-        tags: ['video', 'text-to-video', 'image-to-video']
+        deprecated: 'Fal 已撤下全部 LTX-2 端点（2026-11 起返回 404），由 LTX-2.3 取代',
+        tags: ['text-to-video', 'image-to-video', 'video-to-video']
     },
     inputLimits: {
         images: { max: 0 },

package/dist/catalog/fal/minimax-h3-max.model.d.ts

@@ -0,0 +1,2 @@
+export declare const falMiniMaxH3MaxModel: import("../../index.js").ModelRuntimeDefinition;
+export default falMiniMaxH3MaxModel;

package/dist/catalog/fal/minimax-h3-max.model.js

@@ -0,0 +1,132 @@
+import { defineModel } from "../defineModel.js";
+import { hasUploadedImage, resolveUploadedImageSources, resolveUploadedVideoSources } from "../shared/mediaPresence.js";
+// 价格与字段来源：docs/model-adaptation/MiniMax-H3-Max/MiniMax-H3-Max_Fal.md（Fal 模型页与 OpenAPI，2026-11-07 读取）。
+// 计价按 2026-11-16 起的标准价；此前的限时折扣只会让实际账单更低。
+const RATES = {
+    max: { '480P': 0.05, '768P': 0.08, '1080P': 0.16 },
+    turbo: { '480P': 0.025, '768P': 0.04, '1080P': 0.08 }
+};
+const RATIOS = ['21:9', '16:9', '4:3', '1:1', '3:4', '9:16'];
+function reference(params) {
+    return params.falMiniMaxH3MaxMode === 'reference-to-video';
+}
+function resolution(params) {
+    return ['480P', '1080P'].includes(String(params.falMiniMaxH3MaxResolution)) ? String(params.falMiniMaxH3MaxResolution) : '768P';
+}
+function duration(params) {
+    const value = Math.round(Number(params.falMiniMaxH3MaxDuration));
+    return Number.isFinite(value) ? Math.min(15, Math.max(1, value)) : 5;
+}
+function audioSources(params) {
+    for (const candidate of [params.uploadedAudioFilePaths, params.audios, params.uploadedAudios]) {
+        if (!Array.isArray(candidate))
+            continue;
+        const sources = candidate.flatMap((item) => typeof item === 'string' && item.trim() ? [item.trim()] : []);
+        if (sources.length > 0)
+            return sources;
+    }
+    return [];
+}
+function ratio(params) {
+    const raw = String(params.falMiniMaxH3MaxAspectRatio || 'smart');
+    return RATIOS.includes(raw) ? raw : '16:9';
+}
+export const falMiniMaxH3MaxModel = defineModel({
+    meta: {
+        id: 'fal-ai-minimax-h3-max', canonicalModelId: 'minimax-h3-max', seriesId: 'hailuo', seriesRank: 3.1,
+        provider: 'fal', type: 'video',
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode'],
+        polling: { interval: 3000, maxAttempts: 300, expectedAttempts: 75 }
+    },
+    inputLimits: {
+        images: { max: 2 }, videos: { max: 0 }, audios: { max: 0 },
+        rules: [{ when: 'falMiniMaxH3MaxMode === "reference-to-video"', images: { max: 9 }, videos: { max: 3 }, audios: { max: 3 } }]
+    },
+    params: [
+        {
+            id: 'falMiniMaxH3MaxVersion', type: 'dropdown', order: 1,
+            default: 'max',
+            options: [{ value: 'max' }, { value: 'turbo' }]
+        },
+        {
+            id: 'falMiniMaxH3MaxMode', type: 'dropdown', order: 2,
+            default: 'text-image-to-video',
+            options: [{ value: 'text-image-to-video' }, { value: 'reference-to-video' }]
+        },
+        {
+            id: 'falMiniMaxH3MaxAspectRatio', type: 'dropdown', order: 3,
+            default: 'smart',
+            visible: { condition: (params) => reference(params) || !hasUploadedImage(params) },
+            options: [{ value: 'smart' }, ...RATIOS.map((value) => ({ value }))]
+        },
+        {
+            id: 'falMiniMaxH3MaxResolution', type: 'dropdown', order: 4,
+            default: '768P',
+            options: [{ value: '480P' }, { value: '768P' }, { value: '1080P' }]
+        },
+        {
+            id: 'falMiniMaxH3MaxDuration', type: 'number', order: 5,
+            default: 5, min: 1, max: 15, step: 1
+        },
+        {
+            id: 'falMiniMaxH3MaxPromptExpansion', type: 'dropdown', order: 6,
+            default: 'balanced',
+            options: [{ value: 'balanced' }, { value: 'quality' }, { value: 'disabled' }]
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            const family = params.falMiniMaxH3MaxVersion === 'turbo' ? 'minimax/h3-max-turbo' : 'minimax/h3-max';
+            if (reference(params))
+                return `${family}/reference-to-video`;
+            return hasUploadedImage(params) ? `${family}/image-to-video` : `${family}/text-to-video`;
+        }
+    },
+    request: {
+        builder: (params) => {
+            const prompt = typeof params.prompt === 'string' ? params.prompt.trim().slice(0, 50000) : '';
+            if (!prompt)
+                throw new Error('MiniMax H3 Max 的提示词不能为空');
+            const images = resolveUploadedImageSources(params);
+            const body = {
+                prompt,
+                duration: duration(params),
+                resolution: resolution(params),
+                prompt_expansion_mode: ['quality', 'disabled'].includes(String(params.falMiniMaxH3MaxPromptExpansion))
+                    ? String(params.falMiniMaxH3MaxPromptExpansion) : 'balanced'
+            };
+            if (reference(params)) {
+                const videos = resolveUploadedVideoSources(params);
+                const audios = audioSources(params);
+                if (images.length + videos.length + audios.length > 12)
+                    throw new Error('MiniMax H3 Max 的参考素材总数不能超过 12 个');
+                body.aspect_ratio = String(params.falMiniMaxH3MaxAspectRatio || 'smart') === 'smart' ? 'adaptive' : ratio(params);
+                if (images.length > 0)
+                    body.reference_image_urls = images.slice(0, 9);
+                if (videos.length > 0)
+                    body.reference_video_urls = videos.slice(0, 3);
+                if (audios.length > 0)
+                    body.reference_audio_urls = audios.slice(0, 3);
+                return body;
+            }
+            if (images.length > 0) {
+                body.image_url = images[0];
+                if (images.length > 1)
+                    body.end_image_url = images[1];
+                return body;
+            }
+            body.aspect_ratio = ratio(params);
+            return body;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            // Turbo 的参考生视频与 Max 同价。
+            const tier = params.falMiniMaxH3MaxVersion === 'turbo' && !reference(params) ? RATES.turbo : RATES.max;
+            return tier[resolution(params)] * duration(params);
+        },
+        description: 'Max：480P/768P/1080P $0.05/$0.08/$0.16 每秒；Turbo：$0.025/$0.04/$0.08 每秒（参考生视频与 Max 同价）；参考素材超出 4096 token 额度后另计；按 11 月 16 日起的标准价估算'
+    }
+});
+export default falMiniMaxH3MaxModel;

package/dist/catalog/fal/minimax-h3.model.js

@@ -2,9 +2,9 @@ import { defineModel } from "../defineModel.js";
 import { countUploadedImages, hasUploadedImage, resolveUploadedImageSources, resolveUploadedVideoSources } from "../shared/mediaPresence.js";
 export const falMiniMaxH3Model = defineModel({
     meta: {
-        id: 'fal-ai-minimax-h3', canonicalModelId: 'minimax-h3', seriesId: 'minimax-hailuo', seriesRank: 3,
+        id: 'fal-ai-minimax-h3', canonicalModelId: 'minimax-h3', seriesId: 'hailuo', seriesRank: 3,
         provider: 'fal', type: 'video',
-        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode', 'mixed-upload-mode', 'multi-mode-switch', 'supports-4k', 'provider-fal'],
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode'],
         aliases: ['minimax-h3-fal'], polling: { interval: 3000, maxAttempts: 300, expectedAttempts: 75 }
     },
     inputLimits: {
@@ -105,8 +105,7 @@ export const falMiniMaxH3Model = defineModel({
                 prompt: typeof params.prompt === 'string' ? params.prompt.trim().slice(0, 7000) : '',
                 duration: Math.min(15, Math.max(5, Math.round(Number(params.falMiniMaxH3Duration || 5)))),
                 resolution,
-                enable_prompt_expansion: params.falMiniMaxH3PromptExpansion !== false,
-                prompt_expansion_mode: ['fast', 'quality'].includes(String(params.falMiniMaxH3PromptExpansionMode))
+                prompt_expansion_mode: params.falMiniMaxH3PromptExpansion === false ? 'disabled' : ['fast', 'quality'].includes(String(params.falMiniMaxH3PromptExpansionMode))
                     ? String(params.falMiniMaxH3PromptExpansionMode)
                     : 'balanced',
                 enable_safety_checker: true

package/dist/catalog/fal/minimax-speech-2.8.model.js

@@ -4,7 +4,7 @@ export const falMinimaxSpeech28Model = defineModel({
     meta: {
         id: 'fal-minimax-speech-2.8', canonicalModelId: 'minimax-speech-2.8',
         provider: 'fal', type: 'audio',
-        tags: ['text-to-audio', 'provider-fal'],
+        tags: ['text-to-audio'],
         polling: { interval: 3000, maxAttempts: 120, expectedAttempts: 20 },
     },
     inputLimits: { images: { max: 0 }, videos: { max: 0 } },

package/dist/catalog/fal/nano-banana-2.1.model.d.ts

@@ -0,0 +1,2 @@
+export declare const falNanoBanana21Model: import("../../index.js").ModelRuntimeDefinition;
+export default falNanoBanana21Model;

package/dist/catalog/fal/nano-banana-2.1.model.js

@@ -0,0 +1,68 @@
+import { defineModel } from '../defineModel.js';
+import { resolveUploadedImageSources, resolveUploadedVideoSources } from '../shared/mediaPresence.js';
+import { NANO21_RATIOS, NANO21_RESOLUTIONS, nano21Choice, nano21Count, nano21Options, nano21Prompt, nano21Ratio } from '../shared/nanoBanana21.js';
+function pdfSource(params) {
+    const values = params.falNanoBanana21Pdf;
+    if (values === undefined)
+        return undefined;
+    if (!Array.isArray(values) || values.length > 1 || values.some(v => typeof v !== 'string'))
+        throw new Error('PDF 上下文需要上传一份文件');
+    return values.find((v) => typeof v === 'string' && v.trim().length > 0);
+}
+export const falNanoBanana21Model = defineModel({
+    meta: {
+        id: 'fal-ai-nano-banana-2.1', canonicalModelId: 'nano-banana-2.1', seriesId: 'nano-banana', seriesRank: 2.1,
+        provider: 'fal', type: 'image',
+        tags: ['text-to-image', 'image-to-image'],
+        polling: { interval: 3000, maxAttempts: 200, expectedAttempts: 40 },
+    },
+    inputLimits: { images: {}, videos: { max: 1 }, audios: { max: 0 }, rules: [{ videoConstraints: { maxSizeMB: 15 } }] },
+    params: [
+        { id: 'falNanoBanana21AspectRatio', type: 'dropdown', order: 1, default: 'smart', options: nano21Options(['smart', ...NANO21_RATIOS]) },
+        { id: 'falNanoBanana21Resolution', type: 'dropdown', order: 2, default: '1K', options: nano21Options(NANO21_RESOLUTIONS) },
+        { id: 'falNanoBanana21NumImages', type: 'number', order: 3, default: 1, min: 1, max: 4, step: 1 },
+        { id: 'falNanoBanana21WebSearch', type: 'switch', order: 4, default: false },
+        { id: 'falNanoBanana21Thinking', type: 'dropdown', order: 5, default: 'medium', options: nano21Options(['minimal', 'medium', 'high']) },
+        { id: 'falNanoBanana21Pdf', type: 'file-upload', order: 6, default: [], valueType: 'array', maxCount: 1, accept: ['application/pdf'], maxSize: 15 * 1024 * 1024 },
+        { id: 'falNanoBanana21SystemPrompt', type: 'text', order: 7, default: '' },
+        { id: 'falNanoBanana21OutputFormat', type: 'dropdown', order: 8, default: 'png', options: nano21Options(['png', 'jpeg', 'webp']) },
+        { id: 'falNanoBanana21LimitGenerations', type: 'switch', order: 9, default: true },
+    ],
+    runtimeConstraints: { mediaFields: [{ field: 'pdf_url', kind: 'file' }] },
+    endpoints: { selector: async (params) => resolveUploadedImageSources(params).length || resolveUploadedVideoSources(params).length || pdfSource(params)
+            ? 'google/nano-banana-2.1/edit' : 'google/nano-banana-2.1' },
+    request: { builder: params => {
+            const images = resolveUploadedImageSources(params);
+            const videos = resolveUploadedVideoSources(params);
+            if (videos.length > 1)
+                throw new Error('Nano Banana 2.1 Fal 最多支持一段参考视频（15MB）');
+            const body = {
+                prompt: nano21Prompt(params), aspect_ratio: nano21Ratio(params.falNanoBanana21AspectRatio),
+                resolution: nano21Choice(params.falNanoBanana21Resolution, NANO21_RESOLUTIONS, '1K'),
+                num_images: nano21Count(params.falNanoBanana21NumImages, 4),
+                thinking_level: nano21Choice(params.falNanoBanana21Thinking, ['minimal', 'medium', 'high'], 'medium'),
+                output_format: nano21Choice(params.falNanoBanana21OutputFormat, ['png', 'jpeg', 'webp'], 'png'),
+                enable_web_search: params.falNanoBanana21WebSearch === true,
+                limit_generations: params.falNanoBanana21LimitGenerations !== false,
+            };
+            if (images.length)
+                body.image_urls = images;
+            if (videos.length)
+                body.video_url = videos[0];
+            const pdf = pdfSource(params);
+            if (pdf)
+                body.pdf_url = pdf;
+            if (typeof params.falNanoBanana21SystemPrompt === 'string' && params.falNanoBanana21SystemPrompt.trim())
+                body.system_prompt = params.falNanoBanana21SystemPrompt;
+            return body;
+        } },
+    pricing: {
+        currency: '$', calculator: params => {
+            // Fal 官方约 100 Token 短提示词、medium 思考的代表性成本；不是按张固定收费。
+            const representative = { '1K': 0.04, '2K': 0.059, '4K': 0.134 }[String(params.falNanoBanana21Resolution ?? '1K')] ?? 0.04;
+            return (representative + resolveUploadedImageSources(params).length * 0.002) * nano21Count(params.falNanoBanana21NumImages, 4);
+        },
+        description: '按实际 Token 计费：每百万输入 $1.764、文字/思考输出 $8.823、图像输出 $35.294。短提示词与 medium 思考参考估算 1K $0.040、2K $0.059、4K $0.134；每张 1K 参考图约增 $0.002。搜索、思考没有固定附加费，视频/PDF/搜索内容及长提示词按实际用量结算。',
+    },
+});
+export default falNanoBanana21Model;

package/dist/catalog/fal/nano-banana-2.model.js

@@ -4,7 +4,7 @@ export const falNanoBanana2Model = defineModel({
     meta: {
         id: 'fal-ai-nano-banana-2', canonicalModelId: 'nano-banana-2', seriesId: 'nano-banana', seriesRank: 2,
         provider: 'fal', type: 'image',
-        tags: ['text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'supports-4k', 'provider-fal'],
+        tags: ['text-to-image', 'image-to-image'],
         aliases: ['nano-banana-2-fal'], polling: { interval: 3000, maxAttempts: 200, expectedAttempts: 40 }
     },
     inputLimits: { images: { max: 14 }, videos: { max: 1 }, audios: { max: 1 } },

package/dist/catalog/fal/nano-banana-pro.model.js

@@ -4,7 +4,7 @@ export const nanoBananaProModel = defineModel({
     meta: {
         id: 'fal-ai-nano-banana-pro', canonicalModelId: 'nano-banana-pro', seriesId: 'nano-banana', seriesRank: 3,
         provider: 'fal', type: 'image',
-        tags: ['text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'supports-4k', 'provider-fal'],
+        tags: ['text-to-image', 'image-to-image'],
         aliases: ['nano-banana-pro-fal'], polling: { interval: 3000, maxAttempts: 200, expectedAttempts: 40 }
     },
     inputLimits: { images: { max: 14 }, videos: { max: 0 } },

package/dist/catalog/fal/nano-banana.model.js

@@ -7,7 +7,7 @@ export const nanoBananaModel = defineModel({
         seriesRank: 1,
         provider: 'fal',
         type: 'image',
-        tags: ['image', 'text-to-image', 'image-to-image']
+        tags: ['text-to-image', 'image-to-image']
     },
     params: [
         // 1. 生成数量

package/dist/catalog/fal/pixverse-v5.5.model.js

@@ -1,4 +1,5 @@
 import { defineModel } from "../defineModel.js";
+import { countUploadedImages } from "../shared/mediaPresence.js";
 export const pixverseV55Model = defineModel({
     meta: {
         id: 'fal-ai-pixverse-v5.5',
@@ -7,7 +8,7 @@ export const pixverseV55Model = defineModel({
         seriesRank: 5.5,
         provider: 'fal',
         type: 'video',
-        tags: ['video', 'text-to-video', 'image-to-video', 'start-end-frame']
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame']
     },
     inputLimits: {
         images: { max: 2 },
@@ -19,6 +20,8 @@ export const pixverseV55Model = defineModel({
             order: 1,
             type: 'dropdown',
             default: '16:9',
+            // 单图生视频跟随图片比例（官方图生视频端点没有比例字段）。
+            visible: { condition: (params) => countUploadedImages(params) !== 1 },
             options: [
                 { value: 'smart' },
                 { value: '16:9' },
@@ -85,7 +88,9 @@ export const pixverseV55Model = defineModel({
             id: 'pixverseMultiClip',
             order: 7,
             type: 'switch',
-            default: false
+            default: false,
+            // 首尾帧转场端点没有多镜头开关。
+            visible: { condition: (params) => countUploadedImages(params) < 2 }
         }
     ],
     endpoints: {
@@ -116,7 +121,7 @@ export const pixverseV55Model = defineModel({
             const resolution = params.pixverseResolution;
             const duration = params.falPixverse55VideoDuration || 5;
             const requestData = { prompt };
-            if (aspectRatio && aspectRatio !== 'smart' && aspectRatio !== 'auto') {
+            if (images.length !== 1 && aspectRatio && aspectRatio !== 'smart' && aspectRatio !== 'auto') {
                 requestData.aspect_ratio = aspectRatio;
             }
             if (resolution) {
@@ -130,7 +135,7 @@ export const pixverseV55Model = defineModel({
                 requestData.thinking_type = params.pixverseThinkingType;
             }
             requestData.generate_audio_switch = params.pixverseGenerateAudio !== false;
-            if (params.pixverseMultiClip !== undefined) {
+            if (images.length < 2 && params.pixverseMultiClip !== undefined) {
                 requestData.generate_multi_clip_switch = params.pixverseMultiClip;
             }
             if (images.length === 1) {

package/dist/catalog/fal/qwen-image-3.0.model.js

@@ -5,10 +5,10 @@ export const falQwenImage30Model = defineModel({
     meta: {
         id: 'fal-ai-qwen-image-3.0', canonicalModelId: 'qwen-image-3.0', seriesId: 'qwen-image', seriesRank: 3,
         provider: 'fal', type: 'image',
-        tags: ['text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'supports-prompt-expansion', 'provider-fal'],
+        tags: ['text-to-image', 'image-to-image'],
         aliases: ['qwen-image-3-fal'], polling: { interval: 3000, maxAttempts: 180, expectedAttempts: 35 }
     },
-    inputLimits: { images: { max: 3 }, videos: { max: 0 } },
+    inputLimits: { images: { max: 3 }, videos: { max: 0 }, rules: [{ imageConstraints: { minShortSidePx: 384, maxLongSidePx: 2048 } }] },
     params: [
         {
             id: 'falQwenImage30AspectRatio', type: 'dropdown', order: 1,

package/dist/catalog/fal/qwen3-tts-1.7b.model.js

@@ -3,7 +3,7 @@ import { speechCharacterPrice, speechNumber, speechString, speechText } from '..
 export const falQwen3Tts17bModel = defineModel({
     meta: {
         id: 'fal-qwen3-tts-1.7b', canonicalModelId: 'qwen3-tts-1.7b', provider: 'fal', type: 'audio',
-        tags: ['text-to-audio', 'provider-fal'],
+        tags: ['text-to-audio'],
         polling: { interval: 3000, maxAttempts: 120, expectedAttempts: 20 },
     },
     inputLimits: { images: { max: 0 }, videos: { max: 0 } },
@@ -11,7 +11,8 @@ export const falQwen3Tts17bModel = defineModel({
         { id: 'falQwen3TtsVoice', type: 'dropdown', order: 1, default: 'Vivian', options: ['Vivian', 'Serena', 'Uncle_Fu', 'Dylan', 'Eric', 'Ryan', 'Aiden', 'Ono_Anna', 'Sohee'].map(value => ({ value })) },
         { id: 'falQwen3TtsLanguage', type: 'dropdown', order: 2, default: 'Auto', options: ['Auto', 'English', 'Chinese', 'Spanish', 'French', 'German', 'Italian', 'Japanese', 'Korean', 'Portuguese', 'Russian'].map(value => ({ value })) },
         { id: 'falQwen3TtsStyle', type: 'text', order: 3, default: '' },
-        { id: 'falQwen3TtsTemperature', type: 'number', order: 4, default: 0.9, min: 0, max: 2, step: 0.1 },
+        // 官方取值大于 0、不超过 1。旧工程存的范围外的值由展示层联动在提交前改回边界。
+        { id: 'falQwen3TtsTemperature', type: 'number', order: 4, default: 0.9, min: 0.1, max: 1, step: 0.1 },
     ],
     endpoints: 'fal-ai/qwen-3-tts/text-to-speech/1.7b',
     request: {
@@ -20,7 +21,7 @@ export const falQwen3Tts17bModel = defineModel({
                 text: speechText(params),
                 voice: speechString(params.falQwen3TtsVoice) ?? 'Vivian',
                 language: speechString(params.falQwen3TtsLanguage) ?? 'Auto',
-                temperature: speechNumber(params.falQwen3TtsTemperature) ?? 0.9,
+                temperature: Math.min(1, Math.max(0.1, speechNumber(params.falQwen3TtsTemperature) ?? 0.9)),
             };
             const style = speechString(params.falQwen3TtsStyle);
             if (style)

package/dist/catalog/fal/seedance-2.0-fast.model.js

@@ -3,7 +3,7 @@ export const falSeedance20FastModel = defineModel({
     meta: {
         id: 'fal-ai-seedance-2.0-fast', canonicalModelId: 'seedance-2.0-fast', seriesId: 'seedance', seriesRank: 2.01,
         provider: 'fal', type: 'video',
-        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode', 'mixed-upload-mode', 'supports-audio-generation', 'multi-mode-switch', 'fast-mode', 'provider-fal'],
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode'],
         aliases: ['seedance-2-fast-fal'], polling: { interval: 3000, maxAttempts: 320, expectedAttempts: 75 }
     },
     inputLimits: {

package/dist/catalog/fal/seedance-2.0-mini.model.js

@@ -3,7 +3,7 @@ export const falSeedance20MiniModel = defineModel({
     meta: {
         id: 'fal-ai-seedance-2.0-mini', canonicalModelId: 'seedance-2.0-mini', seriesId: 'seedance', seriesRank: 2.001,
         provider: 'fal', type: 'video',
-        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode', 'mixed-upload-mode', 'supports-audio-generation', 'multi-mode-switch', 'fast-mode', 'provider-fal'],
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode'],
         aliases: ['seedance-2-mini-fal'], polling: { interval: 3000, maxAttempts: 300, expectedAttempts: 65 }
     },
     inputLimits: {

package/dist/catalog/fal/seedance-2.0.model.js

@@ -3,7 +3,7 @@ export const falSeedance20Model = defineModel({
     meta: {
         id: 'fal-ai-seedance-2.0', canonicalModelId: 'seedance-2.0', seriesId: 'seedance', seriesRank: 2,
         provider: 'fal', type: 'video',
-        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode', 'mixed-upload-mode', 'supports-audio-generation', 'multi-mode-switch', 'supports-4k', 'provider-fal'],
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode'],
         aliases: ['seedance-2-fal'], polling: { interval: 3000, maxAttempts: 360, expectedAttempts: 90 }
     },
     inputLimits: {