@henjicc/ai-sdk 0.2.8

package/dist/catalog/fal/kling-video-v2.6-pro.model.js

@@ -0,0 +1,231 @@
+import { defineModel } from "../defineModel.js";
+import { hasUploadedImage } from "../shared/mediaPresence.js";
+export const klingVideoV26ProModel = defineModel({
+    meta: {
+        id: 'fal-ai-kling-video-v2.6-pro',
+        canonicalModelId: 'kling-video-2.6-pro',
+        seriesId: 'kling-video',
+        seriesRank: 2.6,
+        provider: 'fal',
+        type: 'video',
+        tags: ['video', 'text-to-video', 'image-to-video', 'motion-control']
+    },
+    inputLimits: {
+        images: { max: 1 },
+        videos: { max: 0 },
+        rules: [
+            {
+                when: 'falKlingV26ProMode === "motion-control"',
+                images: { exact: 1 },
+                videos: { exact: 1 },
+                videoConstraints: {
+                    maxSizeMB: 100,
+                    minDurationSec: 3,
+                    maxDurationSec: 30
+                }
+            }
+        ]
+    },
+    requirements: [
+        {
+            id: 'kling-v26-motion-image',
+            when: 'falKlingV26ProMode === "motion-control"',
+            require: { images: { exact: 1 } },
+            message: {
+                title: '图片必需',
+                message: '动作控制模式需要上传1张图片（不能多也不能少）',
+                type: 'warning'
+            }
+        },
+        {
+            id: 'kling-v26-motion-video',
+            when: 'falKlingV26ProMode === "motion-control"',
+            require: { videos: { exact: 1 } },
+            message: {
+                title: '视频必需',
+                message: '动作控制模式需要上传1个视频（不能多也不能少）',
+                type: 'warning'
+            }
+        }
+    ],
+    params: [
+        {
+            id: 'falKlingV26ProMode',
+            order: 1,
+            type: 'dropdown',
+            default: 'text-image-to-video',
+            options: [
+                { value: 'text-image-to-video' },
+                { value: 'motion-control' }
+            ]
+        },
+        {
+            id: 'falKlingV26ProResolution',
+            order: 2,
+            type: 'dropdown',
+            default: '720p',
+            visible: {
+                condition: 'falKlingV26ProMode === "motion-control"'
+            },
+            options: [
+                { value: '720p' },
+                { value: '1080p' }
+            ]
+        },
+        {
+            id: 'falKlingV26ProCharacterOrientation',
+            order: 3,
+            type: 'dropdown',
+            default: 'video',
+            visible: {
+                condition: 'falKlingV26ProMode === "motion-control"'
+            },
+            options: [
+                { value: 'video' },
+                { value: 'image' }
+            ]
+        },
+        {
+            id: 'falKlingV26ProKeepOriginalSound',
+            order: 4,
+            type: 'switch',
+            default: true,
+            visible: {
+                condition: 'falKlingV26ProMode === "motion-control"'
+            }
+        },
+        {
+            id: 'falKlingV26ProVideoDuration',
+            order: 5,
+            type: 'dropdown',
+            default: 5,
+            visible: {
+                condition: 'falKlingV26ProMode !== "motion-control"'
+            },
+            options: [
+                { value: 5 },
+                { value: 10 }
+            ]
+        },
+        {
+            id: 'falKlingV26ProAspectRatio',
+            order: 6,
+            type: 'dropdown',
+            default: '16:9',
+            visible: {
+                condition: (params) => params.falKlingV26ProMode !== 'motion-control' &&
+                    !hasUploadedImage(params)
+            },
+            options: [
+                { value: '16:9' },
+                { value: '9:16' },
+                { value: '1:1' }
+            ]
+        },
+        {
+            id: 'falKlingV26ProCfgScale',
+            order: 7,
+            type: 'number',
+            default: 0.5,
+            min: 0,
+            max: 1,
+            step: 0.1,
+            visible: {
+                condition: (params) => params.falKlingV26ProMode !== 'motion-control' &&
+                    !hasUploadedImage(params)
+            }
+        },
+        {
+            id: 'falKlingV26ProGenerateAudio',
+            order: 8,
+            type: 'switch',
+            default: true,
+            visible: {
+                condition: 'falKlingV26ProMode !== "motion-control"'
+            }
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            const mode = params.falKlingV26ProMode || 'text-image-to-video';
+            if (mode === 'motion-control') {
+                const resolution = params.falKlingV26ProResolution || '720p';
+                return resolution === '1080p'
+                    ? 'fal-ai/kling-video/v2.6/pro/motion-control'
+                    : 'fal-ai/kling-video/v2.6/standard/motion-control';
+            }
+            const filterSources = (value) => Array.isArray(value)
+                ? value.filter((item) => typeof item === 'string' && item.trim().length > 0)
+                : [];
+            const uploadedImages = filterSources(params.uploadedFilePaths);
+            const images = uploadedImages.length > 0 ? uploadedImages : filterSources(params.images);
+            return images.length > 0
+                ? 'fal-ai/kling-video/v2.6/pro/image-to-video'
+                : 'fal-ai/kling-video/v2.6/pro/text-to-video';
+        }
+    },
+    request: {
+        builder: (params) => {
+            const mode = params.falKlingV26ProMode || 'text-image-to-video';
+            const filterSources = (value) => Array.isArray(value)
+                ? value.filter((item) => typeof item === 'string' && item.trim().length > 0)
+                : [];
+            const uploadedImages = filterSources(params.uploadedFilePaths);
+            const images = uploadedImages.length > 0 ? uploadedImages : filterSources(params.images);
+            const uploadedVideos = filterSources(params.uploadedVideoFilePaths);
+            const videos = uploadedVideos.length > 0 ? uploadedVideos : filterSources(params.videos);
+            const prompt = params.prompt || '';
+            const duration = params.falKlingV26ProVideoDuration || 5;
+            const aspectRatio = params.falKlingV26ProAspectRatio || '16:9';
+            const generateAudio = params.falKlingV26ProGenerateAudio !== false;
+            const cfgScale = params.falKlingV26ProCfgScale;
+            const characterOrientation = params.falKlingV26ProCharacterOrientation || 'video';
+            const keepOriginalSound = params.falKlingV26ProKeepOriginalSound !== false;
+            const videoInput = typeof params.video === 'string' ? params.video : videos[0];
+            if (mode === 'motion-control') {
+                const requestData = {
+                    image_url: images[0],
+                    video_url: videoInput,
+                    character_orientation: characterOrientation,
+                    keep_original_sound: keepOriginalSound
+                };
+                if (prompt) {
+                    requestData.prompt = prompt;
+                }
+                return requestData;
+            }
+            const requestData = {
+                prompt,
+                duration: `${duration}`,
+                generate_audio: generateAudio
+            };
+            if (images.length > 0) {
+                requestData.image_url = images[0];
+            }
+            else {
+                if (aspectRatio && aspectRatio !== 'auto') {
+                    requestData.aspect_ratio = aspectRatio;
+                }
+                if (cfgScale !== undefined) {
+                    requestData.cfg_scale = cfgScale;
+                }
+            }
+            return requestData;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const mode = params.falKlingV26ProMode || 'text-image-to-video';
+            const duration = Number(params.falKlingV26ProVideoDuration) || 5;
+            if (mode === 'motion-control') {
+                const resolution = params.falKlingV26ProResolution || '720p';
+                return (resolution === '1080p' ? 0.112 : 0.07) * duration;
+            }
+            const generateAudio = params.falKlingV26ProGenerateAudio !== false;
+            return (generateAudio ? 0.14 : 0.07) * duration;
+        },
+        description: '无音频 $0.07/秒，有音频 $0.14/秒；动作控制 720p $0.07/秒，1080p $0.112/秒'
+    }
+});
+export default klingVideoV26ProModel;

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

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

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

