@henjicc/ai-sdk 0.2.8

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

@@ -0,0 +1,173 @@
+import { defineModel } from "../defineModel.js";
+export const seedanceModel = defineModel({
+    meta: {
+        id: 'fal-ai-bytedance-seedance-v1',
+        canonicalModelId: 'seedance-v1',
+        provider: 'fal',
+        type: 'video',
+        tags: ['video', 'text-to-video', 'image-to-video'],
+        aliases: ['fal-ai-bytedance-seedance', 'bytedance-seedance-v1']
+    },
+    inputLimits: {
+        images: { max: 0 },
+        videos: { max: 0 },
+        rules: [
+            {
+                when: 'falSeedanceV1Mode === "image-to-video"',
+                images: { max: 2 }
+            },
+            {
+                when: 'falSeedanceV1Mode === "image-to-video" && falSeedanceV1FastMode === true',
+                images: { max: 1 }
+            }
+        ]
+    },
+    requirements: [
+        {
+            id: 'seedance-image-to-video',
+            when: 'falSeedanceV1Mode === "image-to-video"',
+            require: { images: { min: 1 } },
+            message: {
+                title: '图片必需',
+                message: '图生视频模式需要上传至少1张图片',
+                type: 'warning'
+            }
+        }
+    ],
+    params: [
+        {
+            id: 'falSeedanceV1Mode',
+            order: 1,
+            type: 'dropdown',
+            default: 'text-to-video',
+            // 官方已下线 Lite 档文生/图生视频（重定向到 Pro Fast）与参考生视频模式
+            // （Lite 重定向到完全不同的 Grok Imagine Video，Pro 端点 404），只保留仍可用的两种模式
+            options: [
+                { value: 'text-to-video' },
+                { value: 'image-to-video' }
+            ]
+        },
+        {
+            id: 'falSeedanceV1AspectRatio',
+            order: 3,
+            type: 'dropdown',
+            default: '16:9',
+            options: [
+                { value: 'smart' },
+                { value: 'auto' },
+                { value: '21:9' },
+                { value: '16:9' },
+                { value: '4:3' },
+                { value: '1:1' },
+                { value: '3:4' },
+                { value: '9:16' }
+            ]
+        },
+        {
+            id: 'falSeedanceV1Resolution',
+            order: 4,
+            type: 'dropdown',
+            default: '720p',
+            options: [
+                { value: '480p' },
+                { value: '720p' },
+                { value: '1080p' }
+            ]
+        },
+        {
+            id: 'falSeedanceV1VideoDuration',
+            order: 5,
+            type: 'dropdown',
+            default: 5,
+            options: [
+                { value: 2 },
+                { value: 3 },
+                { value: 4 },
+                { value: 5 },
+                { value: 6 },
+                { value: 7 },
+                { value: 8 },
+                { value: 9 },
+                { value: 10 },
+                { value: 11 },
+                { value: 12 }
+            ]
+        },
+        {
+            id: 'falSeedanceV1CameraFixed',
+            order: 6,
+            type: 'switch',
+            default: false
+        },
+        {
+            id: 'falSeedanceV1FastMode',
+            order: 7,
+            type: 'switch',
+            default: true
+        }
+    ],
+    endpoints: {
+        // 仅存的可用档位是 Pro（非 fast）与 Pro Fast；Lite 与参考生视频已由官方下线/重定向失效
+        selector: async (params) => {
+            const mode = params.falSeedanceV1Mode || 'text-to-video';
+            const fastMode = params.falSeedanceV1FastMode === true;
+            const fastPath = fastMode ? '/fast' : '';
+            if (mode === 'image-to-video') {
+                return `fal-ai/bytedance/seedance/v1/pro${fastPath}/image-to-video`;
+            }
+            return `fal-ai/bytedance/seedance/v1/pro${fastPath}/text-to-video`;
+        }
+    },
+    request: {
+        builder: (params) => {
+            const filterSources = (value) => Array.isArray(value)
+                ? value.filter((item) => typeof item === 'string' && item.trim().length > 0)
+                : [];
+            const uploaded = filterSources(params.uploadedFilePaths);
+            const images = uploaded.length > 0 ? uploaded : filterSources(params.images);
+            const prompt = params.prompt || '';
+            const mode = params.falSeedanceV1Mode || 'text-to-video';
+            const duration = params.falSeedanceV1VideoDuration || 5;
+            const resolution = params.falSeedanceV1Resolution || '720p';
+            const cameraFixed = params.falSeedanceV1CameraFixed || false;
+            const aspectRatio = params.falSeedanceV1AspectRatio;
+            const requestData = {
+                prompt,
+                duration: `${duration}`,
+                enable_safety_checker: false,
+                resolution,
+                camera_fixed: cameraFixed
+            };
+            if (aspectRatio && aspectRatio !== 'smart') {
+                requestData.aspect_ratio = aspectRatio;
+            }
+            if (mode === 'image-to-video' && images.length > 0) {
+                requestData.image_url = images[0];
+                if (images.length > 1) {
+                    requestData.end_image_url = images[1];
+                }
+            }
+            return requestData;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            // 官方按 token 计费：tokens = 宽 × 高 × fps × 秒数 / 1024；Pro $2.5/百万 token，Pro Fast $1/百万 token。
+            // 分辨率对应的宽高按 16:9 近似（其余宽高比价格会有小幅偏差，仅供估算）。
+            const dimensions = {
+                '480p': [854, 480],
+                '720p': [1280, 720],
+                '1080p': [1920, 1080],
+            };
+            const [width, height] = dimensions[params.falSeedanceV1Resolution] ?? dimensions['720p'];
+            const duration = Number(params.falSeedanceV1VideoDuration) || 5;
+            const fps = 24;
+            const tokens = (width * height * fps * duration) / 1024;
+            const ratePerMillionTokens = params.falSeedanceV1FastMode === true ? 1 : 2.5;
+            return (tokens / 1000000) * ratePerMillionTokens;
+        },
+        description: '按 token 计费（近似）：1080p 5秒约 Pro $0.62 / Pro Fast $0.245，其余分辨率按 宽×高×24fps×秒数/1024 换算，Pro $2.5/百万token，Pro Fast $1/百万token'
+    }
+});
+export default seedanceModel;

