@henjicc/ai-sdk 0.2.8

package/dist/catalog/modelscope/qwen-image-edit-2509.model.js

@@ -0,0 +1,83 @@
+/**
+ * ModelScope Qwen-Image-Edit-2509 模型（运行时契约）
+ */
+import { defineModel } from '../defineModel.js';
+import { buildModelscopeRequest, MODELSCOPE_ASPECT_RATIO_OPTIONS, MODELSCOPE_CREATE_TASK_ENDPOINT } from './utils.js';
+export const modelscopeQwenImageEdit2509Model = defineModel({
+    meta: {
+        id: 'Qwen/Qwen-Image-Edit-2509',
+        canonicalModelId: 'qwen-image-edit-2509',
+        provider: 'modelscope',
+        type: 'image',
+        tags: ['image-to-image', 'supports-image-editing', 'supports-multi-image', 'provider-modelscope'],
+        polling: {
+            interval: 3000,
+            maxAttempts: 120,
+            expectedAttempts: 40
+        }
+    },
+    inputLimits: {
+        images: { min: 1, max: 3 },
+        videos: { max: 0 }
+    },
+    requirements: [
+        {
+            id: 'qwen-image-edit-image',
+            require: { images: { min: 1 } },
+            message: {
+                title: '图片必需',
+                message: '图片编辑需要上传至少1张图片',
+                type: 'warning'
+            }
+        },
+        {
+            id: 'qwen-image-edit-prompt',
+            require: { prompt: true },
+            message: {
+                title: '提示词必需',
+                message: '请输入编辑需求的提示词',
+                type: 'warning'
+            }
+        }
+    ],
+    params: [
+        {
+            id: 'modelscopeImageSize',
+            type: 'dropdown',
+            order: 1,
+            default: 'smart',
+            options: [
+                { value: 'smart' },
+                ...MODELSCOPE_ASPECT_RATIO_OPTIONS
+            ]
+        },
+        {
+            id: 'modelscopeSteps',
+            type: 'number',
+            order: 2,
+            default: 30,
+            min: 1,
+            max: 100,
+            step: 1
+        }
+    ],
+    endpoints: MODELSCOPE_CREATE_TASK_ENDPOINT,
+    request: {
+        builder: (params) => buildModelscopeRequest(params, {
+            modelId: 'Qwen/Qwen-Image-Edit-2509',
+            allowGuidance: false,
+            allowNegativePrompt: false,
+            allowImage: true,
+            baseSize: 1024,
+            sizeBounds: { min: 64, max: 1664 }
+        })
+    },
+    pricing: {
+        currency: '魔粒',
+        calculator: () => 2,
+        // 魔搭 API-Inference 不收钱，扣的是魔粒积分（ultra 档 2 魔粒/次）。
+        // 日常免费额度约 250 魔粒/天（登录 200 + 绑定阿里云 50），过期不累积。
+        description: '2 魔粒/次（ultra 档），魔搭免费额度约 250 魔粒/天'
+    }
+});
+export default modelscopeQwenImageEdit2509Model;

package/dist/catalog/modelscope/qwen-image.model.d.ts

@@ -0,0 +1,5 @@
+/**
+ * ModelScope Qwen-Image 模型（运行时契约）
+ */
+export declare const modelscopeQwenImageModel: import("../../index.js").ModelRuntimeDefinition;
+export default modelscopeQwenImageModel;

package/dist/catalog/modelscope/qwen-image.model.js