@@ -0,0 +1,221 @@
+import { defineModel } from "../defineModel.js";
+export const ltx2Model = defineModel({
+    meta: {
+        id: 'fal-ai-ltx-2',
+        canonicalModelId: 'ltx-2',
+        provider: 'fal',
+        type: 'video',
+        tags: ['video', 'text-to-video', 'image-to-video']
+    },
+    inputLimits: {
+        images: { max: 0 },
+        videos: { max: 0 },
+        rules: [
+            {
+                when: 'falLtx2Mode === "image-to-video"',
+                images: { max: 1 }
+            },
+            {
+                when: 'falLtx2Mode === "retake-video"',
+                images: { max: 0 },
+                videos: { exact: 1 }
+            }
+        ]
+    },
+    requirements: [
+        {
+            id: 'ltx-2-retake-video',
+            when: 'falLtx2Mode === "retake-video"',
+            require: { videos: { exact: 1 } },
+            message: {
+                title: '视频必需',
+                message: '视频编辑模式需要上传1个视频才能生成',
+                type: 'warning'
+            }
+        }
+    ],
+    params: [
+        {
+            id: 'falLtx2Mode',
+            order: 1,
+            type: 'dropdown',
+            default: 'text-to-video',
+            options: [
+                { value: 'text-to-video' },
+                { value: 'image-to-video' },
+                { value: 'retake-video' }
+            ]
+        },
+        {
+            id: 'falLtx2Resolution',
+            order: 2,
+            type: 'dropdown',
+            default: '1080p',
+            visible: {
+                condition: 'falLtx2Mode !== "retake-video"'
+            },
+            options: [
+                { value: '1080p' },
+                { value: '1440p' },
+                { value: '2160p' }
+            ]
+        },
+        {
+            id: 'falLtx2VideoDuration',
+            order: 3,
+            type: 'dropdown',
+            default: 6,
+            visible: {
+                condition: 'falLtx2Mode !== "retake-video"'
+            },
+            options: [
+                { value: 6 },
+                { value: 8 },
+                { value: 10 }
+            ]
+        },
+        {
+            id: 'falLtx2RetakeDuration',
+            order: 4,
+            type: 'number',
+            default: 5,
+            min: 2,
+            max: 20,
+            step: 1,
+            visible: {
+                condition: 'falLtx2Mode === "retake-video"'
+            }
+        },
+        {
+            id: 'falLtx2Fps',
+            order: 5,
+            type: 'dropdown',
+            default: 25,
+            visible: {
+                condition: 'falLtx2Mode !== "retake-video"'
+            },
+            options: [
+                { value: 25 },
+                { value: 50 }
+            ]
+        },
+        {
+            id: 'falLtx2GenerateAudio',
+            order: 6,
+            type: 'switch',
+            default: true,
+            visible: {
+                condition: 'falLtx2Mode !== "retake-video"'
+            }
+        },
+        {
+            id: 'falLtx2FastMode',
+            order: 7,
+            type: 'switch',
+            default: true,
+            visible: {
+                condition: 'falLtx2Mode !== "retake-video"'
+            }
+        },
+        {
+            id: 'falLtx2RetakeStartTime',
+            order: 8,
+            type: 'number',
+            default: 0,
+            min: 0,
+            max: 20,
+            step: 1,
+            visible: {
+                condition: 'falLtx2Mode === "retake-video"'
+            }
+        },
+        {
+            id: 'falLtx2RetakeMode',
+            order: 9,
+            type: 'dropdown',
+            default: 'replace_audio_and_video',
+            visible: {
+                condition: 'falLtx2Mode === "retake-video"'
+            },
+            options: [
+                { value: 'replace_audio' },
+                { value: 'replace_video' },
+                { value: 'replace_audio_and_video' }
+            ]
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            const mode = params.falLtx2Mode || 'text-to-video';
+            const fastMode = params.falLtx2FastMode !== false;
+            if (mode === 'retake-video') {
+                return 'fal-ai/ltx-2/retake-video';
+            }
+            if (mode === 'image-to-video') {
+                return fastMode ? 'fal-ai/ltx-2/image-to-video/fast' : 'fal-ai/ltx-2/image-to-video';
+            }
+            return fastMode ? 'fal-ai/ltx-2/text-to-video/fast' : 'fal-ai/ltx-2/text-to-video';
+        }
+    },
+    request: {
+        builder: (params) => {
+            const mode = params.falLtx2Mode || 'text-to-video';
+            const filterSources = (value) => Array.isArray(value)
+                ? value.filter((item) => typeof item === 'string' && item.trim().length > 0)
+                : [];
+            const uploadedImages = filterSources(params.uploadedFilePaths);
+            const images = uploadedImages.length > 0 ? uploadedImages : filterSources(params.images);
+            const uploadedVideos = filterSources(params.uploadedVideoFilePaths);
+            const videos = uploadedVideos.length > 0 ? uploadedVideos : filterSources(params.videos);
+            const prompt = params.prompt || '';
+            const duration = params.falLtx2VideoDuration || 6;
+            const resolution = params.falLtx2Resolution || '1080p';
+            const fps = params.falLtx2Fps || 25;
+            const generateAudio = params.falLtx2GenerateAudio !== false;
+            const retakeStartTime = params.falLtx2RetakeStartTime || 0;
+            const retakeMode = params.falLtx2RetakeMode || 'replace_audio_and_video';
+            const retakeDuration = params.falLtx2RetakeDuration || duration;
+            const videoInput = typeof params.video === 'string' ? params.video : videos[0];
+            if (mode === 'retake-video') {
+                return {
+                    prompt,
+                    video_url: videoInput,
+                    start_time: retakeStartTime,
+                    duration: retakeDuration,
+                    retake_mode: retakeMode
+                };
+            }
+            const requestData = {
+                prompt,
+                duration,
+                resolution,
+                aspect_ratio: '16:9',
+                fps,
+                generate_audio: generateAudio
+            };
+            if (mode === 'image-to-video' && images.length > 0) {
+                requestData.image_url = images[0];
+            }
+            return requestData;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const mode = params.falLtx2Mode || 'text-to-video';
+            if (mode === 'retake-video') {
+                const retakeDuration = Number(params.falLtx2RetakeDuration) || 5;
+                return 0.1 * retakeDuration;
+            }
+            const duration = Number(params.falLtx2VideoDuration) || 6;
+            const fastMode = params.falLtx2FastMode !== false;
+            const resolution = params.falLtx2Resolution || '1080p';
+            const ratePerSecond = fastMode
+                ? { '1080p': 0.04, '1440p': 0.08, '2160p': 0.16 }
+                : { '1080p': 0.06, '1440p': 0.12, '2160p': 0.24 };
+            return (ratePerSecond[resolution] ?? ratePerSecond['1080p']) * duration;
+        },
+        description: '快速：1080p $0.04/秒、1440p $0.08/秒、2160p $0.16/秒；标准：1080p $0.06/秒、1440p $0.12/秒、2160p $0.24/秒；视频重拍 $0.10/秒'
+    }
+});
+export default ltx2Model;

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

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

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

