@henjicc/ai-sdk 0.8.0 → 0.10.0

package/dist/catalog/fal/grok-imagine-video-1.5.model.js

@@ -0,0 +1,121 @@
+import { defineModel } from "../defineModel.js";
+import { countUploadedImages, hasUploadedImage, resolveUploadedImageSources } from "../shared/mediaPresence.js";
+// 价格与字段来源：docs/model-adaptation/Grok-Imagine-Video-1.5/Grok-Imagine-Video-1.5_Fal.md（Fal 模型页与 OpenAPI，2026-11-07 读取）
+const RATIOS = ['16:9', '4:3', '3:2', '1:1', '2:3', '3:4', '9:16'];
+const RATES = {
+    standard: { '480p': 0.08, '720p': 0.14, '1080p': 0.25 },
+    lite: { '480p': 0.02, '720p': 0.03, '1080p': 0.14 }
+};
+function lite(params) {
+    return params.falGrokVideo15Version === 'lite';
+}
+/** 参考生视频只有标准版提供。 */
+function reference(params) {
+    return !lite(params) && params.falGrokVideo15Mode === 'reference-to-video';
+}
+/** 参考生视频只支持 480p/720p。 */
+function resolution(params) {
+    const value = String(params.falGrokVideo15Resolution);
+    const allowed = reference(params) ? ['480p', '720p'] : ['480p', '720p', '1080p'];
+    return allowed.includes(value) ? value : '720p';
+}
+function duration(params) {
+    const value = Math.round(Number(params.falGrokVideo15Duration));
+    return Number.isFinite(value) ? Math.min(15, Math.max(1, value)) : 6;
+}
+function ratio(params) {
+    const raw = String(params.falGrokVideo15AspectRatio || 'smart');
+    if (RATIOS.includes(raw))
+        return raw;
+    const hint = typeof params.__firstImageRatio === 'number' && Number.isFinite(params.__firstImageRatio) && params.__firstImageRatio > 0
+        ? params.__firstImageRatio : 16 / 9;
+    const numeric = (value) => { const [w, h] = value.split(':').map(Number); return w / h; };
+    return RATIOS.reduce((best, next) => Math.abs(numeric(next) - hint) < Math.abs(numeric(best) - hint) ? next : best, '16:9');
+}
+export const falGrokImagineVideo15Model = defineModel({
+    meta: {
+        id: 'fal-ai-grok-imagine-video-1.5', canonicalModelId: 'grok-imagine-video-1.5', seriesId: 'grok-imagine-video', seriesRank: 1.5,
+        provider: 'fal', type: 'video',
+        tags: ['text-to-video', 'image-to-video', 'reference-mode'],
+        polling: { interval: 3000, maxAttempts: 300, expectedAttempts: 40 }
+    },
+    inputLimits: {
+        images: { max: 1 }, videos: { max: 0 }, audios: { max: 0 },
+        rules: [{ when: 'falGrokVideo15Version !== "lite" && falGrokVideo15Mode === "reference-to-video"', images: { min: 1, max: 7 } }]
+    },
+    requirements: [
+        {
+            id: 'fal-grok-video-1.5-reference', when: 'falGrokVideo15Version !== "lite" && falGrokVideo15Mode === "reference-to-video"',
+            require: { images: { min: 1 } },
+            message: { title: '图片必需', message: '参考生视频需要 1–7 张参考图', type: 'warning' }
+        }
+    ],
+    params: [
+        {
+            id: 'falGrokVideo15Version', type: 'dropdown', order: 1,
+            default: 'standard',
+            options: [{ value: 'standard' }, { value: 'lite' }]
+        },
+        {
+            id: 'falGrokVideo15Mode', type: 'dropdown', order: 2,
+            default: 'text-image-to-video',
+            visible: { condition: (params) => !lite(params) },
+            options: [{ value: 'text-image-to-video' }, { value: 'reference-to-video' }]
+        },
+        {
+            id: 'falGrokVideo15AspectRatio', type: 'dropdown', order: 3,
+            default: 'smart',
+            visible: { condition: (params) => reference(params) || !hasUploadedImage(params) },
+            options: [{ value: 'smart' }, ...RATIOS.map((value) => ({ value }))]
+        },
+        {
+            id: 'falGrokVideo15Resolution', type: 'dropdown', order: 4,
+            default: '720p',
+            options: [{ value: '480p' }, { value: '720p' }, { value: '1080p' }]
+        },
+        {
+            id: 'falGrokVideo15Duration', type: 'number', order: 5,
+            default: 6, min: 1, max: 15, step: 1
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            if (reference(params))
+                return 'xai/grok-imagine-video/v1.5/reference-to-video';
+            const family = lite(params) ? 'xai/grok-imagine-video/v1.5/lite' : 'xai/grok-imagine-video/v1.5';
+            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, 4096) : '';
+            if (!prompt)
+                throw new Error('Grok Imagine Video 1.5 的提示词不能为空');
+            const images = resolveUploadedImageSources(params);
+            const body = { prompt, duration: duration(params), resolution: resolution(params) };
+            if (reference(params)) {
+                if (images.length === 0)
+                    throw new Error('Grok Imagine Video 1.5 参考生视频需要至少 1 张参考图');
+                body.reference_image_urls = images.slice(0, 7);
+                body.aspect_ratio = ratio(params);
+            }
+            else if (images.length > 0) {
+                body.image_url = images[0];
+            }
+            else {
+                body.aspect_ratio = ratio(params);
+            }
+            return body;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const rates = lite(params) ? RATES.lite : RATES.standard;
+            const images = reference(params) ? Math.min(7, countUploadedImages(params)) : Math.min(1, countUploadedImages(params));
+            return rates[resolution(params)] * duration(params) + images * 0.01;
+        },
+        description: '标准版 480p/720p/1080p $0.08/$0.14/$0.25 每秒，Lite 版 $0.02/$0.03/$0.14 每秒；每张输入或参考图 +$0.01'
+    }
+});
+export default falGrokImagineVideo15Model;