@@ -0,0 +1,84 @@
+/**
+ * ModelScope Qwen-Image 模型（运行时契约）
+ */
+import { defineModel } from '../defineModel.js';
+import { buildModelscopeRequest, MODELSCOPE_ASPECT_RATIO_OPTIONS, MODELSCOPE_CREATE_TASK_ENDPOINT } from './utils.js';
+export const modelscopeQwenImageModel = defineModel({
+    meta: {
+        id: 'Qwen/Qwen-Image',
+        canonicalModelId: 'qwen-image',
+        provider: 'modelscope',
+        type: 'image',
+        tags: ['text-to-image', 'provider-modelscope'],
+        polling: {
+            interval: 3000,
+            maxAttempts: 120,
+            expectedAttempts: 40
+        }
+    },
+    inputLimits: {
+        images: { max: 0 },
+        videos: { max: 0 }
+    },
+    params: [
+        {
+            id: 'modelscopeImageSize',
+            type: 'dropdown',
+            order: 1,
+            default: '1:1',
+            options: MODELSCOPE_ASPECT_RATIO_OPTIONS
+        },
+        {
+            id: 'resolutionBaseSize',
+            type: 'number',
+            order: 2,
+            default: 1024,
+            min: 64,
+            max: 1664,
+            step: 8
+        },
+        {
+            id: 'modelscopeSteps',
+            type: 'number',
+            order: 3,
+            default: 30,
+            min: 1,
+            max: 100,
+            step: 1
+        },
+        {
+            id: 'modelscopeGuidance',
+            type: 'number',
+            order: 4,
+            default: 7.5,
+            min: 1.5,
+            max: 20,
+            step: 0.5
+        },
+        {
+            id: 'modelscopeNegativePrompt',
+            type: 'text',
+            order: 5,
+            default: ''
+        }
+    ],
+    endpoints: MODELSCOPE_CREATE_TASK_ENDPOINT,
+    request: {
+        builder: (params) => buildModelscopeRequest(params, {
+            modelId: 'Qwen/Qwen-Image',
+            allowGuidance: true,
+            allowNegativePrompt: true,
+            allowImage: false,
+            baseSize: 1024,
+            sizeBounds: { min: 64, max: 1664 }
+        })
+    },
+    pricing: {
+        currency: '魔粒',
+        calculator: () => 2,
+        // 魔搭 API-Inference 不收钱，扣的是魔粒积分（ultra 档 2 魔粒/次）。
+        // 日常免费额度约 250 魔粒/天（登录 200 + 绑定阿里云 50），过期不累积。
+        description: '2 魔粒/次（ultra 档），魔搭免费额度约 250 魔粒/天'
+    }
+});
+export default modelscopeQwenImageModel;

package/dist/catalog/modelscope/sdxl-14-ckpt.model.d.ts

@@ -0,0 +1,5 @@
+/**
+ * ModelScope SD XL 模型（运行时契约）
+ */
+export declare const modelscopeSdxl14Model: import("../../index.js").ModelRuntimeDefinition;
+export default modelscopeSdxl14Model;

package/dist/catalog/modelscope/sdxl-14-ckpt.model.js

@@ -0,0 +1,84 @@
+/**
+ * ModelScope SD XL 模型（运行时契约）
+ */
+import { defineModel } from '../defineModel.js';
+import { buildModelscopeRequest, MODELSCOPE_ASPECT_RATIO_OPTIONS, MODELSCOPE_CREATE_TASK_ENDPOINT } from './utils.js';
+export const modelscopeSdxl14Model = defineModel({
+    meta: {
+        id: 'MusePublic/14_ckpt_SD_XL',
+        canonicalModelId: 'sdxl-14-checkpoint',
+        provider: 'modelscope',
+        type: 'image',
+        tags: ['text-to-image', 'provider-modelscope'],
+        polling: {
+            interval: 3000,
+            maxAttempts: 120,
+            expectedAttempts: 40
+        }
+    },
+    inputLimits: {
+        images: { max: 0 },
+        videos: { max: 0 }
+    },
+    params: [
+        {
+            id: 'modelscopeImageSize',
+            type: 'dropdown',
+            order: 1,
+            default: '1:1',
+            options: MODELSCOPE_ASPECT_RATIO_OPTIONS
+        },
+        {
+            id: 'resolutionBaseSize',
+            type: 'number',
+            order: 2,
+            default: 1024,
+            min: 64,
+            max: 2048,
+            step: 8
+        },
+        {
+            id: 'modelscopeSteps',
+            type: 'number',
+            order: 3,
+            default: 30,
+            min: 1,
+            max: 100,
+            step: 1
+        },
+        {
+            id: 'modelscopeGuidance',
+            type: 'number',
+            order: 4,
+            default: 7.5,
+            min: 1.5,
+            max: 20,
+            step: 0.5
+        },
+        {
+            id: 'modelscopeNegativePrompt',
+            type: 'text',
+            order: 5,
+            default: ''
+        }
+    ],
+    endpoints: MODELSCOPE_CREATE_TASK_ENDPOINT,
+    request: {
+        builder: (params) => buildModelscopeRequest(params, {
+            modelId: 'MusePublic/14_ckpt_SD_XL',
+            allowGuidance: true,
+            allowNegativePrompt: true,
+            allowImage: false,
+            baseSize: 1024,
+            sizeBounds: { min: 64, max: 2048 }
+        })
+    },
+    pricing: {
+        currency: '魔粒',
+        calculator: () => 1,
+        // 魔搭 API-Inference 不收钱，扣的是魔粒积分（standard 档 1 魔粒/次）。
+        // 日常免费额度约 250 魔粒/天（登录 200 + 绑定阿里云 50），过期不累积。
+        description: '1 魔粒/次（standard 档），魔搭免费额度约 250 魔粒/天'
+    }
+});
+export default modelscopeSdxl14Model;

