@henjicc/ai-sdk 0.2.8

package/dist/structured-output/seedream-layer-stack.js

@@ -0,0 +1,206 @@
+import { AiRuntimeError } from '../runtime/AiRuntimeError.js';
+export function parseSeedreamLayerStack(provider, metadata) {
+    const rawLayers = provider === 'volcengine'
+        ? readVolcengineLayers(metadata)
+        : provider === 'apimart'
+            ? readApiMartLayers(metadata)
+            : readKieLayers(metadata);
+    const outputs = validateLayers(rawLayers);
+    return {
+        version: 1,
+        kind: 'layer-stack',
+        primary: outputs[0],
+        outputs,
+        metadata: {
+            colorSpace: 'srgb',
+            alphaMode: 'straight',
+            compositeOperation: 'source-over',
+            order: 'bottom-to-top',
+        },
+    };
+}
+function readVolcengineLayers(value) {
+    const root = object(value, '火山响应');
+    const data = array(root.data, '火山 data');
+    return data.map((item, sourceOutputIndex) => {
+        const layer = object(item, `火山 data[${sourceOutputIndex}]`);
+        return fromObject(layer, sourceOutputIndex);
+    });
+}
+function readApiMartLayers(value) {
+    const root = object(value, 'APIMart 响应');
+    const data = isObject(root.data) ? root.data : root;
+    const result = object(data.result, 'APIMart result');
+    const images = array(result.images, 'APIMart result.images');
+    if (images.length !== 1)
+        invalid('APIMart 图层响应必须且只能包含一组 images');
+    const image = object(images[0], 'APIMart result.images[0]');
+    const urls = array(image.url, 'APIMart url');
+    const sizes = array(image.sizes, 'APIMart sizes');
+    const formats = array(image.output_formats, 'APIMart output_formats');
+    const layers = array(image.layers, 'APIMart layers');
+    if (urls.length !== sizes.length || urls.length !== formats.length || urls.length !== layers.length) {
+        invalid('APIMart 图层平行数组长度不一致');
+    }
+    return layers.map((item, sourceOutputIndex) => {
+        const layer = object(item, `APIMart layers[${sourceOutputIndex}]`);
+        return {
+            ...fromObject(layer, sourceOutputIndex),
+            url: urls[sourceOutputIndex],
+            size: sizes[sourceOutputIndex],
+            format: formats[sourceOutputIndex],
+        };
+    });
+}
+function readKieLayers(value) {
+    const root = object(value, 'KIE 响应');
+    const data = object(root.data, 'KIE data');
+    if (typeof data.resultJson !== 'string')
+        invalid('KIE resultJson 缺失');
+    let parsed;
+    try {
+        parsed = JSON.parse(data.resultJson);
+    }
+    catch {
+        return invalid('KIE resultJson 不是合法 JSON');
+    }
+    const resultObject = object(object(parsed, 'KIE resultJson').resultObject, 'KIE resultObject');
+    return array(resultObject.layers_data, 'KIE layers_data').map((item, sourceOutputIndex) => {
+        const layer = object(item, `KIE layers_data[${sourceOutputIndex}]`);
+        return fromObject(layer, sourceOutputIndex);
+    });
+}
+function fromObject(layer, sourceOutputIndex) {
+    return {
+        sourceOutputIndex,
+        url: layer.url,
+        zIndex: layer.z_index,
+        name: layer.name,
+        description: layer.description,
+        size: layer.size,
+        format: layer.output_format,
+        boundingBox: layer.bounding_box,
+    };
+}
+function validateLayers(rawLayers) {
+    if (rawLayers.length < 1 || rawLayers.length > 17) {
+        invalid(`图层输出数量必须为 1..17，实际 ${rawLayers.length}`);
+    }
+    const zIndexes = new Set();
+    const outputs = rawLayers.map((raw) => {
+        const url = nonEmptyString(raw.url, `layers[${raw.sourceOutputIndex}].url`);
+        const zIndex = integer(raw.zIndex, `layers[${raw.sourceOutputIndex}].z_index`);
+        if (zIndex < 0 || zIndex > 16 || zIndexes.has(zIndex))
+            invalid(`图层 z_index 无效或重复：${zIndex}`);
+        zIndexes.add(zIndex);
+        const { width, height } = parseSize(raw.size, raw.sourceOutputIndex);
+        const format = parseFormat(raw.format, raw.sourceOutputIndex);
+        if (zIndex > 0 && format !== 'png')
+            invalid(`内容层 ${zIndex} 必须为 PNG`);
+        const boundingBox = parseBoundingBox(raw.boundingBox, zIndex);
+        const name = optionalString(raw.name);
+        const description = optionalString(raw.description);
+        return {
+            version: 1,
+            sourceOutputIndex: raw.sourceOutputIndex,
+            url,
+            zIndex,
+            role: zIndex === 0 ? 'base' : 'content',
+            ...(name ? { name } : {}),
+            ...(description ? { description } : {}),
+            width,
+            height,
+            format,
+            ...(boundingBox ? { boundingBox } : {}),
+        };
+    }).sort((left, right) => left.zIndex - right.zIndex);
+    if (outputs[0]?.zIndex !== 0)
+        invalid('图层响应缺少 z_index=0 的底图');
+    if (outputs.some((layer, index) => layer.zIndex !== index))
+        invalid('图层 z_index 必须从 0 开始连续');
+    return outputs;
+}
+function parseSize(value, index) {
+    if (typeof value !== 'string')
+        invalid(`layers[${index}].size 缺失`);
+    const match = /^(\d+)x(\d+)$/.exec(value.trim());
+    if (!match)
+        return invalid(`layers[${index}].size 必须为 WIDTHxHEIGHT`);
+    const width = Number(match[1]);
+    const height = Number(match[2]);
+    if (width < 1 || height < 1)
+        invalid(`layers[${index}].size 必须为正尺寸`);
+    return { width, height };
+}
+function parseFormat(value, index) {
+    const normalized = nonEmptyString(value, `layers[${index}].format`).toLowerCase();
+    if (normalized === 'jpg')
+        return 'jpeg';
+    if (normalized === 'png' || normalized === 'jpeg' || normalized === 'webp')
+        return normalized;
+    return invalid(`layers[${index}].format 不受支持：${normalized}`);
+}
+function parseBoundingBox(value, zIndex) {
+    if (value === undefined || value === null) {
+        if (zIndex > 0)
+            invalid(`内容层 ${zIndex} 缺少 bounding_box`);
+        return undefined;
+    }
+    if (!isJsonValue(value))
+        invalid(`图层 ${zIndex} bounding_box 不是 JSON`);
+    const box = object(value, `图层 ${zIndex} bounding_box`);
+    const absolute = tuple(box.absolute, `图层 ${zIndex} bounding_box.absolute`, false);
+    const normalized = tuple(box.normalized, `图层 ${zIndex} bounding_box.normalized`, true);
+    if (!absolute && !normalized)
+        invalid(`图层 ${zIndex} bounding_box 至少需要一种坐标`);
+    return { ...(absolute ? { absolute } : {}), ...(normalized ? { normalized } : {}) };
+}
+function tuple(value, label, normalized) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value) || value.length !== 4 || value.some((item) => typeof item !== 'number' || !Number.isFinite(item))) {
+        return invalid(`${label} 必须为 4 个有限数字`);
+    }
+    const result = value;
+    if (result[2] <= result[0] || result[3] <= result[1])
+        invalid(`${label} 必须满足 right>left 且 bottom>top`);
+    if (normalized && result.some((item) => item < 0 || item > 1000))
+        invalid(`${label} 必须位于 0..1000`);
+    return result;
+}
+function object(value, label) {
+    if (!isObject(value))
+        return invalid(`${label} 必须为对象`);
+    return value;
+}
+function array(value, label) {
+    if (!Array.isArray(value))
+        return invalid(`${label} 必须为数组`);
+    return value;
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isJsonValue(value) {
+    if (value === null || ['string', 'number', 'boolean'].includes(typeof value))
+        return true;
+    if (Array.isArray(value))
+        return value.every(isJsonValue);
+    return isObject(value) && Object.values(value).every(isJsonValue);
+}
+function nonEmptyString(value, label) {
+    if (typeof value !== 'string' || value.trim().length === 0)
+        return invalid(`${label} 不能为空`);
+    return value.trim();
+}
+function optionalString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+function integer(value, label) {
+    if (typeof value !== 'number' || !Number.isInteger(value))
+        return invalid(`${label} 必须为整数`);
+    return value;
+}
+function invalid(message) {
+    throw new AiRuntimeError('invalid_response', message);
+}

package/dist/tool-packs/fal-erase/models/bria-eraser.model.d.ts

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

package/dist/tool-packs/fal-erase/models/bria-eraser.model.js

@@ -0,0 +1,38 @@
+import { defineModel } from '../../../catalog/defineModel.js';
+export const briaEraserModel = defineModel({
+    meta: {
+        id: 'fal-bria-eraser',
+        canonicalModelId: 'bria-eraser',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-edit', 'erase', 'mask-input', 'provider-fal'],
+        polling: { interval: 2_000, maxAttempts: 180, expectedAttempts: 20 },
+    },
+    acceptsPrompt: false,
+    inputLimits: { images: { exact: 2 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'fal-bria-eraser-media',
+            require: { images: { exact: 2 } },
+            message: { title: '需要原图和遮罩', message: '请提供原图与用户绘制的二值遮罩。', type: 'error' },
+        }],
+    params: [
+        { id: 'image', type: 'image-upload', order: 1, required: true, valueType: 'array', default: [], maxCount: 1 },
+        { id: 'mask', type: 'image-upload', order: 2, required: true, valueType: 'array', default: [], maxCount: 1 },
+    ],
+    runtimeConstraints: {
+        mediaFields: [{ field: 'image_url', kind: 'image' }, { field: 'mask_url', kind: 'image' }],
+    },
+    endpoints: 'fal-ai/bria/eraser',
+    request: {
+        builder: (params) => ({
+            image_url: firstMedia(params.image),
+            mask_url: firstMedia(params.mask),
+            mask_type: 'manual',
+        }),
+    },
+    pricing: { currency: '$', fixed: 0.04, description: '$0.04/次' },
+});
+function firstMedia(value) {
+    return Array.isArray(value) && typeof value[0] === 'string' ? value[0] : '';
+}
+export default briaEraserModel;

package/dist/tool-packs/fal-erase/models/finegrain-eraser.model.d.ts

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

package/dist/tool-packs/fal-erase/models/finegrain-eraser.model.js

@@ -0,0 +1,47 @@
+import { defineModel } from '../../../catalog/defineModel.js';
+export const finegrainEraserModel = defineModel({
+    meta: {
+        id: 'fal-finegrain-eraser',
+        canonicalModelId: 'finegrain-eraser',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-edit', 'erase', 'mask-input', 'provider-fal'],
+        polling: { interval: 2_000, maxAttempts: 180, expectedAttempts: 20 },
+    },
+    acceptsPrompt: false,
+    inputLimits: { images: { exact: 2 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'fal-finegrain-eraser-media',
+            require: { images: { exact: 2 } },
+            message: { title: '需要原图和遮罩', message: '请提供原图与二值遮罩。', type: 'error' },
+        }],
+    params: [
+        { id: 'image', type: 'image-upload', order: 1, required: true, valueType: 'array', default: [], maxCount: 1 },
+        { id: 'mask', type: 'image-upload', order: 2, required: true, valueType: 'array', default: [], maxCount: 1 },
+        {
+            id: 'mode', type: 'dropdown', order: 3, default: 'standard',
+            options: [{ value: 'express' }, { value: 'standard' }, { value: 'premium' }],
+        },
+    ],
+    runtimeConstraints: {
+        mediaFields: [{ field: 'image_url', kind: 'image' }, { field: 'mask_url', kind: 'image' }],
+        enumFields: [{ field: 'mode', allowed: ['express', 'standard', 'premium'], fallback: 'standard' }],
+    },
+    endpoints: 'fal-ai/finegrain-eraser/mask',
+    request: {
+        builder: (params) => ({
+            image_url: firstMedia(params.image),
+            mask_url: firstMedia(params.mask),
+            mode: ['express', 'premium'].includes(String(params.mode)) ? String(params.mode) : 'standard',
+        }),
+    },
+    pricing: {
+        currency: '$',
+        calculator: (params) => params.mode === 'express' ? 0.04 : params.mode === 'premium' ? 0.22 : 0.13,
+        description: 'Express $0.04 / Standard $0.13 / Premium $0.22',
+    },
+});
+function firstMedia(value) {
+    return Array.isArray(value) && typeof value[0] === 'string' ? value[0] : '';
+}
+export default finegrainEraserModel;

package/dist/tool-packs/fal-erase/models/flux-pro-erase.model.d.ts

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

package/dist/tool-packs/fal-erase/models/flux-pro-erase.model.js

@@ -0,0 +1,42 @@
+import { defineModel } from '../../../catalog/defineModel.js';
+export const fluxProEraseModel = defineModel({
+    meta: {
+        id: 'fal-flux-pro-erase',
+        canonicalModelId: 'flux-pro-erase',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-edit', 'erase', 'mask-input', 'provider-fal'],
+        polling: { interval: 2_000, maxAttempts: 180, expectedAttempts: 20 },
+    },
+    acceptsPrompt: false,
+    inputLimits: { images: { exact: 2 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'fal-flux-pro-erase-media',
+            require: { images: { exact: 2 } },
+            message: { title: '需要原图和遮罩', message: '请提供原图与同尺寸黑白遮罩。', type: 'error' },
+        }],
+    params: [
+        { id: 'image', type: 'image-upload', order: 1, required: true, valueType: 'array', default: [], maxCount: 1 },
+        { id: 'mask', type: 'image-upload', order: 2, required: true, valueType: 'array', default: [], maxCount: 1 },
+    ],
+    runtimeConstraints: {
+        mediaFields: [{ field: 'image_url', kind: 'image' }, { field: 'mask_url', kind: 'image' }],
+    },
+    endpoints: 'fal-ai/flux-pro/v1/erase',
+    request: {
+        builder: (params) => ({
+            image_url: firstMedia(params.image),
+            mask_url: firstMedia(params.mask),
+            dilate_pixels: 10,
+        }),
+    },
+    pricing: {
+        currency: '$',
+        fixed: 0.042,
+        description: '最低约 $0.042：首个生成 MP $0.03，后续生成 MP $0.004；参考图 $0.004/MP，至少按 3 MP',
+    },
+});
+function firstMedia(value) {
+    return Array.isArray(value) && typeof value[0] === 'string' ? value[0] : '';
+}
+export default fluxProEraseModel;

package/dist/tool-packs/fal-image-utilities/models/control-light.model.d.ts

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

package/dist/tool-packs/fal-image-utilities/models/control-light.model.js

@@ -0,0 +1,42 @@
+import { defineModel } from '../../../catalog/defineModel.js';
+import { clampNumber, requireSingleUtilityImage } from '../shared.js';
+export const falControlLightModel = defineModel({
+    meta: {
+        id: 'fal-control-light',
+        canonicalModelId: 'control-light',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-edit', 'low-light-enhancement', 'provider-fal'],
+        polling: { interval: 2_000, maxAttempts: 180, expectedAttempts: 30 },
+    },
+    acceptsPrompt: false,
+    inputLimits: { images: { exact: 1 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'fal-control-light-source',
+            require: { images: { exact: 1 } },
+            message: { title: '需要单张暗光图片', message: '暗光增强必须且只能提供 1 张源图。', type: 'error' },
+        }],
+    params: [
+        { id: 'image', type: 'image-upload', order: 1, required: true, valueType: 'array', default: [], maxCount: 1 },
+        { id: 'lightingLevel', type: 'number', order: 2, default: 0.75, min: 0, max: 1, step: 0.05 },
+    ],
+    runtimeConstraints: {
+        mediaFields: [{ field: 'image_url', kind: 'image' }],
+        numberFields: [{ field: 'lighting_level', min: 0, max: 1, fallback: 0.75 }],
+    },
+    endpoints: 'fal-ai/control-light',
+    request: {
+        builder: (params) => ({
+            image_url: requireSingleUtilityImage(params, 'Fal 暗光增强'),
+            lighting_level: clampNumber(params.lightingLevel, 0, 1, 0.75),
+        }),
+    },
+    pricing: {
+        currency: '$',
+        calculator: () => 0.03,
+        estimateMode: 'unit',
+        estimateUnit: 'MP',
+        description: 'Fal 标示 $0.03/MP 的单位参考价；计费像素口径及实际总价以 Fal 平台账单为准',
+    },
+});
+export default falControlLightModel;

package/dist/tool-packs/fal-image-utilities/models/outpaint.model.d.ts

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

package/dist/tool-packs/fal-image-utilities/models/outpaint.model.js

@@ -0,0 +1,74 @@
+import { defineModel } from '../../../catalog/defineModel.js';
+import { clampInteger, clampNumber, requireSingleUtilityImage, } from '../shared.js';
+export const falOutpaintModel = defineModel({
+    meta: {
+        id: 'fal-image-apps-v2-outpaint',
+        canonicalModelId: 'image-apps-v2-outpaint',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-edit', 'outpainting', 'provider-fal'],
+        polling: { interval: 2_000, maxAttempts: 180, expectedAttempts: 30 },
+    },
+    inputLimits: { images: { exact: 1 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'fal-outpaint-source',
+            require: { images: { exact: 1 } },
+            message: { title: '需要单张源图', message: '扩图必须且只能提供 1 张源图。', type: 'error' },
+        }],
+    params: [
+        { id: 'image', type: 'image-upload', order: 1, required: true, valueType: 'array', default: [], maxCount: 1 },
+        { id: 'expandLeft', type: 'number', order: 2, default: 0, min: 0, max: 700, step: 1 },
+        { id: 'expandRight', type: 'number', order: 3, default: 0, min: 0, max: 700, step: 1 },
+        { id: 'expandTop', type: 'number', order: 4, default: 0, min: 0, max: 700, step: 1 },
+        { id: 'expandBottom', type: 'number', order: 5, default: 0, min: 0, max: 700, step: 1 },
+        { id: 'zoomOutPercentage', type: 'number', order: 6, default: 20, min: 0, max: 90, step: 1 },
+        { id: 'prompt', type: 'textarea', order: 7, default: '', maxLength: 500 },
+    ],
+    runtimeConstraints: {
+        mediaFields: [{ field: 'image_url', kind: 'image' }],
+        numberFields: [
+            { field: 'expand_left', min: 0, max: 700, integer: true, fallback: 0 },
+            { field: 'expand_right', min: 0, max: 700, integer: true, fallback: 0 },
+            { field: 'expand_top', min: 0, max: 700, integer: true, fallback: 0 },
+            { field: 'expand_bottom', min: 0, max: 700, integer: true, fallback: 0 },
+            { field: 'zoom_out_percentage', min: 0, max: 90, fallback: 20 },
+        ],
+    },
+    endpoints: 'fal-ai/image-apps-v2/outpaint',
+    request: {
+        builder: (params) => {
+            const image = requireSingleUtilityImage(params, 'Fal 扩图');
+            const expandLeft = clampInteger(params.expandLeft, 0, 700, 0);
+            const expandRight = clampInteger(params.expandRight, 0, 700, 0);
+            const expandTop = clampInteger(params.expandTop, 0, 700, 0);
+            const expandBottom = clampInteger(params.expandBottom, 0, 700, 0);
+            const zoomOutPercentage = clampNumber(params.zoomOutPercentage, 0, 90, 20);
+            if (expandLeft + expandRight + expandTop + expandBottom === 0 && zoomOutPercentage === 0) {
+                throw new Error('Fal 扩图至少需要扩展一侧或设置大于 0 的缩小比例');
+            }
+            const body = {
+                image_url: image,
+                expand_left: expandLeft,
+                expand_right: expandRight,
+                expand_top: expandTop,
+                expand_bottom: expandBottom,
+                zoom_out_percentage: zoomOutPercentage,
+            };
+            const prompt = typeof params.prompt === 'string' ? params.prompt.trim() : '';
+            if (prompt.length > 500) {
+                throw new Error('Fal 扩图提示词最多 500 个字符');
+            }
+            if (prompt.length > 0)
+                body.prompt = prompt;
+            return body;
+        },
+    },
+    pricing: {
+        currency: '$',
+        calculator: () => 0.035,
+        estimateMode: 'unit',
+        estimateUnit: 'MP',
+        description: 'Fal 标示 $0.035/MP 的单位参考价；计费像素口径及实际总价以 Fal 平台账单为准',
+    },
+});
+export default falOutpaintModel;

package/dist/tool-packs/fal-image-utilities/models/photo-restoration.model.d.ts

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

package/dist/tool-packs/fal-image-utilities/models/photo-restoration.model.js

@@ -0,0 +1,56 @@
+import { defineModel } from '../../../catalog/defineModel.js';
+import { FAL_IMAGE_APP_RATIO_OPTIONS, booleanValue, requireSingleUtilityImage, resolveImageAppRatio, } from '../shared.js';
+export const falPhotoRestorationModel = defineModel({
+    meta: {
+        id: 'fal-image-apps-v2-photo-restoration',
+        canonicalModelId: 'image-apps-v2-photo-restoration',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-edit', 'photo-restoration', 'provider-fal'],
+        polling: { interval: 2_000, maxAttempts: 180, expectedAttempts: 30 },
+    },
+    acceptsPrompt: false,
+    inputLimits: { images: { exact: 1 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'fal-photo-restoration-source',
+            require: { images: { exact: 1 } },
+            message: { title: '需要单张旧照片', message: '照片修复必须且只能提供 1 张源图。', type: 'error' },
+        }],
+    params: [
+        { id: 'image', type: 'image-upload', order: 1, required: true, valueType: 'array', default: [], maxCount: 1 },
+        { id: 'enhanceResolution', type: 'switch', order: 2, default: true },
+        { id: 'fixColors', type: 'switch', order: 3, default: true },
+        { id: 'removeScratches', type: 'switch', order: 4, default: true },
+        {
+            id: 'aspectRatio',
+            type: 'aspect-ratio',
+            order: 5,
+            default: 'smart',
+            options: FAL_IMAGE_APP_RATIO_OPTIONS.map((value) => ({ value })),
+        },
+    ],
+    runtimeConstraints: {
+        mediaFields: [{ field: 'image_url', kind: 'image' }],
+    },
+    endpoints: 'fal-ai/image-apps-v2/photo-restoration',
+    request: {
+        builder: (params) => {
+            const image = requireSingleUtilityImage(params, 'Fal 照片修复');
+            const enhanceResolution = booleanValue(params.enhanceResolution, true);
+            const fixColors = booleanValue(params.fixColors, true);
+            const removeScratches = booleanValue(params.removeScratches, true);
+            if (!enhanceResolution && !fixColors && !removeScratches) {
+                throw new Error('Fal 照片修复至少需要开启一项修复能力');
+            }
+            return {
+                image_url: image,
+                enhance_resolution: enhanceResolution,
+                fix_colors: fixColors,
+                remove_scratches: removeScratches,
+                aspect_ratio: { ratio: resolveImageAppRatio(params) },
+            };
+        },
+    },
+    pricing: { currency: '$', fixed: 0.04, description: '$0.04/张' },
+});
+export default falPhotoRestorationModel;

package/dist/tool-packs/fal-image-utilities/models/pixelcut-background-removal.model.d.ts

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

package/dist/tool-packs/fal-image-utilities/models/pixelcut-background-removal.model.js

@@ -0,0 +1,41 @@
+import { defineModel } from '../../../catalog/defineModel.js';
+import { requireSingleUtilityImage } from '../shared.js';
+export const falPixelcutBackgroundRemovalModel = defineModel({
+    meta: {
+        id: 'fal-pixelcut-background-removal',
+        canonicalModelId: 'pixelcut-background-removal',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-edit', 'background-removal', 'alpha-output', 'provider-fal'],
+        polling: { interval: 2_000, maxAttempts: 180, expectedAttempts: 30 },
+    },
+    acceptsPrompt: false,
+    inputLimits: { images: { exact: 1 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'fal-pixelcut-background-removal-source',
+            require: { images: { exact: 1 } },
+            message: { title: '需要单张图片', message: '背景移除必须且只能提供 1 张 JPEG 或 PNG 图片。', type: 'error' },
+        }],
+    params: [{
+            id: 'image',
+            type: 'image-upload',
+            order: 1,
+            required: true,
+            valueType: 'array',
+            default: [],
+            maxCount: 1,
+            accept: ['image/jpeg', 'image/png'],
+        }],
+    runtimeConstraints: {
+        mediaFields: [{ field: 'image_url', kind: 'image' }],
+    },
+    endpoints: 'pixelcut/background-removal',
+    request: {
+        builder: (params) => ({
+            image_url: requireSingleUtilityImage(params, 'Fal Pixelcut 背景移除'),
+            sync_mode: false,
+        }),
+    },
+    pricing: { currency: '$', fixed: 0.016, description: '$0.016/张' },
+});
+export default falPixelcutBackgroundRemovalModel;

package/dist/tool-packs/fal-image-utilities/models/product-photography.model.d.ts

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

package/dist/tool-packs/fal-image-utilities/models/product-photography.model.js

@@ -0,0 +1,41 @@
+import { defineModel } from '../../../catalog/defineModel.js';
+import { FAL_IMAGE_APP_RATIO_OPTIONS, requireSingleUtilityImage, resolveImageAppRatio, } from '../shared.js';
+export const falProductPhotographyModel = defineModel({
+    meta: {
+        id: 'fal-image-apps-v2-product-photography',
+        canonicalModelId: 'image-apps-v2-product-photography',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-edit', 'product-photography', 'background-generation', 'provider-fal'],
+        polling: { interval: 2_000, maxAttempts: 180, expectedAttempts: 30 },
+    },
+    acceptsPrompt: false,
+    inputLimits: { images: { exact: 1 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'fal-product-photography-source',
+            require: { images: { exact: 1 } },
+            message: { title: '需要单张商品图', message: '商品摄影必须且只能提供 1 张商品图。', type: 'error' },
+        }],
+    params: [
+        { id: 'image', type: 'image-upload', order: 1, required: true, valueType: 'array', default: [], maxCount: 1 },
+        {
+            id: 'aspectRatio',
+            type: 'aspect-ratio',
+            order: 2,
+            default: 'smart',
+            options: FAL_IMAGE_APP_RATIO_OPTIONS.map((value) => ({ value })),
+        },
+    ],
+    runtimeConstraints: {
+        mediaFields: [{ field: 'product_image_url', kind: 'image' }],
+    },
+    endpoints: 'fal-ai/image-apps-v2/product-photography',
+    request: {
+        builder: (params) => ({
+            product_image_url: requireSingleUtilityImage(params, 'Fal 商品摄影'),
+            aspect_ratio: { ratio: resolveImageAppRatio(params) },
+        }),
+    },
+    pricing: { currency: '$', fixed: 0.04, description: '$0.04/张' },
+});
+export default falProductPhotographyModel;

package/dist/tool-packs/fal-image-utilities/models/relighting.model.d.ts

@@ -0,0 +1,3 @@
+export declare const FAL_RELIGHTING_STYLES: readonly ["natural", "studio", "golden_hour", "blue_hour", "dramatic", "soft", "hard", "backlight", "side_light", "front_light", "rim_light", "sunset", "sunrise", "neon", "candlelight", "moonlight", "spotlight", "ambient"];
+export declare const falRelightingModel: import("../../../index.js").ModelRuntimeDefinition;
+export default falRelightingModel;