@henjicc/ai-sdk 0.2.8

package/dist/catalog/fal/gpt-image-2.model.js

@@ -0,0 +1,141 @@
+import { defineModel } from "../defineModel.js";
+import { FAL_COMMON_IMAGE_RATIOS, falOneMegapixelSize } from './imageSizing.js';
+const FAL_GPT_IMAGE_2_RATIOS = [...FAL_COMMON_IMAGE_RATIOS, '2:1'];
+function falGptImage2TwoKSize(ratioText) {
+    if (ratioText === '2:1')
+        return { width: 2688, height: 1344 };
+    const pair = ratioText.split(':').map(Number);
+    const ratio = pair[0] > 0 && pair[1] > 0 ? pair[0] / pair[1] : 1;
+    const targetArea = 2688 * 1344;
+    return {
+        width: Math.ceil(Math.sqrt(targetArea * ratio) / 16) * 16,
+        height: Math.ceil(Math.sqrt(targetArea / ratio) / 16) * 16,
+    };
+}
+export const falGptImage2Model = defineModel({
+    meta: {
+        id: 'fal-ai-gpt-image-2', canonicalModelId: 'gpt-image-2', seriesId: 'gpt-image', seriesRank: 2,
+        provider: 'fal', type: 'image',
+        tags: ['text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'provider-fal'],
+        aliases: ['gpt-image-2-fal'], polling: { interval: 3000, maxAttempts: 200, expectedAttempts: 45 }
+    },
+    inputLimits: { images: { max: 16 }, videos: { max: 0 } },
+    params: [
+        {
+            id: 'falGptImage2AspectRatio', type: 'dropdown', order: 1,
+            default: 'smart',
+            options: [
+                { value: 'smart' },
+                ...FAL_GPT_IMAGE_2_RATIOS.map((value) => ({ value }))
+            ]
+        },
+        {
+            id: 'falGptImage2ImageSize', type: 'dropdown', order: 2,
+            default: 'provider',
+            options: [{ value: 'provider' }, { value: '1MP' }, { value: '2K' }]
+        },
+        {
+            id: 'falGptImage2Resolution', type: 'dropdown', order: 3,
+            default: 'high',
+            options: [
+                { value: 'auto' },
+                { value: 'low' },
+                { value: 'medium' },
+                { value: 'high' }
+            ]
+        },
+        {
+            id: 'falGptImage2NumImages', type: 'number', order: 4,
+            default: 1, min: 1, max: 4, step: 1
+        },
+        {
+            id: 'falGptImage2MaskUrl', type: 'image-upload', order: 5,
+            default: [],
+            valueType: 'array', maxCount: 1, format: 'url',
+            accept: ['image/png', 'image/webp'], maxSize: 20 * 1024 * 1024,
+            visible: {
+                condition: (params) => {
+                    const uploaded = Array.isArray(params.uploadedFilePaths) ? params.uploadedFilePaths : [];
+                    const images = uploaded.length > 0 ? uploaded : (Array.isArray(params.images) ? params.images : []);
+                    return images.length > 0;
+                }
+            }
+        }
+    ],
+    runtimeConstraints: { mediaFields: [{ field: 'mask_url', kind: 'image' }] },
+    endpoints: {
+        selector: async (params) => {
+            const primary = Array.isArray(params.uploadedFilePaths) ? params.uploadedFilePaths : [];
+            const fallback = Array.isArray(params.images) ? params.images : [];
+            const images = primary.length > 0 ? primary : fallback;
+            return images.length > 0 ? 'openai/gpt-image-2/edit' : 'openai/gpt-image-2';
+        }
+    },
+    request: {
+        builder: (params) => {
+            const clean = (value) => Array.isArray(value)
+                ? value.filter((item) => typeof item === 'string' && item.trim().length > 0) : [];
+            const primary = clean(params.uploadedFilePaths);
+            const images = primary.length > 0 ? primary : clean(params.images);
+            const rawRatio = String(params.falGptImage2AspectRatio || 'smart');
+            const hint = typeof params.__firstImageRatio === 'number' && Number.isFinite(params.__firstImageRatio) && params.__firstImageRatio > 0
+                ? params.__firstImageRatio : 1;
+            const candidates = FAL_GPT_IMAGE_2_RATIOS.map((value) => {
+                const pair = value.split(':').map(Number);
+                return [value, pair[0] / pair[1]];
+            });
+            let ratio = candidates.some(([value]) => value === rawRatio) ? rawRatio : '1:1';
+            if (rawRatio === 'smart' || rawRatio === 'auto') {
+                let difference = Number.POSITIVE_INFINITY;
+                for (const [value, numeric] of candidates) {
+                    const next = Math.abs(numeric - hint);
+                    if (next < difference) {
+                        difference = next;
+                        ratio = value;
+                    }
+                }
+            }
+            const sizeMap = {
+                '1:1': 'square_hd', '4:3': 'landscape_4_3', '3:4': 'portrait_4_3',
+                '16:9': 'landscape_16_9', '9:16': 'portrait_16_9'
+            };
+            const quality = ['auto', 'low', 'medium'].includes(String(params.falGptImage2Resolution))
+                ? String(params.falGptImage2Resolution) : 'high';
+            const providerSize = sizeMap[ratio];
+            const body = {
+                prompt: typeof params.prompt === 'string' ? params.prompt.slice(0, 32000) : '',
+                image_size: params.falGptImage2ImageSize === '2K'
+                    ? falGptImage2TwoKSize(ratio)
+                    : (params.falGptImage2ImageSize === '1MP' || !providerSize
+                        ? falOneMegapixelSize(ratio)
+                        : (images.length > 0 && rawRatio === 'smart' ? 'auto' : providerSize)),
+                quality,
+                num_images: Math.min(4, Math.max(1, Math.round(Number(params.falGptImage2NumImages || 1))))
+            };
+            if (images.length > 0)
+                body.image_urls = images.slice(0, 16);
+            const maskCandidates = Array.isArray(params.falGptImage2MaskUrl)
+                ? params.falGptImage2MaskUrl
+                : [params.falGptImage2MaskUrl];
+            const maskValue = maskCandidates.find((item) => typeof item === 'string' && item.trim().length > 0);
+            const maskUrl = typeof maskValue === 'string' ? maskValue.trim() : '';
+            if (maskUrl) {
+                if (images.length === 0)
+                    throw new Error('GPT Image 2 局部重绘必须同时提供至少 1 张参考图');
+                body.mask_url = maskUrl;
+            }
+            return body;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const quality = String(params.falGptImage2Resolution || 'high');
+            const squareReference = { auto: 0.211, low: 0.006, medium: 0.053, high: 0.211 };
+            const count = Math.min(4, Math.max(1, Math.round(Number(params.falGptImage2NumImages || 1))));
+            return count * (squareReference[quality] ?? squareReference.high);
+        },
+        description: '按文本/图片 token 计费；估算采用官方 1024×1024 示例：低 $0.006、标准 $0.053、高质量 $0.211/张；自动档按高质量保守估算'
+    }
+});
+export default falGptImage2Model;

package/dist/catalog/fal/grok-imagine-2.0.model.d.ts

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

package/dist/catalog/fal/grok-imagine-2.0.model.js

@@ -0,0 +1,86 @@
+import { defineModel } from "../defineModel.js";
+import { countUploadedImages } from "../shared/mediaPresence.js";
+const GROK_RATIOS = ['2:1', '20:9', '19.5:9', '16:9', '4:3', '3:2', '1:1', '2:3', '3:4', '9:16', '9:19.5', '9:20', '1:2'];
+export const falGrokImagine20Model = defineModel({
+    meta: {
+        id: 'fal-ai-grok-imagine-2.0', canonicalModelId: 'grok-imagine-image-2.0', seriesId: 'grok-imagine-image', seriesRank: 2,
+        provider: 'fal', type: 'image',
+        tags: ['text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'provider-fal'],
+        aliases: ['grok-imagine-image-2-fal'], polling: { interval: 3000, maxAttempts: 180, expectedAttempts: 35 }
+    },
+    inputLimits: { images: { max: 3 }, videos: { max: 0 } },
+    params: [
+        {
+            id: 'falGrokImagine20AspectRatio', type: 'dropdown', order: 1,
+            default: 'smart',
+            options: [{ value: 'smart' }, ...GROK_RATIOS.map((value) => ({ value }))]
+        },
+        {
+            id: 'falGrokImagine20Resolution', type: 'dropdown', order: 2,
+            default: '1K',
+            options: ['1K', '2K'].map((value) => ({ value }))
+        },
+        {
+            id: 'falGrokImagine20Quality', type: 'dropdown', order: 3,
+            default: 'medium',
+            options: [{ value: 'low' }, { value: 'medium' }]
+        },
+        {
+            id: 'falGrokImagine20NumImages', type: 'number', order: 4,
+            default: 1, min: 1, max: 4, step: 1
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            const uploaded = Array.isArray(params.uploadedFilePaths) ? params.uploadedFilePaths : [];
+            const images = uploaded.length > 0 ? uploaded : (Array.isArray(params.images) ? params.images : []);
+            return images.length > 0 ? 'xai/grok-imagine-image/v2.0/edit' : 'xai/grok-imagine-image/v2.0/text-to-image';
+        }
+    },
+    request: {
+        builder: (params) => {
+            const clean = (value) => Array.isArray(value)
+                ? value.filter((item) => typeof item === 'string' && item.trim().length > 0) : [];
+            const uploaded = clean(params.uploadedFilePaths);
+            const images = uploaded.length > 0 ? uploaded : clean(params.images);
+            const supported = ['2:1', '20:9', '19.5:9', '16:9', '4:3', '3:2', '1:1', '2:3', '3:4', '9:16', '9:19.5', '9:20', '1:2'];
+            const raw = String(params.falGrokImagine20AspectRatio || 'smart');
+            const hint = typeof params.__firstImageRatio === 'number' && Number.isFinite(params.__firstImageRatio) && params.__firstImageRatio > 0 ? params.__firstImageRatio : 1;
+            let ratio = supported.includes(raw) ? raw : '1:1';
+            if (raw === 'smart' || raw === 'auto') {
+                let difference = Number.POSITIVE_INFINITY;
+                for (const candidate of supported) {
+                    const pair = candidate.split(':').map(Number);
+                    const next = Math.abs(pair[0] / pair[1] - hint);
+                    if (next < difference) {
+                        difference = next;
+                        ratio = candidate;
+                    }
+                }
+            }
+            const body = {
+                prompt: typeof params.prompt === 'string' ? params.prompt : '',
+                aspect_ratio: images.length > 0 && raw === 'smart' ? 'auto' : ratio,
+                resolution: params.falGrokImagine20Resolution === '2K' ? '2k' : '1k',
+                quality: params.falGrokImagine20Quality === 'low' ? 'low' : 'medium',
+                num_images: Math.min(4, Math.max(1, Math.round(Number(params.falGrokImagine20NumImages || 1))))
+            };
+            if (images.length > 0)
+                body.image_urls = images.slice(0, 3);
+            return body;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const resolution = params.falGrokImagine20Resolution === '2K' ? '2K' : '1K';
+            const quality = params.falGrokImagine20Quality === 'low' ? 'low' : 'medium';
+            const prices = { '1K-low': 0.04, '1K-medium': 0.06, '2K-low': 0.06, '2K-medium': 0.08 };
+            const count = Math.min(4, Math.max(1, Math.round(Number(params.falGrokImagine20NumImages || 1))));
+            const inputs = countUploadedImages(params);
+            return count * (prices[`${resolution}-${quality}`] ?? 0.06) + inputs * 0.01;
+        },
+        description: '1K $0.04/$0.06、2K $0.06/$0.08（低/标准）；编辑另加 $0.01/输入图'
+    }
+});
+export default falGrokImagine20Model;

package/dist/catalog/fal/hailuo-02.model.d.ts

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

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

@@ -0,0 +1,152 @@
+import { defineModel } from "../defineModel.js";
+import { countUploadedImages, resolveUploadedImageSources } from "../shared/mediaPresence.js";
+export const hailuo02Model = defineModel({
+    meta: {
+        id: 'fal-ai-minimax-hailuo-02',
+        canonicalModelId: 'hailuo-02',
+        seriesId: 'hailuo',
+        seriesRank: 2.0,
+        provider: 'fal',
+        type: 'video',
+        tags: ['video', 'text-to-video', 'image-to-video', 'start-end-frame'],
+        aliases: ['fal-ai-hailuo-02', 'minimax-hailuo-02-fal']
+    },
+    inputLimits: {
+        images: { max: 2 },
+        videos: { max: 0 },
+        rules: [
+            {
+                when: 'falHailuo02FastMode === true',
+                images: { max: 1 }
+            }
+        ]
+    },
+    params: [
+        {
+            id: 'falHailuo02Version',
+            order: 1,
+            type: 'dropdown',
+            default: 'standard',
+            options: [
+                { value: 'standard' },
+                { value: 'pro' }
+            ]
+        },
+        {
+            id: 'falHailuo02Duration',
+            order: 2,
+            type: 'dropdown',
+            default: '6',
+            // Pro 端点的 schema 里没有 duration 字段，官方固定 6 秒（$0.48/条）。
+            // 单图 Fast 路由优先于版本选择，仍接受 6/10 秒。
+            visible: {
+                condition: (params) => params.falHailuo02Version !== 'pro' ||
+                    (params.falHailuo02FastMode === true && countUploadedImages(params) === 1)
+            },
+            options: [
+                { value: '6' },
+                { value: '10' }
+            ]
+        },
+        {
+            id: 'falHailuo02Resolution',
+            order: 3,
+            type: 'dropdown',
+            default: '768P',
+            // 只有 Standard 非 Fast 图生视频接受 resolution；文生、Pro 与 Fast 端点均不接受。
+            visible: {
+                condition: (params) => {
+                    const imageCount = countUploadedImages(params);
+                    const isFastMode = imageCount === 1 && params.falHailuo02FastMode === true;
+                    return params.falHailuo02Version !== 'pro' && imageCount > 0 && !isFastMode;
+                }
+            },
+            options: [
+                { value: '512P' },
+                { value: '768P' }
+            ]
+        },
+        {
+            id: 'falHailuo02FastMode',
+            order: 4,
+            type: 'switch',
+            default: false,
+            visible: { condition: (params) => countUploadedImages(params) === 1 }
+        },
+        {
+            id: 'falHailuo02PromptOptimizer',
+            order: 5,
+            type: 'switch',
+            default: true
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            const imageCount = resolveUploadedImageSources(params).length;
+            const version = params.falHailuo02Version || 'standard';
+            const fastMode = params.falHailuo02FastMode === true;
+            if (imageCount === 0) {
+                return version === 'pro'
+                    ? 'fal-ai/minimax/hailuo-02/pro/text-to-video'
+                    : 'fal-ai/minimax/hailuo-02/standard/text-to-video';
+            }
+            if (imageCount === 1 && fastMode) {
+                return 'fal-ai/minimax/hailuo-02-fast/image-to-video';
+            }
+            if (version === 'pro') {
+                return 'fal-ai/minimax/hailuo-02/pro/image-to-video';
+            }
+            return 'fal-ai/minimax/hailuo-02/standard/image-to-video';
+        }
+    },
+    request: {
+        builder: (params) => {
+            const images = resolveUploadedImageSources(params);
+            const prompt = params.prompt || '';
+            const version = params.falHailuo02Version || 'standard';
+            const resolution = params.falHailuo02Resolution || '768P';
+            const duration = params.falHailuo02Duration || '6';
+            const isFastMode = images.length === 1 && params.falHailuo02FastMode === true;
+            const promptOptimizer = params.falHailuo02PromptOptimizer !== false;
+            const requestData = { prompt };
+            if (promptOptimizer !== undefined) {
+                requestData.prompt_optimizer = promptOptimizer;
+            }
+            if (version === 'standard' || isFastMode) {
+                requestData.duration = duration;
+            }
+            if (version === 'standard' && images.length > 0 && !isFastMode) {
+                requestData.resolution = resolution;
+            }
+            if (images.length >= 1) {
+                requestData.image_url = images[0];
+            }
+            if (images.length >= 2) {
+                requestData.end_image_url = images[1];
+            }
+            return requestData;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const duration = params.falHailuo02Duration === '10' ? 10 : 6;
+            const version = params.falHailuo02Version === 'pro' ? 'pro' : 'standard';
+            const imageCount = countUploadedImages(params);
+            const isFastMode = imageCount === 1 && params.falHailuo02FastMode === true;
+            // 单图 Fast 端点优先于 UI 中保留的版本值，按 512P Fast 秒价计费。
+            if (isFastMode)
+                return 0.017 * duration;
+            // Pro 不接受 duration 入参，官方固定 6 秒，计价不能读 UI 上的时长
+            if (version === 'pro')
+                return 0.08 * 6;
+            // Standard 文生视频不接受 resolution，固定按 768P 秒价计费。
+            if (imageCount === 0)
+                return 0.045 * duration;
+            const resolution = params.falHailuo02Resolution === '512P' ? '512P' : '768P';
+            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/条'
+    }
+});
+export default hailuo02Model;

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

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

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

@@ -0,0 +1,109 @@
+import { defineModel } from "../defineModel.js";
+import { countUploadedImages, resolveUploadedImageSources } from "../shared/mediaPresence.js";
+export const hailuo23Model = defineModel({
+    meta: {
+        id: 'fal-ai-minimax-hailuo-2.3',
+        canonicalModelId: 'hailuo-2.3',
+        seriesId: 'hailuo',
+        seriesRank: 2.3,
+        provider: 'fal',
+        type: 'video',
+        tags: ['video', 'text-to-video', 'image-to-video'],
+        aliases: ['fal-ai-hailuo-2.3', 'minimax-hailuo-2.3-fal']
+    },
+    inputLimits: {
+        images: { max: 1 },
+        videos: { max: 0 }
+    },
+    params: [
+        {
+            id: 'falHailuo23Version',
+            order: 1,
+            type: 'dropdown',
+            default: 'standard',
+            options: [
+                { value: 'standard' },
+                { value: 'pro' }
+            ]
+        },
+        {
+            id: 'falHailuo23Duration',
+            order: 2,
+            type: 'dropdown',
+            default: '6',
+            visible: { condition: (params) => params.falHailuo23Version !== 'pro' },
+            options: [
+                { value: '6' },
+                { value: '10' }
+            ]
+        },
+        {
+            id: 'falHailuo23FastMode',
+            order: 3,
+            type: 'switch',
+            default: true,
+            visible: { condition: (params) => countUploadedImages(params) > 0 }
+        },
+        {
+            id: 'falHailuo23PromptOptimizer',
+            order: 4,
+            type: 'switch',
+            default: true
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            const imageCount = resolveUploadedImageSources(params).length;
+            const version = params.falHailuo23Version || 'standard';
+            const fastMode = params.falHailuo23FastMode !== false;
+            if (imageCount > 0) {
+                if (fastMode) {
+                    return version === 'pro'
+                        ? 'fal-ai/minimax/hailuo-2.3-fast/pro/image-to-video'
+                        : 'fal-ai/minimax/hailuo-2.3-fast/standard/image-to-video';
+                }
+                return version === 'pro'
+                    ? 'fal-ai/minimax/hailuo-2.3/pro/image-to-video'
+                    : 'fal-ai/minimax/hailuo-2.3/standard/image-to-video';
+            }
+            return version === 'pro'
+                ? 'fal-ai/minimax/hailuo-2.3/pro/text-to-video'
+                : 'fal-ai/minimax/hailuo-2.3/standard/text-to-video';
+        }
+    },
+    request: {
+        builder: (params) => {
+            const images = resolveUploadedImageSources(params);
+            const prompt = params.prompt || '';
+            const version = params.falHailuo23Version || 'standard';
+            const duration = params.falHailuo23Duration || '6';
+            const promptOptimizer = params.falHailuo23PromptOptimizer !== false;
+            const requestData = { prompt };
+            if (promptOptimizer !== undefined) {
+                requestData.prompt_optimizer = promptOptimizer;
+            }
+            if (version === 'standard') {
+                requestData.duration = duration;
+            }
+            if (images.length > 0) {
+                requestData.image_url = images[0];
+            }
+            return requestData;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const duration = params.falHailuo23Duration === '10' ? 10 : 6;
+            const version = params.falHailuo23Version === 'pro' ? 'pro' : 'standard';
+            const fastMode = countUploadedImages(params) > 0 && params.falHailuo23FastMode !== false;
+            if (version === 'pro')
+                return fastMode ? 0.33 : 0.49;
+            return fastMode
+                ? (duration === 10 ? 0.32 : 0.19)
+                : (duration === 10 ? 0.56 : 0.28);
+        },
+        description: 'Standard：6s $0.28、10s $0.56；Standard 快速：6s $0.19、10s $0.32；Pro：$0.49/次；Pro 快速：$0.33/次'
+    }
+});
+export default hailuo23Model;

package/dist/catalog/fal/ic-light-v2.model.d.ts

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

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

@@ -0,0 +1,83 @@
+import { defineModel } from '../defineModel.js';
+import { falOneMegapixelSize } from './imageSizing.js';
+const IC_LIGHT_DIRECTIONS = ['None', 'Left', 'Right', 'Top', 'Bottom'];
+function cleanImages(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === 'string' && item.trim().length > 0)
+        : [];
+}
+function nearestRatioText(ratio) {
+    const candidates = ['1:1', '4:3', '3:4', '16:9', '9:16'];
+    return candidates.reduce((best, candidate) => {
+        const [width, height] = candidate.split(':').map(Number);
+        const [bestWidth, bestHeight] = best.split(':').map(Number);
+        return Math.abs(width / height - ratio) < Math.abs(bestWidth / bestHeight - ratio)
+            ? candidate
+            : best;
+    }, '1:1');
+}
+export const falIcLightV2Model = defineModel({
+    meta: {
+        id: 'fal-ai-ic-light-v2',
+        canonicalModelId: 'ic-light-v2',
+        seriesId: 'ic-light',
+        seriesRank: 2,
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-to-image', 'supports-image-editing', 'relighting', 'provider-fal'],
+        aliases: ['ic-light-v2-fal'],
+        polling: { interval: 3000, maxAttempts: 200, expectedAttempts: 45 },
+    },
+    inputLimits: { images: { min: 1, max: 1 }, videos: { max: 0 } },
+    params: [
+        {
+            id: 'falIcLightV2InitialLatent',
+            type: 'dropdown',
+            order: 1,
+            default: 'None',
+            options: IC_LIGHT_DIRECTIONS.map((value) => ({ value })),
+        },
+    ],
+    endpoints: {
+        selector: async () => 'fal-ai/iclight-v2',
+    },
+    request: {
+        builder: (params) => {
+            const uploaded = cleanImages(params.uploadedFilePaths);
+            const images = uploaded.length > 0 ? uploaded : cleanImages(params.images);
+            if (images.length !== 1) {
+                throw new Error('IC-Light v2 必须且只能提供 1 张源图');
+            }
+            const rawDirection = String(params.falIcLightV2InitialLatent || 'None');
+            const direction = IC_LIGHT_DIRECTIONS.includes(rawDirection)
+                ? rawDirection
+                : 'None';
+            const ratio = typeof params.__firstImageRatio === 'number'
+                && Number.isFinite(params.__firstImageRatio)
+                && params.__firstImageRatio > 0
+                ? params.__firstImageRatio
+                : 1;
+            return {
+                prompt: typeof params.prompt === 'string' ? params.prompt.slice(0, 32000) : '',
+                image_url: images[0],
+                initial_latent: direction,
+                image_size: falOneMegapixelSize(nearestRatioText(ratio)),
+                num_images: 1,
+                num_inference_steps: 28,
+                cfg_scale: 1,
+                guidance_scale: 5,
+                lowres_denoise: 0.98,
+                highres_denoise: 0.95,
+                highres_scale: 0.5,
+                enable_hr_fix: false,
+                enable_safety_checker: true,
+            };
+        },
+    },
+    pricing: {
+        currency: '$',
+        calculator: () => 0.1,
+        description: '$0.10/百万像素；首版固定约 1MP、1 张输出，估算 $0.10/次',
+    },
+});
+export default falIcLightV2Model;

package/dist/catalog/fal/ideogram-upscale.model.d.ts

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

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

@@ -0,0 +1,50 @@
+import { defineModel } from '../defineModel.js';
+import { requireSingleUpscaleImage } from './imageUpscale.js';
+function clampInteger(value, fallback) {
+    const parsed = Math.round(Number(value));
+    return Number.isFinite(parsed) ? Math.min(100, Math.max(1, parsed)) : fallback;
+}
+export const falIdeogramUpscaleModel = defineModel({
+    meta: {
+        id: 'fal-ai-ideogram-upscale',
+        canonicalModelId: 'ideogram-upscale',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-to-image', 'upscaling', 'provider-fal'],
+        polling: { interval: 3000, maxAttempts: 200, expectedAttempts: 45 },
+    },
+    acceptsPrompt: false,
+    inputLimits: { images: { min: 1, max: 1 }, videos: { max: 0 } },
+    params: [
+        {
+            id: 'falIdeogramUpscaleResemblance',
+            type: 'number',
+            order: 1,
+            transferKey: 'upscaleResemblance',
+            min: 1,
+            max: 100,
+            step: 1,
+            default: 50,
+        },
+        {
+            id: 'falIdeogramUpscaleDetail',
+            type: 'number',
+            order: 2,
+            transferKey: 'upscaleDetail',
+            min: 1,
+            max: 100,
+            step: 1,
+            default: 50,
+        },
+    ],
+    endpoints: { selector: async () => 'fal-ai/ideogram/upscale' },
+    request: {
+        builder: (params) => ({
+            image_url: requireSingleUpscaleImage(params, 'Ideogram 图片放大'),
+            resemblance: clampInteger(params.falIdeogramUpscaleResemblance, 50),
+            detail: clampInteger(params.falIdeogramUpscaleDetail, 50),
+        }),
+    },
+    pricing: { currency: '$', fixed: 0.06, description: '$0.06/张，最高约 2× 放大' },
+});
+export default falIdeogramUpscaleModel;

package/dist/catalog/fal/imageSizing.d.ts

@@ -0,0 +1,3 @@
+import type { JsonObject } from '../../types/runtime.js';
+export declare const FAL_COMMON_IMAGE_RATIOS: readonly ["1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"];
+export declare function falOneMegapixelSize(ratioText: string): JsonObject;

package/dist/catalog/fal/imageSizing.js

@@ -0,0 +1,12 @@
+export const FAL_COMMON_IMAGE_RATIOS = [
+    '1:1', '2:3', '3:2', '3:4', '4:3', '4:5', '5:4', '9:16', '16:9', '21:9'
+];
+export function falOneMegapixelSize(ratioText) {
+    const pair = ratioText.split(':').map(Number);
+    const ratio = pair[0] > 0 && pair[1] > 0 ? pair[0] / pair[1] : 1;
+    const targetArea = 1024 * 1024;
+    return {
+        width: Math.ceil(Math.sqrt(targetArea * ratio) / 16) * 16,
+        height: Math.ceil(Math.sqrt(targetArea / ratio) / 16) * 16,
+    };
+}

package/dist/catalog/fal/imageUpscale.d.ts

@@ -0,0 +1,4 @@
+import type { JsonObject } from '../../types/runtime.js';
+export declare function requireSingleUpscaleImage(params: JsonObject, label: string): string;
+export declare function readUpscaleOutputMegapixels(params: JsonObject): number | null;
+export declare function pricePerStartedMegapixels(params: JsonObject, megapixelsPerTier: number, pricePerTier: number): number;