package/dist/catalog/modelscope/utils.d.ts

@@ -0,0 +1,33 @@
+import type { JsonObject } from '../../types/runtime.js';
+/**
+ * 魔搭 API-Inference 的图像生成提交路由。
+ * 曾误用 KIE 的 `/api/v1/jobs/createTask`（同一次批量改动里复制串了供应商），
+ * 官方文档与每个模型页的示例代码统一都是这一条。
+ */
+export declare const MODELSCOPE_CREATE_TASK_ENDPOINT = "/v1/images/generations";
+export declare const MODELSCOPE_ASPECT_RATIO_OPTIONS: {
+    value: string;
+}[];
+/**
+ * 官方按模型族给出的 `size` 边界，超出会被接口拒绝：
+ * SD 系列 [64, 2048]、FLUX [64, 1024]、Qwen-Image [64, 1664]、Z-Image [512, 2048]。
+ * 不能对所有模型共用一组上下界。
+ */
+export declare const MODELSCOPE_DEFAULT_SIZE_BOUNDS: {
+    readonly min: 64;
+    readonly max: 2048;
+};
+export interface ModelscopeSizeBounds {
+    min: number;
+    max: number;
+}
+export declare function resolveModelscopeSize(modelId: string, imageSize?: string, baseSize?: number, bounds?: ModelscopeSizeBounds): string | undefined;
+/** ModelScope 请求构建的唯一实现，catalog builder 与主进程直接调用本函数。 */
+export declare function buildModelscopeRequest(params: JsonObject, options: {
+    modelId: string;
+    allowGuidance?: boolean;
+    allowNegativePrompt?: boolean;
+    allowImage?: boolean;
+    baseSize?: number;
+    sizeBounds?: ModelscopeSizeBounds;
+}): JsonObject;

package/dist/catalog/modelscope/utils.js