@@ -0,0 +1,154 @@
+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,
+        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'],
+        aliases: ['minimax-h3-fal'], polling: { interval: 3000, maxAttempts: 300, expectedAttempts: 75 }
+    },
+    inputLimits: {
+        images: { max: 2 }, videos: { max: 0 }, audios: { max: 0 },
+        rules: [{ when: 'falMiniMaxH3Mode === "reference-to-video"', images: { max: 9 }, videos: { max: 3 }, audios: { max: 3 } }]
+    },
+    params: [
+        {
+            id: 'falMiniMaxH3Mode', type: 'dropdown', order: 1,
+            default: 'text-image-to-video',
+            options: [
+                { value: 'text-image-to-video' },
+                { value: 'reference-to-video' }
+            ]
+        },
+        {
+            id: 'falMiniMaxH3AspectRatio', type: 'dropdown', order: 2,
+            default: 'smart',
+            visible: {
+                condition: (params) => params.falMiniMaxH3Mode === 'reference-to-video' ||
+                    !hasUploadedImage(params)
+            },
+            options: [
+                { value: 'smart' },
+                { value: '21:9' }, { value: '16:9' },
+                { value: '4:3' }, { value: '1:1' },
+                { value: '3:4' }, { value: '9:16' }
+            ]
+        },
+        {
+            id: 'falMiniMaxH3Resolution', type: 'dropdown', order: 3,
+            default: '2K',
+            options: ['480P', '768P', '2K', '4K'].map((value) => ({ value }))
+        },
+        {
+            id: 'falMiniMaxH3Duration', type: 'number', order: 4,
+            default: 5, min: 5, max: 15, step: 1
+        },
+        {
+            id: 'falMiniMaxH3PromptExpansion', type: 'switch', order: 5,
+            default: true
+        },
+        {
+            id: 'falMiniMaxH3PromptExpansionMode', type: 'dropdown', order: 6,
+            default: 'balanced',
+            options: [
+                { value: 'balanced' },
+                { value: 'fast' },
+                { value: 'quality' }
+            ]
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            const images = resolveUploadedImageSources(params);
+            if (params.falMiniMaxH3Mode === 'reference-to-video')
+                return 'minimax/h3/reference-to-video';
+            return images.length > 0 ? 'minimax/h3/image-to-video' : 'minimax/h3/text-to-video';
+        }
+    },
+    request: {
+        builder: (params) => {
+            const clean = (value) => Array.isArray(value)
+                ? value.flatMap((item) => {
+                    if (typeof item !== 'string')
+                        return [];
+                    const source = item.trim();
+                    return source.length > 0 ? [source] : [];
+                }) : [];
+            const pick = (...candidates) => {
+                for (const candidate of candidates) {
+                    const sources = clean(candidate);
+                    if (sources.length > 0)
+                        return sources;
+                }
+                return [];
+            };
+            const images = resolveUploadedImageSources(params);
+            const videos = resolveUploadedVideoSources(params);
+            const audios = pick(params.uploadedAudioFilePaths, params.audios, params.uploadedAudios);
+            const ratios = ['21:9', '16:9', '4:3', '1:1', '3:4', '9:16'];
+            const raw = String(params.falMiniMaxH3AspectRatio || 'smart');
+            const hint = typeof params.__firstImageRatio === 'number' && Number.isFinite(params.__firstImageRatio) && params.__firstImageRatio > 0 ? params.__firstImageRatio : 16 / 9;
+            let ratio = ratios.includes(raw) ? raw : '16:9';
+            if (raw === 'smart' || raw === 'auto') {
+                let difference = Number.POSITIVE_INFINITY;
+                for (const candidate of ratios) {
+                    const pair = candidate.split(':').map(Number);
+                    const next = Math.abs(pair[0] / pair[1] - hint);
+                    if (next < difference) {
+                        difference = next;
+                        ratio = candidate;
+                    }
+                }
+            }
+            const resolution = ['480P', '768P', '4K'].includes(String(params.falMiniMaxH3Resolution)) ? String(params.falMiniMaxH3Resolution) : '2K';
+            const body = {
+                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))
+                    ? String(params.falMiniMaxH3PromptExpansionMode)
+                    : 'balanced',
+                enable_safety_checker: true
+            };
+            if (!body.prompt)
+                throw new Error('MiniMax H3 的提示词不能为空');
+            if (params.falMiniMaxH3Mode === 'reference-to-video') {
+                if (images.length + videos.length + audios.length > 12) {
+                    throw new Error('Fal MiniMax H3 的参考素材总数不能超过 12 个');
+                }
+                if (audios.length > 0 && images.length + videos.length === 0) {
+                    throw new Error('Fal MiniMax H3 的参考音频必须与参考图片或参考视频一起使用');
+                }
+                body.aspect_ratio = raw === 'smart' && (images.length + videos.length) > 0 ? 'adaptive' : ratio;
+                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);
+            }
+            else if (images.length > 0) {
+                body.image_url = images[0];
+                if (images.length > 1)
+                    body.end_image_url = images[1];
+            }
+            else {
+                body.aspect_ratio = ratio;
+            }
+            return body;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const duration = Math.min(15, Math.max(5, Math.round(Number(params.falMiniMaxH3Duration || 5))));
+            const rates = { '480P': 0.05, '768P': 0.06, '2K': 0.13, '4K': 0.16 };
+            const imageCount = countUploadedImages(params);
+            const referenceExtra = params.falMiniMaxH3Mode === 'reference-to-video' ? Math.max(0, imageCount - 5) * 0.08 : 0;
+            return duration * (rates[String(params.falMiniMaxH3Resolution || '2K')] ?? rates['2K']) + referenceExtra;
+        },
+        description: '480P/768P/2K/4K 为 $0.05/$0.06/$0.13/$0.16 每秒；参考模式第 6 张起图片 +$0.08/张'
+    }
+});
+export default falMiniMaxH3Model;

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

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