@henjicc/ai-sdk 0.2.8

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

@@ -0,0 +1,74 @@
+import { defineModel } from '../../../catalog/defineModel.js';
+import { FAL_IMAGE_APP_RATIO_OPTIONS, requireSingleUtilityImage, resolveImageAppRatio, } from '../shared.js';
+export const FAL_RELIGHTING_STYLES = [
+    'natural',
+    'studio',
+    'golden_hour',
+    'blue_hour',
+    'dramatic',
+    'soft',
+    'hard',
+    'backlight',
+    'side_light',
+    'front_light',
+    'rim_light',
+    'sunset',
+    'sunrise',
+    'neon',
+    'candlelight',
+    'moonlight',
+    'spotlight',
+    'ambient',
+];
+export const falRelightingModel = defineModel({
+    meta: {
+        id: 'fal-image-apps-v2-relighting',
+        canonicalModelId: 'image-apps-v2-relighting',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-edit', 'relighting', 'style-presets', 'provider-fal'],
+        polling: { interval: 2_000, maxAttempts: 180, expectedAttempts: 30 },
+    },
+    acceptsPrompt: false,
+    inputLimits: { images: { exact: 1 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'fal-relighting-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: 'lightingStyle',
+            type: 'dropdown',
+            order: 2,
+            default: 'natural',
+            options: FAL_RELIGHTING_STYLES.map((value) => ({ value })),
+        },
+        {
+            id: 'aspectRatio',
+            type: 'aspect-ratio',
+            order: 3,
+            default: 'smart',
+            options: FAL_IMAGE_APP_RATIO_OPTIONS.map((value) => ({ value })),
+        },
+    ],
+    runtimeConstraints: {
+        mediaFields: [{ field: 'image_url', kind: 'image' }],
+        enumFields: [{ field: 'lighting_style', allowed: [...FAL_RELIGHTING_STYLES], fallback: 'natural' }],
+    },
+    endpoints: 'fal-ai/image-apps-v2/relighting',
+    request: {
+        builder: (params) => {
+            const requestedStyle = String(params.lightingStyle || 'natural');
+            const lightingStyle = FAL_RELIGHTING_STYLES.includes(requestedStyle) ? requestedStyle : 'natural';
+            return {
+                image_url: requireSingleUtilityImage(params, 'Fal 重打光'),
+                lighting_style: lightingStyle,
+                aspect_ratio: { ratio: resolveImageAppRatio(params) },
+            };
+        },
+    },
+    pricing: { currency: '$', fixed: 0.04, description: '$0.04/张' },
+});
+export default falRelightingModel;

package/dist/tool-packs/fal-image-utilities/shared.d.ts

@@ -0,0 +1,9 @@
+import type { JsonObject, JsonValue } from '../../types/runtime.js';
+export declare const FAL_IMAGE_APP_RATIOS: readonly ["1:1", "16:9", "9:16", "4:3", "3:4"];
+export declare const FAL_IMAGE_APP_RATIO_OPTIONS: readonly ["smart", "1:1", "16:9", "9:16", "4:3", "3:4"];
+export type FalImageAppRatio = (typeof FAL_IMAGE_APP_RATIOS)[number];
+export declare function requireSingleUtilityImage(params: JsonObject, label: string): string;
+export declare function resolveImageAppRatio(params: JsonObject, field?: string): FalImageAppRatio;
+export declare function clampNumber(value: JsonValue, min: number, max: number, fallback: number): number;
+export declare function clampInteger(value: JsonValue, min: number, max: number, fallback: number): number;
+export declare function booleanValue(value: JsonValue, fallback: boolean): boolean;

package/dist/tool-packs/fal-image-utilities/shared.js