@@ -0,0 +1,174 @@
+/**
+ * 魔搭 API-Inference 的图像生成提交路由。
+ * 曾误用 KIE 的 `/api/v1/jobs/createTask`（同一次批量改动里复制串了供应商），
+ * 官方文档与每个模型页的示例代码统一都是这一条。
+ */
+export const MODELSCOPE_CREATE_TASK_ENDPOINT = '/v1/images/generations';
+export const MODELSCOPE_ASPECT_RATIO_OPTIONS = [
+    { value: '21:9' },
+    { value: '16:9' },
+    { value: '3:2' },
+    { value: '4:3' },
+    { value: '1:1' },
+    { value: '3:4' },
+    { value: '2:3' },
+    { value: '9:16' },
+    { value: '9:21' }
+];
+const DEFAULT_BASE_SIZE = 1024;
+const BASE_SIZE_STEP = 8;
+/**
+ * 官方按模型族给出的 `size` 边界，超出会被接口拒绝：
+ * SD 系列 [64, 2048]、FLUX [64, 1024]、Qwen-Image [64, 1664]、Z-Image [512, 2048]。
+ * 不能对所有模型共用一组上下界。
+ */
+export const MODELSCOPE_DEFAULT_SIZE_BOUNDS = { min: 64, max: 2048 };
+/**
+ * Qwen-Image-Edit-2509 专用分辨率计算（不使用基数系统，每个比例自动计算 [64, 2048] 范围内的最佳值）。
+ * 原实现在应用侧 `src/utils/qwenResolutionCalculator.ts`，这里内联一份纯函数副本——
+ * 该文件同时被 UI 组件 `UniversalResolutionSelector.tsx` 消费，SDK 不能反向依赖 `@/utils`，
+ * 只搬运 `resolveModelscopeSize` 实际用到的这一个函数（不含 logger 的批量/展示层变体）。
+ */
+function calculateQwenResolution(widthRatio, heightRatio) {
+    const MIN_SIZE = 64;
+    const MAX_SIZE = 2048;
+    const STEP = 8;
+    if (widthRatio === heightRatio) {
+        return { width: MAX_SIZE, height: MAX_SIZE };
+    }
+    const ratio = widthRatio / heightRatio;
+    let width;
+    let height;
+    if (ratio > 1) {
+        width = MAX_SIZE;
+        height = width / ratio;
+        if (height < MIN_SIZE) {
+            height = MIN_SIZE;
+            width = height * ratio;
+        }
+    }
+    else {
+        height = MAX_SIZE;
+        width = height * ratio;
+        if (width < MIN_SIZE) {
+            width = MIN_SIZE;
+            height = width / ratio;
+        }
+    }
+    const finalWidth = Math.floor(width / STEP) * STEP;
+    const finalHeight = Math.floor(height / STEP) * STEP;
+    return {
+        width: Math.max(MIN_SIZE, Math.min(MAX_SIZE, finalWidth)),
+        height: Math.max(MIN_SIZE, Math.min(MAX_SIZE, finalHeight))
+    };
+}
+/** 原实现在应用侧 `src/utils/resolutionCalculator.ts`，同理只搬运用到的两个函数。 */
+function calculateResolution(baseSize, widthRatio, heightRatio) {
+    if (widthRatio === heightRatio) {
+        return { width: baseSize, height: baseSize };
+    }
+    const maxPixels = baseSize * baseSize;
+    const ratio = widthRatio / heightRatio;
+    const height = Math.sqrt(maxPixels / ratio);
+    const width = height * ratio;
+    const finalWidth = Math.floor(width / 8) * 8;
+    const finalHeight = Math.floor(height / 8) * 8;
+    return { width: finalWidth, height: finalHeight };
+}
+function normalizeBaseSize(baseSize, min = 512, max = 2048, step = 8) {
+    let normalized = Math.max(min, Math.min(max, baseSize));
+    normalized = Math.round(normalized / step) * step;
+    return normalized;
+}
+function calculateResolutionWithBounds(baseSize, widthRatio, heightRatio, minSize = 64, maxSize = 2048) {
+    let { width, height } = calculateResolution(baseSize, widthRatio, heightRatio);
+    const maxDimension = Math.max(width, height);
+    const minDimension = Math.min(width, height);
+    if (maxDimension > maxSize) {
+        const scale = maxSize / maxDimension;
+        width = Math.floor((width * scale) / 16) * 16;
+        height = Math.floor((height * scale) / 16) * 16;
+    }
+    if (minDimension < minSize) {
+        const scale = minSize / minDimension;
+        width = Math.floor((width * scale) / 16) * 16;
+        height = Math.floor((height * scale) / 16) * 16;
+    }
+    width = Math.max(minSize, Math.min(maxSize, width));
+    height = Math.max(minSize, Math.min(maxSize, height));
+    width = Math.floor(width / 16) * 16;
+    height = Math.floor(height / 16) * 16;
+    return { width, height };
+}
+export function resolveModelscopeSize(modelId, imageSize, baseSize, bounds = MODELSCOPE_DEFAULT_SIZE_BOUNDS) {
+    if (!imageSize)
+        return undefined;
+    if (imageSize.includes('x')) {
+        return imageSize;
+    }
+    const ratio = imageSize === 'smart' || imageSize === 'auto' || imageSize === '自定义'
+        ? '1:1'
+        : imageSize;
+    if (!ratio.includes(':'))
+        return undefined;
+    const [w, h] = ratio.split(':').map(Number);
+    if (!w || !h)
+        return undefined;
+    if (modelId === 'Qwen/Qwen-Image-Edit-2509') {
+        const size = calculateQwenResolution(w, h);
+        return `${size.width}x${size.height}`;
+    }
+    const normalizedBase = normalizeBaseSize(Number(baseSize || DEFAULT_BASE_SIZE), bounds.min, bounds.max, BASE_SIZE_STEP);
+    const size = calculateResolutionWithBounds(normalizedBase, w, h, bounds.min, bounds.max);
+    return `${size.width}x${size.height}`;
+}
+/** ModelScope 请求构建的唯一实现，catalog builder 与主进程直接调用本函数。 */
+export function buildModelscopeRequest(params, options) {
+    const prompt = typeof params.prompt === 'string' ? params.prompt : '';
+    const request = {
+        model: options.modelId,
+        prompt
+    };
+    const sizeParam = typeof params.size === 'string' ? params.size : undefined;
+    const imageSizeParam = typeof params.modelscopeImageSize === 'string'
+        ? params.modelscopeImageSize
+        : (typeof params.image_size === 'string'
+            ? params.image_size
+            : (typeof params.aspect_ratio === 'string' ? params.aspect_ratio : undefined));
+    const baseSizeParam = typeof params.resolutionBaseSize === 'number'
+        ? params.resolutionBaseSize
+        : (typeof options.baseSize === 'number' ? options.baseSize : undefined);
+    const sizeValue = sizeParam ||
+        resolveModelscopeSize(options.modelId, imageSizeParam, baseSizeParam, options.sizeBounds ?? MODELSCOPE_DEFAULT_SIZE_BOUNDS);
+    if (sizeValue) {
+        request.size = sizeValue;
+    }
+    const steps = (params.modelscopeSteps ?? params.steps);
+    if (steps !== undefined) {
+        request.steps = steps;
+    }
+    if (options.allowNegativePrompt !== false && typeof params.modelscopeNegativePrompt === 'string') {
+        request.negative_prompt = params.modelscopeNegativePrompt;
+    }
+    const guidance = params.modelscopeGuidance;
+    if (options.allowGuidance !== false && guidance !== undefined) {
+        request.guidance = guidance;
+    }
+    const seed = params.seed;
+    if (seed !== undefined) {
+        request.seed = seed;
+    }
+    if (options.allowImage) {
+        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
+            : (Array.isArray(params.image_url) ? params.image_url : filterSources(params.images));
+        if (images.length > 0) {
+            request.image_url = images;
+        }
+    }
+    return request;
+}