package/dist/catalog/fal/seedream-5.0-lite.model.d.ts

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

package/dist/catalog/fal/seedream-5.0-lite.model.js

@@ -0,0 +1,92 @@
+import { defineModel } from "../defineModel.js";
+import { FAL_COMMON_IMAGE_RATIOS, falOneMegapixelSize } from './imageSizing.js';
+const SEEDREAM_LITE_RATIOS = FAL_COMMON_IMAGE_RATIOS;
+export const falSeedream50LiteModel = defineModel({
+    meta: {
+        id: 'fal-ai-seedream-5.0-lite', canonicalModelId: 'seedream-5.0-lite', seriesId: 'seedream', seriesRank: 5,
+        provider: 'fal', type: 'image',
+        tags: ['text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'supports-4k', 'provider-fal'],
+        aliases: ['seedream-5-lite-fal'], polling: { interval: 3000, maxAttempts: 180, expectedAttempts: 35 }
+    },
+    inputLimits: { images: { max: 10 }, videos: { max: 0 } },
+    params: [
+        {
+            id: 'falSeedream50LiteAspectRatio', type: 'dropdown', order: 1,
+            default: 'smart',
+            options: [{ value: 'smart' }, ...SEEDREAM_LITE_RATIOS.map((value) => ({ value }))]
+        },
+        {
+            id: 'falSeedream50LiteResolution', type: 'dropdown', order: 2,
+            default: '2K',
+            options: ['2K', '3K', '4K', '1MP'].map((value) => ({ value }))
+        },
+        {
+            id: 'falSeedream50LiteNumImages', type: 'number', order: 3,
+            default: 1, min: 1, max: 6, step: 1
+        },
+        {
+            id: 'falSeedream50LiteMaxImages', type: 'number', order: 4,
+            default: 1, min: 1, max: 6, 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 ? 'bytedance/seedream/v5/lite/edit' : 'bytedance/seedream/v5/lite/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 ratios = FAL_COMMON_IMAGE_RATIOS;
+            const raw = String(params.falSeedream50LiteAspectRatio || 'smart');
+            const hint = typeof params.__firstImageRatio === 'number' && Number.isFinite(params.__firstImageRatio) && params.__firstImageRatio > 0 ? params.__firstImageRatio : 1;
+            let ratio = ratios.includes(raw) ? raw : '1:1';
+            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 = ['3K', '4K'].includes(String(params.falSeedream50LiteResolution)) ? String(params.falSeedream50LiteResolution) : '2K';
+            const oneMegapixel = params.falSeedream50LiteResolution === '1MP';
+            let imageSize = oneMegapixel ? falOneMegapixelSize(ratio) : `auto_${resolution}`;
+            if (!oneMegapixel && raw !== 'smart' && raw !== 'auto') {
+                const longSide = resolution === '4K' ? 4096 : (resolution === '3K' ? 3072 : 2560);
+                const pair = ratio.split(':').map(Number);
+                const width = pair[0] >= pair[1] ? longSide : Math.round(longSide * pair[0] / pair[1]);
+                const height = pair[1] >= pair[0] ? longSide : Math.round(longSide * pair[1] / pair[0]);
+                imageSize = { width, height };
+            }
+            const body = {
+                prompt: typeof params.prompt === 'string' ? params.prompt : '',
+                image_size: imageSize,
+                num_images: Math.min(6, Math.max(1, Math.round(Number(params.falSeedream50LiteNumImages || 1)))),
+                max_images: Math.min(6, Math.max(1, Math.round(Number(params.falSeedream50LiteMaxImages || 1)))),
+                enable_safety_checker: true
+            };
+            if (images.length > 0)
+                body.image_urls = images.slice(0, 10);
+            return body;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const runs = Math.min(6, Math.max(1, Math.round(Number(params.falSeedream50LiteNumImages || 1))));
+            const maximum = Math.min(6, Math.max(1, Math.round(Number(params.falSeedream50LiteMaxImages || 1))));
+            return runs * maximum * 0.035;
+        },
+        description: '$0.035/张；多图模式按最多返回数量估算'
+    }
+});
+export default falSeedream50LiteModel;

package/dist/catalog/fal/seedream-5.0-pro.model.d.ts

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

package/dist/catalog/fal/seedream-5.0-pro.model.js

@@ -0,0 +1,89 @@
+import { defineModel } from "../defineModel.js";
+import { countUploadedImages } from "../shared/mediaPresence.js";
+import { FAL_COMMON_IMAGE_RATIOS, falOneMegapixelSize } from './imageSizing.js';
+const SEEDREAM_PRO_RATIOS = FAL_COMMON_IMAGE_RATIOS;
+export const falSeedream50ProModel = defineModel({
+    meta: {
+        id: 'fal-ai-seedream-5.0-pro', canonicalModelId: 'seedream-5.0-pro', seriesId: 'seedream', seriesRank: 5.1,
+        provider: 'fal', type: 'image',
+        tags: ['text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'provider-fal'],
+        aliases: ['seedream-5-pro-fal'], polling: { interval: 3000, maxAttempts: 180, expectedAttempts: 35 }
+    },
+    inputLimits: { images: { max: 10 }, videos: { max: 0 } },
+    params: [
+        {
+            id: 'falSeedream50ProAspectRatio', type: 'dropdown', order: 1,
+            default: 'smart',
+            options: [{ value: 'smart' }, ...SEEDREAM_PRO_RATIOS.map((value) => ({ value }))]
+        },
+        {
+            id: 'falSeedream50ProResolution', type: 'dropdown', order: 2,
+            default: '2K',
+            options: ['1K', '2K', '1MP'].map((value) => ({ value }))
+        },
+        {
+            id: 'falSeedream50ProNumImages', type: 'number', order: 3,
+            default: 1, min: 1, max: 6, 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 ? 'bytedance/seedream/v5/pro/edit' : 'bytedance/seedream/v5/pro/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 ratios = FAL_COMMON_IMAGE_RATIOS;
+            const raw = String(params.falSeedream50ProAspectRatio || 'smart');
+            const hint = typeof params.__firstImageRatio === 'number' && Number.isFinite(params.__firstImageRatio) && params.__firstImageRatio > 0 ? params.__firstImageRatio : 1;
+            let ratio = ratios.includes(raw) ? raw : '1:1';
+            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 = params.falSeedream50ProResolution === '1K' ? '1K' : '2K';
+            const oneMegapixel = params.falSeedream50ProResolution === '1MP';
+            let imageSize = oneMegapixel ? falOneMegapixelSize(ratio) : `auto_${resolution}`;
+            if (!oneMegapixel && raw !== 'smart' && raw !== 'auto') {
+                const longSide = resolution === '2K' ? 2048 : 1024;
+                const pair = ratio.split(':').map(Number);
+                const width = pair[0] >= pair[1] ? longSide : Math.round(longSide * pair[0] / pair[1]);
+                const height = pair[1] >= pair[0] ? longSide : Math.round(longSide * pair[1] / pair[0]);
+                imageSize = { width, height };
+            }
+            const body = {
+                prompt: typeof params.prompt === 'string' ? params.prompt : '',
+                image_size: imageSize,
+                num_images: Math.min(6, Math.max(1, Math.round(Number(params.falSeedream50ProNumImages || 1)))),
+                enable_safety_checker: true
+            };
+            if (images.length > 0)
+                body.image_urls = images.slice(0, 10);
+            return body;
+        }
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const count = Math.min(6, Math.max(1, Math.round(Number(params.falSeedream50ProNumImages || 1))));
+            const base = params.falSeedream50ProResolution === '1K' || params.falSeedream50ProResolution === '1MP' ? 0.0675 : 0.135;
+            const inputs = countUploadedImages(params);
+            return count * (base + Math.max(0, inputs - 1) * 0.0045);
+        },
+        description: '≤1536² $0.0675、最高 2K $0.135/输出图；第 2 张起输入图 +$0.0045/张'
+    }
+});
+export default falSeedream50ProModel;

package/dist/catalog/fal/seedream-v4.5.model.d.ts

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

package/dist/catalog/fal/seedream-v4.5.model.js

@@ -0,0 +1,154 @@
+import { defineModel } from "../defineModel.js";
+import { calculateSeedreamSizeFromRatio, getImageSize, normalizeSeedreamCustomSize, resolveSeedreamRatio, } from "../shared/seedreamResolution.js";
+const FAL_SEEDREAM_V45_CONSTRAINTS = {
+    minSide: 1920,
+    maxSide: 4096,
+    minPixels: 3686400,
+    maxPixels: 16777216,
+};
+async function resolveFalSeedreamV45Size(resolution, images, ratioHint) {
+    if (!resolution) {
+        return { width: 2048, height: 2048 };
+    }
+    if (resolution.width && resolution.height) {
+        return normalizeSeedreamCustomSize(resolution.width, resolution.height, FAL_SEEDREAM_V45_CONSTRAINTS);
+    }
+    let targetImageRatio = ratioHint;
+    if (resolution.aspectRatio === 'smart' && images.length > 0 && !targetImageRatio) {
+        try {
+            const imageSize = await getImageSize(images[0]);
+            if (imageSize.width > 0 && imageSize.height > 0) {
+                targetImageRatio = imageSize.width / imageSize.height;
+            }
+        }
+        catch {
+            targetImageRatio = null;
+        }
+    }
+    const resolvedRatio = resolveSeedreamRatio(resolution.aspectRatio, targetImageRatio);
+    const quality = resolution.quality === '4K' ? '4K' : '2K';
+    return calculateSeedreamSizeFromRatio(resolvedRatio, quality, FAL_SEEDREAM_V45_CONSTRAINTS);
+}
+export const seedreamV45Model = defineModel({
+    meta: {
+        id: 'fal-ai-bytedance-seedream-v4.5',
+        canonicalModelId: 'seedream-4.5',
+        seriesId: 'seedream',
+        seriesRank: 4.5,
+        provider: 'fal',
+        type: 'image',
+        tags: ['image', 'text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'max-images-10']
+    },
+    inputLimits: {
+        images: { max: 10 },
+        videos: { max: 0 },
+    },
+    runtimeConstraints: {
+        imageSizeFields: [
+            {
+                field: 'image_size',
+                format: 'object',
+                widthKey: 'width',
+                heightKey: 'height',
+                minSide: 1920,
+                maxSide: 4096,
+                minPixels: 3686400,
+                maxPixels: 16777216,
+            },
+        ],
+    },
+    params: [
+        {
+            id: 'falSeedreamV45AspectRatio',
+            order: 1,
+            type: 'dropdown',
+            default: 'smart',
+            options: [
+                { value: 'smart' },
+                { value: '21:9' },
+                { value: '16:9' },
+                { value: '3:2' },
+                { value: '4:3' },
+                { value: '1:1' },
+                { value: '3:4' },
+                { value: '2:3' },
+                { value: '9:16' },
+            ]
+        },
+        {
+            id: 'falSeedreamV45Resolution',
+            order: 2,
+            type: 'dropdown',
+            default: '2K',
+            options: [
+                { value: '2K' },
+                { value: '4K' },
+            ]
+        },
+        {
+            id: 'falSeedream45NumImages',
+            order: 3,
+            type: 'number',
+            default: 1,
+            min: 1,
+            max: 6
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            const uploaded = Array.isArray(params.uploadedFilePaths)
+                ? params.uploadedFilePaths.filter((item) => typeof item === 'string' && item.trim().length > 0)
+                : [];
+            const images = uploaded.length > 0
+                ? uploaded
+                : (Array.isArray(params.images) ? params.images : []);
+            return images.length > 0
+                ? 'fal-ai/bytedance/seedream/v4.5/edit'
+                : 'fal-ai/bytedance/seedream/v4.5/text-to-image';
+        },
+    },
+    request: {
+        builder: async (params) => {
+            const uploaded = Array.isArray(params.uploadedFilePaths)
+                ? params.uploadedFilePaths.filter((item) => typeof item === 'string' && item.trim().length > 0)
+                : [];
+            const images = uploaded.length > 0
+                ? uploaded
+                : (Array.isArray(params.images) ? params.images : []);
+            const prompt = String(params.prompt || '');
+            const numImages = Number(params.falSeedream45NumImages || 1);
+            const legacyResolution = params.falSeedreamV45Resolution && typeof params.falSeedreamV45Resolution === 'object'
+                ? params.falSeedreamV45Resolution
+                : undefined;
+            const aspectRatio = legacyResolution?.aspectRatio ?? String(params.falSeedreamV45AspectRatio || 'smart');
+            const quality = legacyResolution?.quality === '4K' || params.falSeedreamV45Resolution === '4K'
+                ? '4K'
+                : '2K';
+            const ratioHint = typeof params.__firstImageRatio === 'number' &&
+                Number.isFinite(params.__firstImageRatio) &&
+                params.__firstImageRatio > 0
+                ? params.__firstImageRatio
+                : null;
+            const imageSize = await resolveFalSeedreamV45Size(legacyResolution ?? { aspectRatio, quality }, images, ratioHint);
+            const requestData = {
+                prompt,
+                image_size: imageSize,
+                num_images: numImages,
+                enable_safety_checker: false,
+            };
+            if (images.length > 0) {
+                requestData.image_urls = images;
+            }
+            return requestData;
+        },
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const numImages = Number(params.falSeedream45NumImages) || 1;
+            return 0.04 * numImages;
+        },
+        description: '$0.04/张',
+    }
+});
+export default seedreamV45Model;

package/dist/catalog/fal/seedream-v4.model.d.ts

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

package/dist/catalog/fal/seedream-v4.model.js

@@ -0,0 +1,152 @@
+import { defineModel } from "../defineModel.js";
+import { calculateSeedreamSizeFromRatio, getImageSize, normalizeSeedreamCustomSize, resolveSeedreamRatio, } from "../shared/seedreamResolution.js";
+const FAL_SEEDREAM_V4_CONSTRAINTS = {
+    minSide: 1024,
+    maxSide: 4096,
+    maxPixels: 16777216,
+};
+async function resolveFalSeedreamV4Size(resolution, images, ratioHint) {
+    if (!resolution) {
+        return { width: 2048, height: 2048 };
+    }
+    if (resolution.width && resolution.height) {
+        return normalizeSeedreamCustomSize(resolution.width, resolution.height, FAL_SEEDREAM_V4_CONSTRAINTS);
+    }
+    let targetImageRatio = ratioHint;
+    if (resolution.aspectRatio === 'smart' && images.length > 0 && !targetImageRatio) {
+        try {
+            const imageSize = await getImageSize(images[0]);
+            if (imageSize.width > 0 && imageSize.height > 0) {
+                targetImageRatio = imageSize.width / imageSize.height;
+            }
+        }
+        catch {
+            targetImageRatio = null;
+        }
+    }
+    const resolvedRatio = resolveSeedreamRatio(resolution.aspectRatio, targetImageRatio);
+    const quality = resolution.quality === '4K' ? '4K' : '2K';
+    return calculateSeedreamSizeFromRatio(resolvedRatio, quality, FAL_SEEDREAM_V4_CONSTRAINTS);
+}
+export const seedreamV4Model = defineModel({
+    meta: {
+        id: 'fal-ai-bytedance-seedream-v4',
+        canonicalModelId: 'seedream-4.0',
+        seriesId: 'seedream',
+        seriesRank: 4.0,
+        provider: 'fal',
+        type: 'image',
+        tags: ['image', 'text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'max-images-10']
+    },
+    inputLimits: {
+        images: { max: 10 },
+        videos: { max: 0 },
+    },
+    runtimeConstraints: {
+        imageSizeFields: [
+            {
+                field: 'image_size',
+                format: 'object',
+                widthKey: 'width',
+                heightKey: 'height',
+                minSide: 1024,
+                maxSide: 4096,
+                maxPixels: 16777216,
+            },
+        ],
+    },
+    params: [
+        {
+            id: 'falSeedreamV4AspectRatio',
+            order: 1,
+            type: 'dropdown',
+            default: 'smart',
+            options: [
+                { value: 'smart' },
+                { value: '21:9' },
+                { value: '16:9' },
+                { value: '3:2' },
+                { value: '4:3' },
+                { value: '1:1' },
+                { value: '3:4' },
+                { value: '2:3' },
+                { value: '9:16' },
+            ]
+        },
+        {
+            id: 'falSeedreamV4Resolution',
+            order: 2,
+            type: 'dropdown',
+            default: '2K',
+            options: [
+                { value: '2K' },
+                { value: '4K' },
+            ]
+        },
+        {
+            id: 'falSeedream40NumImages',
+            order: 3,
+            type: 'number',
+            default: 1,
+            min: 1,
+            max: 6
+        }
+    ],
+    endpoints: {
+        selector: async (params) => {
+            const uploaded = Array.isArray(params.uploadedFilePaths)
+                ? params.uploadedFilePaths.filter((item) => typeof item === 'string' && item.trim().length > 0)
+                : [];
+            const images = uploaded.length > 0
+                ? uploaded
+                : (Array.isArray(params.images) ? params.images : []);
+            return images.length > 0
+                ? 'fal-ai/bytedance/seedream/v4/edit'
+                : 'fal-ai/bytedance/seedream/v4/text-to-image';
+        },
+    },
+    request: {
+        builder: async (params) => {
+            const uploaded = Array.isArray(params.uploadedFilePaths)
+                ? params.uploadedFilePaths.filter((item) => typeof item === 'string' && item.trim().length > 0)
+                : [];
+            const images = uploaded.length > 0
+                ? uploaded
+                : (Array.isArray(params.images) ? params.images : []);
+            const prompt = String(params.prompt || '');
+            const numImages = Number(params.falSeedream40NumImages || 1);
+            const legacyResolution = params.falSeedreamV4Resolution && typeof params.falSeedreamV4Resolution === 'object'
+                ? params.falSeedreamV4Resolution
+                : undefined;
+            const aspectRatio = legacyResolution?.aspectRatio ?? String(params.falSeedreamV4AspectRatio || 'smart');
+            const quality = legacyResolution?.quality === '4K' || params.falSeedreamV4Resolution === '4K'
+                ? '4K'
+                : '2K';
+            const ratioHint = typeof params.__firstImageRatio === 'number' &&
+                Number.isFinite(params.__firstImageRatio) &&
+                params.__firstImageRatio > 0
+                ? params.__firstImageRatio
+                : null;
+            const imageSize = await resolveFalSeedreamV4Size(legacyResolution ?? { aspectRatio, quality }, images, ratioHint);
+            const requestData = {
+                prompt,
+                image_size: imageSize,
+                num_images: numImages,
+                enable_safety_checker: false,
+            };
+            if (images.length > 0) {
+                requestData.image_urls = images;
+            }
+            return requestData;
+        },
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => {
+            const numImages = Number(params.falSeedream40NumImages) || 1;
+            return 0.03 * numImages;
+        },
+        description: '$0.03/张',
+    }
+});
+export default seedreamV4Model;