@@ -0,0 +1,54 @@
+export const FAL_IMAGE_APP_RATIOS = ['1:1', '16:9', '9:16', '4:3', '3:4'];
+export const FAL_IMAGE_APP_RATIO_OPTIONS = ['smart', ...FAL_IMAGE_APP_RATIOS];
+export function requireSingleUtilityImage(params, label) {
+    const images = [
+        params.uploadedFilePaths,
+        params.images,
+        params.uploadedImages,
+        params.image,
+    ]
+        .map(cleanMedia)
+        .find((items) => items.length > 0) ?? [];
+    if (images.length !== 1) {
+        throw new Error(`${label}必须且只能提供 1 张源图`);
+    }
+    return images[0];
+}
+export function resolveImageAppRatio(params, field = 'aspectRatio') {
+    const requested = typeof params[field] === 'string' ? params[field] : 'smart';
+    if (FAL_IMAGE_APP_RATIOS.includes(requested)) {
+        return requested;
+    }
+    const ratioHint = finiteNumber(params.__firstImageRatio, 1);
+    const sourceRatio = ratioHint > 0 ? ratioHint : 1;
+    return FAL_IMAGE_APP_RATIOS.reduce((best, candidate) => {
+        return ratioDistance(candidate, sourceRatio) < ratioDistance(best, sourceRatio)
+            ? candidate
+            : best;
+    }, '1:1');
+}
+export function clampNumber(value, min, max, fallback) {
+    const numeric = finiteNumber(value, fallback);
+    return Math.min(max, Math.max(min, numeric));
+}
+export function clampInteger(value, min, max, fallback) {
+    return Math.round(clampNumber(value, min, max, fallback));
+}
+export function booleanValue(value, fallback) {
+    return typeof value === 'boolean' ? value : fallback;
+}
+function cleanMedia(value) {
+    return Array.isArray(value)
+        ? value
+            .filter((item) => typeof item === 'string' && item.trim().length > 0)
+            .map((item) => item.trim())
+        : [];
+}
+function finiteNumber(value, fallback) {
+    const numeric = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(numeric) ? numeric : fallback;
+}
+function ratioDistance(candidate, target) {
+    const [width, height] = candidate.split(':').map(Number);
+    return Math.abs(width / height - target);
+}

package/dist/tool-packs/fal-multi-angle/models/flux-2-multiple-angles.model.d.ts

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

package/dist/tool-packs/fal-multi-angle/models/flux-2-multiple-angles.model.js