package/dist/catalog/modelscope/z-image-turbo.model.d.ts

@@ -0,0 +1,5 @@
+/**
+ * ModelScope Z-Image-Turbo 模型（运行时契约）
+ */
+export declare const modelscopeZImageTurboModel: import("../../index.js").ModelRuntimeDefinition;
+export default modelscopeZImageTurboModel;

package/dist/catalog/modelscope/z-image-turbo.model.js

@@ -0,0 +1,75 @@
+/**
+ * ModelScope Z-Image-Turbo 模型（运行时契约）
+ */
+import { defineModel } from '../defineModel.js';
+import { buildModelscopeRequest, MODELSCOPE_ASPECT_RATIO_OPTIONS, MODELSCOPE_CREATE_TASK_ENDPOINT } from './utils.js';
+export const modelscopeZImageTurboModel = defineModel({
+    meta: {
+        id: 'Tongyi-MAI/Z-Image-Turbo',
+        canonicalModelId: 'z-image-turbo',
+        provider: 'modelscope',
+        type: 'image',
+        tags: ['text-to-image', 'provider-modelscope'],
+        polling: {
+            interval: 3000,
+            maxAttempts: 120,
+            expectedAttempts: 40
+        }
+    },
+    inputLimits: {
+        images: { max: 0 },
+        videos: { max: 0 }
+    },
+    params: [
+        {
+            id: 'modelscopeImageSize',
+            type: 'dropdown',
+            order: 1,
+            default: '1:1',
+            options: MODELSCOPE_ASPECT_RATIO_OPTIONS
+        },
+        {
+            id: 'resolutionBaseSize',
+            type: 'number',
+            order: 2,
+            default: 1440,
+            min: 512,
+            max: 2048,
+            step: 8
+        },
+        {
+            id: 'modelscopeSteps',
+            type: 'number',
+            order: 3,
+            default: 10,
+            min: 1,
+            max: 100,
+            step: 1
+        },
+        {
+            id: 'modelscopeNegativePrompt',
+            type: 'text',
+            order: 4,
+            default: ''
+        }
+    ],
+    endpoints: MODELSCOPE_CREATE_TASK_ENDPOINT,
+    request: {
+        builder: (params) => buildModelscopeRequest(params, {
+            modelId: 'Tongyi-MAI/Z-Image-Turbo',
+            allowGuidance: false,
+            allowNegativePrompt: true,
+            allowImage: false,
+            baseSize: 1440,
+            sizeBounds: { min: 512, max: 2048 }
+        })
+    },
+    pricing: {
+        currency: '魔粒',
+        calculator: () => 1,
+        // 魔搭 API-Inference 不收钱，扣的是魔粒积分（standard 档 1 魔粒/次）。
+        // 日常免费额度约 250 魔粒/天（登录 200 + 绑定阿里云 50），过期不累积。
+        description: '1 魔粒/次（standard 档），魔搭免费额度约 250 魔粒/天'
+    }
+});
+export default modelscopeZImageTurboModel;

package/dist/catalog/ppio/kling-3.0.model.d.ts

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