package/dist/catalog/fal/hailuo-02.model.js

@@ -1,5 +1,9 @@
 import { defineModel } from "../defineModel.js";
 import { countUploadedImages, resolveUploadedImageSources } from "../shared/mediaPresence.js";
+/** MiniMax 首尾帧不支持 512P（官方首尾帧文档原文），带尾帧时按 768P 请求和计价。 */
+function falHailuo02Resolution(params, imageCount) {
+    return params.falHailuo02Resolution === '512P' && imageCount < 2 ? '512P' : '768P';
+}
 export const hailuo02Model = defineModel({
     meta: {
         id: 'fal-ai-minimax-hailuo-02',
@@ -8,7 +12,7 @@ export const hailuo02Model = defineModel({
         seriesRank: 2.0,
         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'],
         aliases: ['fal-ai-hailuo-02', 'minimax-hailuo-02-fal']
     },
     inputLimits: {
@@ -104,7 +108,7 @@ export const hailuo02Model = defineModel({
             const images = resolveUploadedImageSources(params);
             const prompt = params.prompt || '';
             const version = params.falHailuo02Version || 'standard';
-            const resolution = params.falHailuo02Resolution || '768P';
+            const resolution = falHailuo02Resolution(params, images.length);
             const duration = params.falHailuo02Duration || '6';
             const isFastMode = images.length === 1 && params.falHailuo02FastMode === true;
             const promptOptimizer = params.falHailuo02PromptOptimizer !== false;
@@ -143,10 +147,10 @@ export const hailuo02Model = defineModel({
             // Standard 文生视频不接受 resolution，固定按 768P 秒价计费。
             if (imageCount === 0)
                 return 0.045 * duration;
-            const resolution = params.falHailuo02Resolution === '512P' ? '512P' : '768P';
+            const resolution = falHailuo02Resolution(params, imageCount);
             return (resolution === '512P' ? 0.017 : 0.045) * duration;
         },
-        description: 'Standard 文生：$0.045/秒；Standard 图生：768P $0.045/秒、512P $0.017/秒；Fast 图生：512P $0.017/秒；non-fast Pro：固定 1080P、6 秒，$0.48/条'
+        description: 'Standard 文生：$0.045/秒；Standard 图生：768P $0.045/秒、512P $0.017/秒（首尾帧固定 768P）；Fast 图生：512P $0.017/秒；non-fast Pro：固定 1080P、6 秒，$0.48/条'
     }
 });
 export default hailuo02Model;

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

@@ -8,7 +8,7 @@ export const hailuo23Model = defineModel({
         seriesRank: 2.3,
         provider: 'fal',
         type: 'video',
-        tags: ['video', 'text-to-video', 'image-to-video'],
+        tags: ['text-to-video', 'image-to-video'],
         aliases: ['fal-ai-hailuo-2.3', 'minimax-hailuo-2.3-fal']
     },
     inputLimits: {

package/dist/catalog/fal/ic-light-v2.model.js

@@ -20,7 +20,7 @@ export const falIcLightV2Model = defineModel({
         seriesRank: 2,
         provider: 'fal',
         type: 'image',
-        tags: ['image-to-image', 'supports-image-editing', 'relighting', 'provider-fal'],
+        tags: ['image-to-image', 'relighting'],
         aliases: ['ic-light-v2-fal'],
         polling: { interval: 3000, maxAttempts: 200, expectedAttempts: 45 },
     },

package/dist/catalog/fal/ideogram-upscale.model.js

@@ -10,7 +10,7 @@ export const falIdeogramUpscaleModel = defineModel({
         canonicalModelId: 'ideogram-upscale',
         provider: 'fal',
         type: 'image',
-        tags: ['image-to-image', 'upscaling', 'provider-fal'],
+        tags: ['upscaling'],
         polling: { interval: 3000, maxAttempts: 200, expectedAttempts: 45 },
     },
     acceptsPrompt: false,

package/dist/catalog/fal/kling-3.0-omni.model.js

@@ -4,7 +4,7 @@ export const falKling30OmniModel = defineModel({
     meta: {
         id: 'fal-ai-kling-3.0-omni', canonicalModelId: 'kling-video-3.0-omni', seriesId: 'kling-video', seriesRank: 3.02,
         provider: 'fal', type: 'video',
-        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode', 'supports-multi-image', 'supports-audio-generation', 'multi-mode-switch', 'provider-fal'],
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode'],
         aliases: ['kling-o3-fal'], polling: { interval: 3000, maxAttempts: 300, expectedAttempts: 75 }
     },
     inputLimits: {

package/dist/catalog/fal/kling-3.0-turbo.model.js

@@ -1,15 +1,18 @@
 import { defineModel } from "../defineModel.js";
+import { hasUploadedImage } from '../shared/mediaPresence.js';
 export const falKling30TurboModel = defineModel({
     meta: {
         id: 'fal-ai-kling-3.0-turbo', canonicalModelId: 'kling-video-3.0-turbo', seriesId: 'kling-video', seriesRank: 3.01,
         provider: 'fal', type: 'video',
-        tags: ['text-to-video', 'image-to-video', 'fast-mode', 'provider-fal'],
+        tags: ['text-to-video', 'image-to-video'],
         aliases: ['kling-v3-turbo-fal'], polling: { interval: 3000, maxAttempts: 280, expectedAttempts: 65 }
     },
-    inputLimits: { images: { max: 1 }, videos: { max: 0 }, audios: { max: 0 } },
+    inputLimits: { images: { max: 1 }, videos: { max: 0 }, audios: { max: 0 }, rules: [{ imageConstraints: { minShortSidePx: 300, minAspectRatio: 0.4, maxAspectRatio: 2.5 } }] },
     params: [
         {
             id: 'falKling30TurboAspectRatio', type: 'dropdown', order: 1,
+            // 图生视频端点没有比例字段，比例跟随首帧。
+            visible: { condition: (params) => !hasUploadedImage(params) },
             default: 'smart',
             options: [
                 { value: 'smart' },

package/dist/catalog/fal/kling-3.0.model.js

@@ -1,15 +1,18 @@
 import { defineModel } from "../defineModel.js";
+import { hasUploadedImage } from '../shared/mediaPresence.js';
 export const falKling30Model = defineModel({
     meta: {
         id: 'fal-ai-kling-3.0', canonicalModelId: 'kling-video-3.0', seriesId: 'kling-video', seriesRank: 3,
         provider: 'fal', type: 'video',
-        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'supports-audio-generation', 'provider-fal'],
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame'],
         aliases: ['kling-v3-fal'], polling: { interval: 3000, maxAttempts: 300, expectedAttempts: 75 }
     },
     inputLimits: { images: { max: 2 }, videos: { max: 0 }, audios: { max: 0 } },
     params: [
         {
             id: 'falKling30AspectRatio', type: 'dropdown', order: 1,
+            // 图生视频端点没有比例字段，比例跟随首帧。
+            visible: { condition: (params) => !hasUploadedImage(params) },
             default: 'smart',
             options: [
                 { value: 'smart' },

package/dist/catalog/fal/kling-4.0-flash.model.d.ts

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

package/dist/catalog/fal/kling-4.0-flash.model.js

@@ -0,0 +1,132 @@
+import { defineModel } from "../defineModel.js";
+import { hasUploadedImage, hasUploadedVideo, resolveUploadedImageSources, resolveUploadedVideoDurationSeconds, resolveUploadedVideoSources } from "../shared/mediaPresence.js";
+import { buildFalSubjectElements, subjectElementVideoSeconds } from "../shared/subjectElements.js";
+import { KLING_V4_RATIOS, klingV4Duration, klingV4EditSeconds, klingV4Mode, klingV4Prompt, klingV4Ratio } from "./utils/klingV4.js";
+// 价格与字段来源：docs/model-adaptation/Kling-4.0-Flash/Kling-4.0-Flash_Fal.md（Fal 模型页与 OpenAPI，2026-11-07 读取）。
+// Flash 只出 720p，首帧图生视频不收尾帧，参考与编辑不接受声音，也没有分镜。
+const usesElements = (params) => klingV4Mode(params.falKling40FlashMode) !== 'text-image-to-video';
+export const falKling40FlashModel = defineModel({
+    meta: {
+        id: 'fal-ai-kling-4.0-flash', canonicalModelId: 'kling-video-4.0-flash', seriesId: 'kling-video', seriesRank: 4.01,
+        provider: 'fal', type: 'video',
+        tags: ['text-to-video', 'image-to-video', 'reference-mode', 'video-to-video'],
+        polling: { interval: 3000, maxAttempts: 300, expectedAttempts: 50 }
+    },
+    inputLimits: {
+        images: { max: 1 }, videos: { max: 0 }, audios: { max: 0 },
+        rules: [
+            { when: 'falKling40FlashMode === "reference-to-video"', images: { max: 10 }, videos: { max: 5 } },
+            { when: 'falKling40FlashMode === "video-edit"', images: { max: 10 }, videos: { min: 1, max: 5 } }
+        ]
+    },
+    requirements: [
+        {
+            id: 'fal-kling-4.0-flash-edit-video', when: 'falKling40FlashMode === "video-edit"',
+            require: { videos: { min: 1 } },
+            message: { title: '视频必需', message: '视频编辑需要上传要修改的视频（3–20 秒）', type: 'warning' }
+        }
+    ],
+    params: [
+        {
+            id: 'falKling40FlashMode', type: 'dropdown', order: 1,
+            default: 'text-image-to-video',
+            options: [{ value: 'text-image-to-video' }, { value: 'reference-to-video' }, { value: 'video-edit' }]
+        },
+        {
+            id: 'falKling40FlashAspectRatio', type: 'dropdown', order: 2,
+            default: 'smart',
+            visible: {
+                condition: (params) => {
+                    const mode = klingV4Mode(params.falKling40FlashMode);
+                    return mode === 'reference-to-video' || (mode === 'text-image-to-video' && !hasUploadedImage(params));
+                }
+            },
+            options: [{ value: 'smart' }, ...KLING_V4_RATIOS.map((value) => ({ value }))]
+        },
+        {
+            id: 'falKling40FlashDuration', type: 'number', order: 3,
+            default: 5, min: 3, max: 20, step: 1,
+            visible: { condition: (params) => klingV4Mode(params.falKling40FlashMode) !== 'video-edit' }
+        },
+        {
+            id: 'falKling40FlashElements', type: 'composite', order: 4, valueType: 'array',
+            default: [],
+            visible: { condition: usesElements }
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            const mode = klingV4Mode(params.falKling40FlashMode);
+            if (mode === 'reference-to-video')
+                return 'kling/v4/flash/reference-to-video';
+            if (mode === 'video-edit')
+                return 'kling/v4/flash/video-to-video';
+            return hasUploadedImage(params) ? 'kling/v4/flash/image-to-video' : 'kling/v4/flash/text-to-video';
+        }
+    },
+    request: {
+        builder: (params) => {
+            const mode = klingV4Mode(params.falKling40FlashMode);
+            const prompt = klingV4Prompt(params);
+            const images = resolveUploadedImageSources(params).slice(0, 10);
+            const videos = resolveUploadedVideoSources(params);
+            const elements = usesElements(params) ? buildFalSubjectElements(params.falKling40FlashElements, 'Kling 4.0 Flash') : [];
+            if (mode === 'video-edit') {
+                if (!prompt)
+                    throw new Error('Kling 4.0 Flash 视频编辑需要填写修改说明');
+                if (videos.length === 0)
+                    throw new Error('Kling 4.0 Flash 视频编辑需要上传要修改的视频');
+                const body = { prompt, video_url: videos[0] };
+                if (videos.length > 1)
+                    body.video_urls = videos.slice(1, 5);
+                if (images.length > 0)
+                    body.image_urls = images;
+                if (elements.length > 0)
+                    body.elements = elements;
+                return body;
+            }
+            const duration = klingV4Duration(params.falKling40FlashDuration, 20);
+            if (mode === 'reference-to-video') {
+                if (!prompt)
+                    throw new Error('Kling 4.0 Flash 参考生视频需要填写提示词');
+                const body = {
+                    prompt, duration,
+                    aspect_ratio: klingV4Ratio(params.falKling40FlashAspectRatio, 'auto') ?? 'auto'
+                };
+                if (images.length > 0)
+                    body.image_urls = images;
+                if (videos.length > 0)
+                    body.video_urls = videos.slice(0, 5);
+                if (elements.length > 0)
+                    body.elements = elements;
+                return body;
+            }
+            if (images.length > 0) {
+                const body = { start_image_url: images[0], duration };
+                if (prompt)
+                    body.prompt = prompt;
+                return body;
+            }
+            if (!prompt)
+                throw new Error('Kling 4.0 Flash 文生视频需要填写提示词');
+            return { prompt, duration, aspect_ratio: klingV4Ratio(params.falKling40FlashAspectRatio, undefined) ?? '16:9' };
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const mode = klingV4Mode(params.falKling40FlashMode);
+            const elementVideoSeconds = usesElements(params) ? subjectElementVideoSeconds(params.falKling40FlashElements) : 0;
+            if (mode === 'video-edit') {
+                const { source, input } = klingV4EditSeconds(params);
+                return 0.063 * (source + Math.max(input + elementVideoSeconds, source));
+            }
+            const duration = klingV4Duration(params.falKling40FlashDuration, 20);
+            if (mode === 'reference-to-video' && (hasUploadedVideo(params) || elementVideoSeconds > 0))
+                return 0.063 * (duration + Math.max(resolveUploadedVideoDurationSeconds(params, 5) + elementVideoSeconds, duration));
+            return 0.094 * duration;
+        },
+        description: '720p $0.094/秒；视频编辑、带参考视频或视频元素时 $0.063/秒，按输出时长加“输入视频与输出中较长者”计费'
+    }
+});
+export default falKling40FlashModel;

package/dist/catalog/fal/kling-4.0.model.d.ts

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

package/dist/catalog/fal/kling-4.0.model.js

@@ -0,0 +1,169 @@
+import { defineModel } from "../defineModel.js";
+import { hasUploadedImage, hasUploadedVideo, resolveUploadedImageSources, resolveUploadedVideoDurationSeconds, resolveUploadedVideoSources } from "../shared/mediaPresence.js";
+import { buildShotPrompts, readShots, shotTotalSeconds } from "../shared/shotList.js";
+import { buildFalSubjectElements, subjectElementVideoSeconds } from "../shared/subjectElements.js";
+import { KLING_V4_RATIOS, KLING_V4_SHOT_LIMITS, klingV4Duration, klingV4EditSeconds, klingV4Mode, klingV4Prompt, klingV4Ratio } from "./utils/klingV4.js";
+// 价格与字段来源：docs/model-adaptation/Kling-4.0/Kling-4.0_Fal.md（Fal 模型页与 OpenAPI，2026-11-07 读取）
+function rates(params) {
+    const fullHd = params.falKling40Resolution !== '720p';
+    return { video: fullHd ? 0.235 : 0.157, withVideoInput: fullHd ? 0.141 : 0.094 };
+}
+/** 分镜只在视频编辑以外的模式生效；用了分镜就按各镜秒数之和成片。 */
+const usesShots = (params) => klingV4Mode(params.falKling40Mode) !== 'video-edit' && readShots(params.falKling40Shots).length > 0;
+const usesElements = (params) => klingV4Mode(params.falKling40Mode) !== 'text-image-to-video';
+function outputSeconds(params) {
+    return usesShots(params) ? shotTotalSeconds(params.falKling40Shots, KLING_V4_SHOT_LIMITS) : klingV4Duration(params.falKling40Duration, 30);
+}
+export const falKling40Model = defineModel({
+    meta: {
+        id: 'fal-ai-kling-4.0', canonicalModelId: 'kling-video-4.0', seriesId: 'kling-video', seriesRank: 4,
+        provider: 'fal', type: 'video',
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode', 'video-to-video'],
+        polling: { interval: 3000, maxAttempts: 400, expectedAttempts: 90 }
+    },
+    // 分镜本身即可构成一次生成输入（主提示词只作整体描述并进每一镜），画布与助手不再要求主提示词。
+    alternativeInputParamIds: ['falKling40Shots'],
+    inputLimits: {
+        images: { max: 10 }, videos: { max: 0 }, audios: { max: 0 },
+        rules: [
+            { when: 'falKling40Mode === "reference-to-video"', images: { max: 10 }, videos: { max: 5 } },
+            { when: 'falKling40Mode === "video-edit"', images: { max: 10 }, videos: { min: 1, max: 5 } },
+            { videoConstraints: { minShortSidePx: 700, maxLongSidePx: 4553 } },
+            { when: 'falKling40Mode === "video-edit"', videoConstraints: { minShortSidePx: 700, maxLongSidePx: 4553, minAspectRatio: 0.4, maxAspectRatio: 2.5 } }
+        ]
+    },
+    requirements: [
+        {
+            id: 'fal-kling-4.0-edit-video', when: 'falKling40Mode === "video-edit"',
+            require: { videos: { min: 1 } },
+            message: { title: '视频必需', message: '视频编辑需要上传要修改的视频（3–30 秒）', type: 'warning' }
+        }
+    ],
+    params: [
+        {
+            id: 'falKling40Mode', type: 'dropdown', order: 1,
+            default: 'text-image-to-video',
+            options: [{ value: 'text-image-to-video' }, { value: 'reference-to-video' }, { value: 'video-edit' }]
+        },
+        {
+            id: 'falKling40AspectRatio', type: 'dropdown', order: 2,
+            default: 'smart',
+            visible: {
+                condition: (params) => klingV4Mode(params.falKling40Mode) !== 'text-image-to-video' || !hasUploadedImage(params)
+            },
+            options: [{ value: 'smart' }, ...KLING_V4_RATIOS.map((value) => ({ value }))]
+        },
+        {
+            id: 'falKling40Resolution', type: 'dropdown', order: 3,
+            default: '1080p',
+            options: [{ value: '720p' }, { value: '1080p' }]
+        },
+        {
+            id: 'falKling40Duration', type: 'number', order: 4,
+            default: 5, min: 3, max: 30, step: 1,
+            visible: { condition: (params) => klingV4Mode(params.falKling40Mode) !== 'video-edit' && !usesShots(params) }
+        },
+        {
+            id: 'falKling40Shots', type: 'composite', order: 5, valueType: 'array',
+            default: [],
+            visible: { condition: (params) => klingV4Mode(params.falKling40Mode) !== 'video-edit' }
+        },
+        {
+            id: 'falKling40Elements', type: 'composite', order: 6, valueType: 'array',
+            default: [],
+            visible: { condition: usesElements }
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            const mode = klingV4Mode(params.falKling40Mode);
+            if (mode === 'reference-to-video')
+                return 'kling/v4/reference-to-video';
+            if (mode === 'video-edit')
+                return 'kling/v4/video-to-video/edit';
+            return hasUploadedImage(params) ? 'kling/v4/image-to-video' : 'kling/v4/text-to-video';
+        }
+    },
+    request: {
+        builder: (params) => {
+            const mode = klingV4Mode(params.falKling40Mode);
+            const prompt = klingV4Prompt(params);
+            const images = resolveUploadedImageSources(params).slice(0, 10);
+            const videos = resolveUploadedVideoSources(params);
+            const resolution = params.falKling40Resolution === '720p' ? '720p' : '1080p';
+            const elements = usesElements(params) ? buildFalSubjectElements(params.falKling40Elements, 'Kling 4.0') : [];
+            if (mode === 'video-edit') {
+                if (!prompt)
+                    throw new Error('Kling 4.0 视频编辑需要填写修改说明');
+                if (videos.length === 0)
+                    throw new Error('Kling 4.0 视频编辑需要上传要修改的视频');
+                const body = { prompt, video_url: videos[0], resolution };
+                if (videos.length > 1)
+                    body.video_urls = videos.slice(1, 5);
+                if (images.length > 0)
+                    body.image_urls = images;
+                if (elements.length > 0)
+                    body.elements = elements;
+                const ratio = klingV4Ratio(params.falKling40AspectRatio, undefined);
+                if (ratio)
+                    body.aspect_ratio = ratio;
+                return body;
+            }
+            // 平台的提示词与分镜二选一：用了分镜就只发分镜（主提示词并进每一镜），成片时长取各镜之和，不再发送时长。
+            const shots = buildShotPrompts(params.falKling40Shots, KLING_V4_SHOT_LIMITS, 'Kling 4.0', prompt);
+            const body = { resolution };
+            if (shots.length > 0)
+                body.multi_prompt = shots;
+            else {
+                body.duration = klingV4Duration(params.falKling40Duration, 30);
+                if (prompt)
+                    body.prompt = prompt;
+            }
+            if (mode === 'reference-to-video') {
+                if (!prompt && shots.length === 0)
+                    throw new Error('Kling 4.0 参考生视频需要填写提示词或分镜');
+                if (images.length > 0)
+                    body.image_urls = images;
+                if (videos.length > 0)
+                    body.video_urls = videos.slice(0, 5);
+                if (elements.length > 0)
+                    body.elements = elements;
+                body.aspect_ratio = klingV4Ratio(params.falKling40AspectRatio, 'auto') ?? 'auto';
+                return body;
+            }
+            if (images.length > 0) {
+                // 第一张作首帧，最后一张作尾帧，中间的按顺序作关键帧（最多 8 张）。
+                body.start_image_url = images[0];
+                if (images.length > 1)
+                    body.end_image_url = images[images.length - 1];
+                if (images.length > 2)
+                    body.middle_image_urls = images.slice(1, -1).slice(0, 8);
+                return body;
+            }
+            if (!prompt && shots.length === 0)
+                throw new Error('Kling 4.0 文生视频需要填写提示词或分镜');
+            body.aspect_ratio = klingV4Ratio(params.falKling40AspectRatio, undefined) ?? '16:9';
+            return body;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const mode = klingV4Mode(params.falKling40Mode);
+            const rate = rates(params);
+            const elementVideoSeconds = usesElements(params) ? subjectElementVideoSeconds(params.falKling40Elements) : 0;
+            if (mode === 'video-edit') {
+                const { source, input } = klingV4EditSeconds(params);
+                return rate.withVideoInput * Math.max(input + elementVideoSeconds + source, source * 2);
+            }
+            const duration = outputSeconds(params);
+            if (mode === 'reference-to-video' && (hasUploadedVideo(params) || elementVideoSeconds > 0)) {
+                const input = resolveUploadedVideoDurationSeconds(params, 5) + elementVideoSeconds;
+                return rate.withVideoInput * Math.max(input + duration, duration * 2);
+            }
+            return rate.video * duration;
+        },
+        description: '720p $0.157/秒、1080p $0.235/秒，分镜按各镜秒数之和计；视频编辑、带参考视频或视频元素时 720p $0.094/秒、1080p $0.141/秒，按输入加输出时长计费（至少为输出的 2 倍）'
+    }
+});
+export default falKling40Model;

package/dist/catalog/fal/kling-image-o1.model.js

@@ -5,7 +5,7 @@ export const klingImageO1Model = defineModel({
         canonicalModelId: 'kling-image-o1',
         provider: 'fal',
         type: 'image',
-        tags: ['image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'max-images-10', 'provider-fal']
+        tags: ['image-to-image']
     },
     inputLimits: {
         images: { min: 1, max: 10 },

package/dist/catalog/fal/kling-video-o1.model.js

@@ -1,4 +1,5 @@
 import { defineModel } from "../defineModel.js";
+import { resolveUploadedVideoDurationSeconds } from "../shared/mediaPresence.js";
 export const klingVideoO1Model = defineModel({
     meta: {
         id: 'fal-ai-kling-video-o1',
@@ -7,12 +8,17 @@ export const klingVideoO1Model = defineModel({
         seriesRank: 10,
         provider: 'fal',
         type: 'video',
-        tags: ['video', 'text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode', 'supports-video-editing', 'multi-mode-switch']
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode', 'video-to-video']
     },
     inputLimits: {
         images: { max: 2 },
         videos: { max: 0 },
         rules: [
+            {
+                // 图生视频端点官方必填 start_image_url：没有首帧图时自动切到参考生视频（纯文字也能生成）。
+                when: 'falKlingVideoO1Mode === "image-to-video"',
+                images: { min: 1, max: 2 }
+            },
             {
                 when: 'falKlingVideoO1Mode === "reference-to-video"',
                 images: { max: 7 }
@@ -56,6 +62,10 @@ export const klingVideoO1Model = defineModel({
             order: 2,
             type: 'dropdown',
             default: 5,
+            // 视频编辑的成片时长跟随输入视频，官方编辑端点没有时长字段。
+            visible: {
+                condition: 'falKlingVideoO1Mode !== "video-to-video-edit"'
+            },
             options: [
                 { value: 5 },
                 { value: 10 }
@@ -118,10 +128,9 @@ export const klingVideoO1Model = defineModel({
             const aspectRatio = params.falKlingVideoO1AspectRatio;
             const keepAudio = params.falKlingVideoO1KeepAudio || false;
             const videoInput = typeof params.video === 'string' ? params.video : videos[0];
-            const requestData = {
-                prompt,
-                duration: `${duration}`
-            };
+            const requestData = mode === 'video-to-video-edit'
+                ? { prompt }
+                : { prompt, duration: `${duration}` };
             if (mode === 'image-to-video') {
                 if (images.length > 0) {
                     requestData.start_image_url = images[0];
@@ -157,11 +166,13 @@ export const klingVideoO1Model = defineModel({
         currency: '$',
         calculator: (params) => {
             const mode = params.falKlingVideoO1Mode || 'image-to-video';
-            const duration = Number(params.falKlingVideoO1VideoDuration) || 5;
+            const chosen = Number(params.falKlingVideoO1VideoDuration) || 5;
+            // 编辑按输入视频时长计费；读不到时长时按官方输入上限 10 秒估，宁高勿低。
+            const duration = mode === 'video-to-video-edit' ? resolveUploadedVideoDurationSeconds(params, 10) : chosen;
             const isVideoEdit = mode === 'video-to-video-edit' || mode === 'video-to-video-reference';
             return (isVideoEdit ? 0.168 : 0.112) * duration;
         },
-        description: '图生视频/参考生视频 $0.112/秒；视频编辑/参考 $0.168/秒'
+        description: '图生视频/参考生视频 $0.112/秒；视频参考 $0.168/秒；视频编辑 $0.168/秒，按输入视频时长计'
     }
 });
 export default klingVideoO1Model;

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

@@ -8,7 +8,7 @@ export const klingVideoV26ProModel = defineModel({
         seriesRank: 2.6,
         provider: 'fal',
         type: 'video',
-        tags: ['video', 'text-to-video', 'image-to-video', 'motion-control']
+        tags: ['text-to-video', 'image-to-video', 'motion-control']
     },
     inputLimits: {
         images: { max: 1 },
@@ -200,7 +200,8 @@ export const klingVideoV26ProModel = defineModel({
                 generate_audio: generateAudio
             };
             if (images.length > 0) {
-                requestData.image_url = images[0];
+                // 图生视频端点的首帧字段是 start_image_url（官方 OpenAPI 必填），image_url 只属于动作控制端点。
+                requestData.start_image_url = images[0];
             }
             else {
                 if (aspectRatio && aspectRatio !== 'auto') {