@@ -0,0 +1,75 @@
+import { defineModel } from '../../../catalog/defineModel.js';
+import { FAL_COMMON_IMAGE_RATIOS, falOneMegapixelSize, } from '../../../catalog/fal/imageSizing.js';
+import { requireSingleMultiAngleImage } from '../shared.js';
+function clampNumber(value, min, max, fallback) {
+    const numeric = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(numeric) ? Math.min(max, Math.max(min, numeric)) : fallback;
+}
+function nearestImageRatio(ratio) {
+    return FAL_COMMON_IMAGE_RATIOS.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 falFlux2MultipleAnglesModel = defineModel({
+    meta: {
+        id: 'fal-flux-2-multiple-angles',
+        canonicalModelId: 'flux-2-multiple-angles',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-edit', 'multi-angle', 'camera-control', 'provider-fal'],
+        polling: { interval: 2_000, maxAttempts: 180, expectedAttempts: 30 },
+    },
+    acceptsPrompt: false,
+    inputLimits: { images: { exact: 1 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'fal-flux-2-multiple-angles-source',
+            require: { images: { exact: 1 } },
+            message: {
+                title: '需要单张源图',
+                message: 'FLUX 2 多角度首版必须且只能提供 1 张源图。',
+                type: 'error',
+            },
+        }],
+    params: [
+        { id: 'image', type: 'image-upload', order: 1, required: true, valueType: 'array', default: [], maxCount: 1 },
+        { id: 'horizontalAngle', type: 'number', order: 2, default: 0, min: 0, max: 360, step: 1 },
+        { id: 'verticalAngle', type: 'number', order: 3, default: 0, min: 0, max: 60, step: 1 },
+        { id: 'zoom', type: 'number', order: 4, default: 5, min: 0, max: 10, step: 0.5 },
+    ],
+    runtimeConstraints: {
+        mediaFields: [{ field: 'image_urls', kind: 'image' }],
+        numberFields: [
+            { field: 'horizontal_angle', min: 0, max: 360, fallback: 0 },
+            { field: 'vertical_angle', min: 0, max: 60, fallback: 0 },
+            { field: 'zoom', min: 0, max: 10, fallback: 5 },
+        ],
+    },
+    endpoints: 'fal-ai/flux-2-lora-gallery/multiple-angles',
+    request: {
+        builder: (params) => {
+            const image = requireSingleMultiAngleImage(params, 'FLUX 2 多角度首版');
+            const ratio = typeof params.__firstImageRatio === 'number'
+                && Number.isFinite(params.__firstImageRatio)
+                && params.__firstImageRatio > 0
+                ? params.__firstImageRatio
+                : 1;
+            return {
+                image_urls: [image],
+                horizontal_angle: clampNumber(params.horizontalAngle, 0, 360, 0),
+                vertical_angle: clampNumber(params.verticalAngle, 0, 60, 0),
+                zoom: clampNumber(params.zoom, 0, 10, 5),
+                image_size: falOneMegapixelSize(nearestImageRatio(ratio)),
+            };
+        },
+    },
+    pricing: {
+        currency: '$',
+        calculator: () => 0.021,
+        description: '$0.021/处理后百万像素；首版固定约 1MP、1 张输出，估算 $0.021/视角',
+    },
+});
+export default falFlux2MultipleAnglesModel;

package/dist/tool-packs/fal-multi-angle/models/perspective-change.model.d.ts

@@ -0,0 +1,3 @@
+export declare const FAL_PERSPECTIVE_PRESETS: readonly ["front", "left_side", "right_side", "back", "top_down", "bottom_up", "birds_eye", "three_quarter_left", "three_quarter_right"];
+export declare const falPerspectiveChangeModel: import("../../../index.js").ModelRuntimeDefinition;
+export default falPerspectiveChangeModel;

package/dist/tool-packs/fal-multi-angle/models/perspective-change.model.js

@@ -0,0 +1,58 @@
+import { defineModel } from '../../../catalog/defineModel.js';
+import { requireSingleMultiAngleImage } from '../shared.js';
+export const FAL_PERSPECTIVE_PRESETS = [
+    'front',
+    'left_side',
+    'right_side',
+    'back',
+    'top_down',
+    'bottom_up',
+    'birds_eye',
+    'three_quarter_left',
+    'three_quarter_right',
+];
+export const falPerspectiveChangeModel = defineModel({
+    meta: {
+        id: 'fal-perspective-change',
+        canonicalModelId: 'perspective-change',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-edit', 'multi-angle', 'perspective-preset', 'provider-fal'],
+        polling: { interval: 2_000, maxAttempts: 180, expectedAttempts: 30 },
+    },
+    acceptsPrompt: false,
+    inputLimits: { images: { exact: 1 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'fal-perspective-change-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: 'targetPerspective',
+            type: 'dropdown',
+            order: 2,
+            default: 'front',
+            options: FAL_PERSPECTIVE_PRESETS.map((value) => ({ value })),
+        },
+    ],
+    runtimeConstraints: {
+        mediaFields: [{ field: 'image_url', kind: 'image' }],
+        enumFields: [{ field: 'target_perspective', allowed: [...FAL_PERSPECTIVE_PRESETS], fallback: 'front' }],
+    },
+    endpoints: 'fal-ai/image-apps-v2/perspective',
+    request: {
+        builder: (params) => {
+            const image = requireSingleMultiAngleImage(params, '透视变换');
+            const requested = String(params.targetPerspective || 'front');
+            const targetPerspective = FAL_PERSPECTIVE_PRESETS.includes(requested) ? requested : 'front';
+            return {
+                image_url: image,
+                target_perspective: targetPerspective,
+            };
+        },
+    },
+    pricing: { currency: '$', fixed: 0.04, description: '$0.04/张；首版每视角 1 张输出' },
+});
+export default falPerspectiveChangeModel;

package/dist/tool-packs/fal-multi-angle/models/qwen-image-edit-2509-multiple-angles.model.d.ts

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

package/dist/tool-packs/fal-multi-angle/models/qwen-image-edit-2509-multiple-angles.model.js

@@ -0,0 +1,75 @@
+import { defineModel } from '../../../catalog/defineModel.js';
+import { falOneMegapixelSize } from '../../../catalog/fal/imageSizing.js';
+import { requireSingleMultiAngleImage } from '../shared.js';
+const CONTINUOUS_IMAGE_RATIOS = ['1:1', '4:3', '3:4', '16:9', '9:16'];
+function clampNumber(value, min, max, fallback = 0) {
+    const numeric = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(numeric) ? Math.min(max, Math.max(min, numeric)) : fallback;
+}
+function nearestImageRatio(ratio) {
+    return CONTINUOUS_IMAGE_RATIOS.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 falQwenImageEdit2509MultipleAnglesModel = defineModel({
+    meta: {
+        id: 'fal-qwen-image-edit-2509-multiple-angles',
+        canonicalModelId: 'qwen-image-edit-2509-multiple-angles',
+        provider: 'fal',
+        type: 'image',
+        tags: ['image-edit', 'multi-angle', 'camera-control', 'provider-fal'],
+        polling: { interval: 2_000, maxAttempts: 180, expectedAttempts: 30 },
+    },
+    acceptsPrompt: false,
+    inputLimits: { images: { exact: 1 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'fal-qwen-image-edit-2509-multiple-angles-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: 'rotateRightLeft', type: 'number', order: 2, default: 0, min: -90, max: 90, step: 1 },
+        { id: 'verticalAngle', type: 'number', order: 3, default: 0, min: -1, max: 1, step: 0.1 },
+        { id: 'moveForward', type: 'number', order: 4, default: 0, min: 0, max: 10, step: 0.5 },
+        { id: 'wideAngleLens', type: 'switch', order: 5, default: false },
+    ],
+    runtimeConstraints: {
+        mediaFields: [{ field: 'image_urls', kind: 'image' }],
+    },
+    endpoints: 'fal-ai/qwen-image-edit-2509-lora-gallery/multiple-angles',
+    request: {
+        builder: (params) => {
+            const image = requireSingleMultiAngleImage(params, '多角度生成');
+            const ratio = typeof params.__firstImageRatio === 'number'
+                && Number.isFinite(params.__firstImageRatio)
+                && params.__firstImageRatio > 0
+                ? params.__firstImageRatio
+                : 1;
+            return {
+                image_urls: [image],
+                image_size: falOneMegapixelSize(nearestImageRatio(ratio)),
+                rotate_right_left: clampNumber(params.rotateRightLeft, -90, 90),
+                vertical_angle: clampNumber(params.verticalAngle, -1, 1),
+                move_forward: clampNumber(params.moveForward, 0, 10),
+                wide_angle_lens: params.wideAngleLens === true,
+                num_images: 1,
+                guidance_scale: 1,
+                num_inference_steps: 6,
+                acceleration: 'regular',
+                enable_safety_checker: true,
+                lora_scale: 1.25,
+            };
+        },
+    },
+    pricing: {
+        currency: '$',
+        calculator: () => 0.035,
+        description: '$0.035/百万像素；首版每视角固定约 1MP、1 张输出，估算 $0.035/视角',
+    },
+});
+export default falQwenImageEdit2509MultipleAnglesModel;

package/dist/tool-packs/fal-multi-angle/shared.d.ts

@@ -0,0 +1,2 @@
+import type { JsonObject } from '../../types/runtime.js';
+export declare function requireSingleMultiAngleImage(params: JsonObject, label: string): string;

package/dist/tool-packs/fal-multi-angle/shared.js

@@ -0,0 +1,22 @@
+const MULTI_ANGLE_IMAGE_KEYS = [
+    'uploadedFilePaths',
+    'images',
+    'uploadedImages',
+    'image',
+];
+export function requireSingleMultiAngleImage(params, label) {
+    const images = MULTI_ANGLE_IMAGE_KEYS
+        .map((key) => cleanMedia(params[key]))
+        .find((items) => items.length > 0) ?? [];
+    if (images.length !== 1) {
+        throw new Error(`${label}必须且只能提供 1 张源图`);
+    }
+    return images[0];
+}
+function cleanMedia(value) {
+    return Array.isArray(value)
+        ? value
+            .filter((item) => typeof item === 'string' && item.trim().length > 0)
+            .map((item) => item.trim())
+        : [];
+}

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+/** 生成运行时 DTO、JSON 值与 provider 执行契约。 */
+export * from './runtime.js';
+/** catalog 中保留真实 selector/builder 函数的模型运行时契约。 */
+export * from './model.js';

package/dist/types/index.js

@@ -0,0 +1,4 @@
+/** 生成运行时 DTO、JSON 值与 provider 执行契约。 */
+export * from './runtime.js';
+/** catalog 中保留真实 selector/builder 函数的模型运行时契约。 */
+export * from './model.js';