@henjicc/ai-sdk 0.8.0 → 0.10.0

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

@@ -5,7 +5,7 @@ export const apimartZImageTurboModel = defineModel({
     meta: {
         id: 'apimart-z-image-turbo', canonicalModelId: 'z-image-turbo', seriesId: 'z-image', seriesRank: 1,
         provider: 'apimart', type: 'image',
-        tags: ['text-to-image', 'supports-2k', 'provider-apimart'], aliases: ['z-image-turbo-apimart'],
+        tags: ['text-to-image'], aliases: ['z-image-turbo-apimart'],
         polling: { interval: 3000, maxAttempts: 200, expectedAttempts: 40 }
     },
     inputLimits: { images: { max: 0 }, videos: { max: 0 } },

package/dist/catalog/audio/tts-common.d.ts

@@ -1,5 +1,6 @@
 import type { JsonObject, JsonValue } from '../../types/runtime.js';
-export declare function speechText(params: JsonObject): string;
+/** maxChars 是供应商单次请求的文本上限，按 Unicode 字符计；超过时在发请求前拒绝。 */
+export declare function speechText(params: JsonObject, maxChars?: number): string;
 export declare function speechString(value: JsonValue): string | undefined;
 export declare function speechNumber(value: JsonValue): number | undefined;
 export declare function speechCharacterPrice(params: JsonObject, perThousand: number): number;

package/dist/catalog/audio/tts-common.js

@@ -1,8 +1,12 @@
-export function speechText(params) {
+/** maxChars 是供应商单次请求的文本上限，按 Unicode 字符计；超过时在发请求前拒绝。 */
+export function speechText(params, maxChars) {
     const value = typeof params.text === 'string' ? params.text : params.prompt;
     if (typeof value !== 'string' || value.trim().length === 0) {
         throw new Error('语音合成需要非空文本');
     }
+    if (maxChars !== undefined && [...value].length > maxChars) {
+        throw new Error(`语音合成单次最多 ${maxChars} 字，请分段生成`);
+    }
     return value;
 }
 export function speechString(value) {

package/dist/catalog/bailian/cosyvoice-v3.5.model.js

@@ -3,7 +3,7 @@ import { speechCharacterPrice, speechNumber, speechString, speechText } from '..
 export const bailianCosyVoice35Model = defineModel({
     meta: {
         id: 'bailian-cosyvoice-v3.5', canonicalModelId: 'cosyvoice-v3.5', provider: 'bailian', type: 'audio',
-        tags: ['text-to-audio', 'provider-bailian'],
+        tags: ['text-to-audio'],
     },
     inputLimits: { images: { max: 0 }, videos: { max: 0 } },
     params: [

package/dist/catalog/bailian/minimax-h3.model.d.ts

@@ -0,0 +1,3 @@
+/** 阿里云百炼托管的 MiniMax H3 视频生成（运行时契约）：https://help.aliyun.com/zh/model-studio/minimax-video-generation-api-reference */
+export declare const bailianMiniMaxH3Model: import("../../index.js").ModelRuntimeDefinition;
+export default bailianMiniMaxH3Model;

package/dist/catalog/bailian/minimax-h3.model.js

@@ -0,0 +1,95 @@
+/** 阿里云百炼托管的 MiniMax H3 视频生成（运行时契约）：https://help.aliyun.com/zh/model-studio/minimax-video-generation-api-reference */
+import { defineModel } from '../defineModel.js';
+import { countUploadedImages, hasUploadedImage, resolveUploadedAudioSources, resolveUploadedImageSources, resolveUploadedVideoDurationSeconds, resolveUploadedVideoSources, } from '../shared/mediaPresence.js';
+const RATIOS = ['21:9', '16:9', '4:3', '1:1', '3:4', '9:16'];
+// 北京地域刊例价（元/秒），输入参考视频按生成分辨率同价计费：https://help.aliyun.com/zh/model-studio/minimax-h3
+const RATES = { '768P': 0.5, '2K': 0.8 };
+function resolution(params) {
+    return params.bailianMiniMaxH3Resolution === '768P' ? '768P' : '2K';
+}
+function duration(params) {
+    return Math.min(15, Math.max(4, Math.round(Number(params.bailianMiniMaxH3Duration || 6))));
+}
+const isReference = (params) => params.bailianMiniMaxH3Mode === 'reference-to-video';
+export const bailianMiniMaxH3Model = defineModel({
+    meta: {
+        id: 'bailian-minimax-h3', canonicalModelId: 'minimax-h3', seriesId: 'hailuo', seriesRank: 3,
+        provider: 'bailian', type: 'video',
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode'],
+        polling: { interval: 15000, maxAttempts: 120, expectedAttempts: 12 },
+    },
+    // 参考视频、参考音频各最多 3 段（单段 2–15 秒、合计 ≤ 15 秒），本地文件经百炼临时存储上传成 oss:// 地址。
+    inputLimits: {
+        images: { max: 2 }, videos: { max: 0 }, audios: { max: 0 },
+        rules: [
+            { when: 'bailianMiniMaxH3Mode === "reference-to-video"', images: { max: 9 }, videos: { max: 3 }, audios: { max: 3 } },
+            {
+                imageConstraints: { minShortSidePx: 256, maxLongSidePx: 5760, minAspectRatio: 0.4, maxAspectRatio: 2.5 },
+                videoConstraints: { minShortSidePx: 256, maxLongSidePx: 5760, minAspectRatio: 0.4, maxAspectRatio: 2.5 },
+            },
+        ],
+    },
+    params: [
+        { id: 'bailianMiniMaxH3Mode', type: 'dropdown', order: 1, default: 'text-image-to-video', options: [{ value: 'text-image-to-video' }, { value: 'reference-to-video' }] },
+        {
+            id: 'bailianMiniMaxH3AspectRatio', type: 'dropdown', order: 2, default: 'smart',
+            // 图生视频的比例由输入图片决定，官方忽略所传比例。
+            visible: { condition: (params) => isReference(params) || !hasUploadedImage(params) },
+            options: [{ value: 'smart' }, ...RATIOS.map(value => ({ value }))],
+        },
+        { id: 'bailianMiniMaxH3Resolution', type: 'dropdown', order: 3, default: '2K', options: [{ value: '768P' }, { value: '2K' }] },
+        { id: 'bailianMiniMaxH3Duration', type: 'number', order: 4, default: 6, min: 4, max: 15, step: 1 },
+    ],
+    endpoints: '/api/v1/services/aigc/video-generation/video-synthesis',
+    request: {
+        builder: (params) => {
+            const prompt = typeof params.prompt === 'string' ? params.prompt.trim().slice(0, 7000) : '';
+            if (!prompt)
+                throw new Error('MiniMax H3 的提示词不能为空');
+            const images = resolveUploadedImageSources(params);
+            const rawRatio = String(params.bailianMiniMaxH3AspectRatio || 'smart');
+            const ratio = RATIOS.includes(rawRatio) ? rawRatio : undefined;
+            const parameters = { resolution: resolution(params), duration: duration(params), watermark: false };
+            let media = [];
+            if (isReference(params)) {
+                const videos = resolveUploadedVideoSources(params);
+                const audios = resolveUploadedAudioSources(params);
+                // 参考音频不能单独使用是 MiniMax 上游限制（APIMart 文档写明），百炼文档只列了组合方式。
+                if (images.length + videos.length === 0)
+                    throw new Error('MiniMax H3 参考生视频至少需要一张参考图或一段参考视频');
+                media = [
+                    ...images.slice(0, 9).map(url => ({ type: 'image_url', url })),
+                    ...videos.slice(0, 3).map(url => ({ type: 'feature', url })),
+                    ...audios.slice(0, 3).map(url => ({ type: 'driving_audio', url })),
+                ];
+                parameters.ratio = ratio ?? 'adaptive';
+            }
+            else if (images.length > 0) {
+                if (images.length > 2)
+                    throw new Error('MiniMax H3 首尾帧最多 2 张图片');
+                media = images.map((url, index) => ({ type: index === 0 ? 'first_frame' : 'last_frame', url }));
+            }
+            else {
+                // 文生视频必须指定具体比例，不接受 adaptive。
+                parameters.ratio = ratio ?? '16:9';
+            }
+            const input = { prompt };
+            if (media.length > 0)
+                input.media = media;
+            return { model: 'MiniMax/MiniMax-H3', input, parameters };
+        },
+    },
+    pricing: {
+        currency: '¥',
+        calculator: (params) => {
+            const rate = RATES[resolution(params)];
+            const inputSeconds = isReference(params) && resolveUploadedVideoSources(params).length > 0
+                ? Math.min(15, resolveUploadedVideoDurationSeconds(params, 15))
+                : 0;
+            const extraImages = isReference(params) ? Math.max(0, countUploadedImages(params) - 5) : 0;
+            return rate * (duration(params) + inputSeconds) + extraImages * 0.2;
+        },
+        description: '768P 每秒 ¥0.5，2K 每秒 ¥0.8；参考视频时长按生成分辨率同价计入；参考图 5 张以内免费，超出每张 ¥0.2；音频免费',
+    },
+});
+export default bailianMiniMaxH3Model;

package/dist/catalog/bailian/minimax-speech-2.8.model.js

@@ -3,7 +3,7 @@ import { speechCharacterPrice, speechNumber, speechString, speechText } from '..
 export const bailianMinimaxSpeech28Model = defineModel({
     meta: {
         id: 'bailian-minimax-speech-2.8', canonicalModelId: 'minimax-speech-2.8', provider: 'bailian', type: 'audio',
-        tags: ['text-to-audio', 'provider-bailian'],
+        tags: ['text-to-audio'],
     },
     inputLimits: { images: { max: 0 }, videos: { max: 0 } },
     params: [

package/dist/catalog/bailian/qwen-audio-3.1-tts-flash.model.js

@@ -4,7 +4,7 @@ export const bailianQwenAudio31TtsFlashModel = defineModel({
     meta: {
         id: 'bailian-qwen-audio-3.1-tts-flash', canonicalModelId: 'qwen-audio-3.1-tts-flash',
         provider: 'bailian', type: 'audio',
-        tags: ['text-to-audio', 'provider-bailian'],
+        tags: ['text-to-audio'],
     },
     inputLimits: { images: { max: 0 }, videos: { max: 0 } },
     params: [
@@ -28,8 +28,19 @@ export const bailianQwenAudio31TtsFlashModel = defineModel({
         },
     },
     pricing: {
-        currency: '¥', calculator: () => Number.NaN,
-        description: '输入 ¥1.5/百万 Token、输出 ¥12/百万 Token；输出 Token 无法在提交前准确估算',
+        estimateKind: 'upper-bound',
+        currency: '¥', calculator: params => {
+            const text = typeof params.text === 'string' ? params.text : typeof params.prompt === 'string' ? params.prompt : '';
+            const instruction = speechString(params.bailianQwenTtsInstruction) ?? '';
+            const speed = Math.min(2, Math.max(0.5, speechNumber(params.bailianQwenTtsSpeed) ?? 1));
+            // 公开文档/模型卡片未提供输入上限或音频 Token/秒。按当前输入全文作预算，
+            // 采用慢速 1 字/秒、每音频秒 100 Token 的保守工程假设，不冒充官方折算。
+            const characters = Array.from(text).length;
+            const inputTokens = new TextEncoder().encode(text + instruction).length;
+            const outputTokens = Math.ceil(characters / speed) * 100;
+            return (inputTokens * 1.5 + outputTokens * 12) / 1_000_000;
+        },
+        description: '估算上限（非账单保证）：输入 ¥1.5/百万 Token、输出 ¥12/百万 Token。官方未公布文本上限及音频折算；按当前全文、慢速每秒1字÷语速、每秒100音频Token及UTF-8字节作为输入Token预算。实际按供应商用量结算。',
     },
 });
 export default bailianQwenAudio31TtsFlashModel;

package/dist/catalog/bailian/qwen-audio-3.1-tts-plus.model.d.ts

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

package/dist/catalog/bailian/qwen-audio-3.1-tts-plus.model.js

@@ -0,0 +1,44 @@
+import { defineModel } from '../defineModel.js';
+import { speechNumber, speechString, speechText } from '../audio/tts-common.js';
+/** 百炼计费字符：汉字（含繁体、日文汉字、韩文汉字）记 2 个，其余字符记 1 个。 */
+function billingCharacters(text) {
+    return Array.from(text).reduce((sum, char) => sum + (/\p{Script=Han}/u.test(char) ? 2 : 1), 0);
+}
+export const bailianQwenAudio31TtsPlusModel = defineModel({
+    meta: {
+        id: 'bailian-qwen-audio-3.1-tts-plus', canonicalModelId: 'qwen-audio-3.1-tts-plus',
+        provider: 'bailian', type: 'audio',
+        tags: ['text-to-audio'],
+    },
+    inputLimits: { images: { max: 0 }, videos: { max: 0 } },
+    params: [
+        { id: 'bailianQwenTtsPlusVoice', type: 'composite', valueType: 'string', order: 1, default: 'longanlingxin_v3.1' },
+        { id: 'bailianQwenTtsPlusInstruction', type: 'text', order: 2, default: '' },
+        { id: 'bailianQwenTtsPlusSpeed', type: 'number', order: 3, default: 1, min: 0.5, max: 2, step: 0.1 },
+    ],
+    endpoints: '/api/v1/services/audio/tts/SpeechSynthesizer',
+    request: {
+        builder: (params) => {
+            const input = {
+                text: speechText(params),
+                voice: speechString(params.bailianQwenTtsPlusVoice) ?? 'longanlingxin_v3.1',
+                format: 'mp3',
+                rate: speechNumber(params.bailianQwenTtsPlusSpeed) ?? 1,
+            };
+            const instruction = speechString(params.bailianQwenTtsPlusInstruction);
+            if (instruction)
+                input.instruction = instruction;
+            return { model: 'qwen-audio-3.1-tts-plus', input };
+        },
+    },
+    pricing: {
+        currency: '¥',
+        // 北京地域 ¥1.4/万字符，只按待合成文本计费：https://help.aliyun.com/zh/model-studio/model-pricing
+        calculator: params => {
+            const text = typeof params.text === 'string' ? params.text : typeof params.prompt === 'string' ? params.prompt : '';
+            return billingCharacters(text) * 1.4 / 10_000;
+        },
+        description: '¥1.4/万字符（汉字记 2 个字符，其余记 1 个）；只按待合成文本计费',
+    },
+});
+export default bailianQwenAudio31TtsPlusModel;

package/dist/catalog/bailian/qwen-image-3.0.model.js

@@ -6,7 +6,7 @@ export const bailianQwenImage30Model = defineModel({
     meta: {
         id: 'bailian-qwen-image-3.0', canonicalModelId: 'qwen-image-3.0', seriesId: 'qwen-image', seriesRank: 3,
         provider: 'bailian', type: 'image',
-        tags: ['text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'max-images-3', 'multi-output', 'provider-bailian'],
+        tags: ['text-to-image', 'image-to-image'],
         aliases: ['qwen-image-3-official']
     },
     inputLimits: { images: { max: 3 }, videos: { max: 0 } },

package/dist/catalog/bailian/wan-3.0.model.d.ts

@@ -0,0 +1,3 @@
+/** 阿里云百炼官方万相 3.0 视频生成（标准版 / Prime 版，运行时契约） */
+export declare const bailianWan30Model: import("../../index.js").ModelRuntimeDefinition;
+export default bailianWan30Model;

package/dist/catalog/bailian/wan-3.0.model.js

@@ -0,0 +1,104 @@
+/** 阿里云百炼官方万相 3.0 视频生成（标准版 / Prime 版，运行时契约） */
+import { defineModel } from '../defineModel.js';
+import { resolveUploadedImageSources, resolveUploadedVideoDurationSeconds, resolveUploadedVideoSources } from '../shared/mediaPresence.js';
+const RATIOS = ['16:9', '4:3', '1:1', '3:4', '9:16', '21:9'];
+const RESOLUTIONS = ['480P', '720P', '1080P'];
+// 北京地域刊例价（元/秒），输入与输出视频同价：https://help.aliyun.com/zh/model-studio/model-pricing
+// 标准版当前限时 7 折，按原价预估，避免折扣结束后低估费用。
+const RATES = {
+    standard: { '480P': 0.3, '720P': 0.6, '1080P': 1.2 },
+    prime: { '480P': 0.45, '720P': 0.9, '1080P': 1.8 },
+};
+function audioSources(params) {
+    const pick = (value) => Array.isArray(value)
+        ? value.filter((item) => typeof item === 'string' && item.trim().length > 0) : [];
+    const uploaded = pick(params.uploadedAudioFilePaths);
+    return uploaded.length > 0 ? uploaded : pick(params.audios);
+}
+function duration(params) {
+    return Math.min(30, Math.max(2, Math.round(Number(params.bailianWan30Duration || 5))));
+}
+/** 有参考视频时官方要求输入总时长 + 输出时长 ≤ 30 秒；读得到素材时长就把输出时长收进这个范围。 */
+function outputDuration(params) {
+    if (params.bailianWan30Mode !== 'reference-to-video' || resolveUploadedVideoSources(params).length === 0)
+        return duration(params);
+    return Math.max(2, Math.min(duration(params), 30 - Math.ceil(resolveUploadedVideoDurationSeconds(params))));
+}
+function resolution(params) {
+    return RESOLUTIONS.includes(String(params.bailianWan30Resolution)) ? String(params.bailianWan30Resolution) : '720P';
+}
+export const bailianWan30Model = defineModel({
+    meta: {
+        id: 'bailian-wan-3.0', canonicalModelId: 'wan-3.0', seriesId: 'wan', seriesRank: 3,
+        provider: 'bailian', type: 'video',
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode'],
+        polling: { interval: 15000, maxAttempts: 120, expectedAttempts: 16 },
+    },
+    // 参考视频、参考音频各最多 5 段（单段 1–15 秒、合计 ≤ 15 秒），本地文件经百炼临时存储上传成 oss:// 地址。
+    inputLimits: {
+        images: { max: 2 }, videos: { max: 0 }, audios: { max: 0 },
+        rules: [
+            { when: 'bailianWan30Mode === "reference-to-video"', images: { max: 10 }, videos: { max: 5 }, audios: { max: 5 } },
+            { imageConstraints: { minShortSidePx: 240, maxLongSidePx: 8000, minAspectRatio: 1 / 8, maxAspectRatio: 8 } },
+        ],
+    },
+    params: [
+        { id: 'bailianWan30Variant', type: 'dropdown', order: 1, default: 'standard', options: [{ value: 'standard' }, { value: 'prime' }] },
+        { id: 'bailianWan30Mode', type: 'dropdown', order: 2, default: 'text-image-to-video', options: [{ value: 'text-image-to-video' }, { value: 'reference-to-video' }] },
+        { id: 'bailianWan30AspectRatio', type: 'dropdown', order: 3, default: 'smart', options: [{ value: 'smart' }, ...RATIOS.map(value => ({ value }))] },
+        { id: 'bailianWan30Resolution', type: 'dropdown', order: 4, default: '720P', options: RESOLUTIONS.map(value => ({ value })) },
+        { id: 'bailianWan30Duration', type: 'number', order: 5, default: 5, min: 2, max: 30, step: 1 },
+        { id: 'bailianWan30Audio', type: 'switch', order: 6, default: true },
+    ],
+    endpoints: '/api/v1/services/aigc/video-generation/video-synthesis',
+    request: {
+        builder: (params) => {
+            const images = resolveUploadedImageSources(params);
+            const reference = params.bailianWan30Mode === 'reference-to-video';
+            const prompt = typeof params.prompt === 'string' ? params.prompt.slice(0, 20000) : '';
+            const rawRatio = String(params.bailianWan30AspectRatio || 'smart');
+            const media = reference
+                ? [
+                    ...images.slice(0, 10).map(url => ({ type: 'reference_image', url })),
+                    ...resolveUploadedVideoSources(params).slice(0, 5).map(url => ({ type: 'reference_video', url })),
+                    ...audioSources(params).slice(0, 5).map(url => ({ type: 'reference_audio', url })),
+                ]
+                : images.slice(0, 2).map((url, index) => ({ type: index === 0 ? 'first_frame' : 'last_frame', url }));
+            if (!reference && images.length > 2)
+                throw new Error('万相 3.0 首尾帧最多 2 张图片');
+            if (!prompt.trim() && media.length === 0)
+                throw new Error('万相 3.0 需要填写提示词或上传素材');
+            const input = {};
+            if (prompt.trim())
+                input.prompt = prompt;
+            if (media.length > 0)
+                input.media = media;
+            return {
+                model: params.bailianWan30Variant === 'prime' ? 'wan3.0-video-prime' : 'wan3.0-video',
+                input,
+                parameters: {
+                    // 官方默认 1080P（最贵），始终显式发送所选分辨率。
+                    resolution: resolution(params),
+                    // 智能比例交给模型按素材与意图自适应。
+                    ratio: RATIOS.includes(rawRatio) ? rawRatio : 'adaptive',
+                    duration: outputDuration(params),
+                    audio: params.bailianWan30Audio !== false,
+                    watermark: false,
+                },
+            };
+        },
+    },
+    pricing: {
+        currency: '¥',
+        calculator: (params) => {
+            const variant = params.bailianWan30Variant === 'prime' ? 'prime' : 'standard';
+            // 输入视频与输出同价按秒计；读不到参考视频时长时按输出时长估，并封顶到合计 15 秒。
+            const inputSeconds = params.bailianWan30Mode === 'reference-to-video' && resolveUploadedVideoSources(params).length > 0
+                ? Math.min(15, resolveUploadedVideoDurationSeconds(params, duration(params)))
+                : 0;
+            return RATES[variant][resolution(params)] * (outputDuration(params) + inputSeconds);
+        },
+        description: '标准版每秒 480P ¥0.3、720P ¥0.6、1080P ¥1.2（当前限时 7 折，按原价预估）；Prime 每秒 480P ¥0.45、720P ¥0.9、1080P ¥1.8；参考视频的时长与输出同价计入；开关声音同价',
+    },
+});
+export default bailianWan30Model;

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

@@ -5,7 +5,7 @@ export const bailianZImageTurboModel = defineModel({
     meta: {
         id: 'bailian-z-image-turbo', canonicalModelId: 'z-image-turbo', seriesId: 'z-image', seriesRank: 1,
         provider: 'bailian', type: 'image',
-        tags: ['text-to-image', 'provider-bailian'], aliases: ['z-image-turbo-official']
+        tags: ['text-to-image'], aliases: ['z-image-turbo-official']
     },
     inputLimits: { images: { max: 0 }, videos: { max: 0 } },
     params: [

package/dist/catalog/consumer-contract.d.ts

@@ -1,4 +1,4 @@
-import type { ModelRuntimeDefinition, RuntimeMediaFieldConstraint, RuntimeMediaFieldKind, RuntimeParamDef, RuntimeVideoConstraints } from '../types/model.js';
+import type { ModelRuntimeDefinition, RuntimeImageConstraints, RuntimeMediaDimensionConstraints, RuntimeMediaFieldConstraint, RuntimeMediaFieldKind, RuntimeParamDef, RuntimeVideoConstraints } from '../types/model.js';
 import type { JsonObject } from '../types/runtime.js';
 export interface ResolvedRuntimeInputCountLimit {
     min: number;
@@ -8,6 +8,7 @@ export interface ResolvedRuntimeInputLimits {
     images?: ResolvedRuntimeInputCountLimit;
     videos?: ResolvedRuntimeInputCountLimit;
     audios?: ResolvedRuntimeInputCountLimit;
+    imageConstraints?: RuntimeImageConstraints;
     videoConstraints?: RuntimeVideoConstraints;
 }
 export interface RuntimeGenericMediaInput {
@@ -34,6 +35,20 @@ export interface RuntimeMediaInputContract {
  * 未声明的媒体种类保持 undefined；消费方不能自行补成 URL 文本框。
  */
 export declare function resolveRuntimeInputLimits(model: ModelRuntimeDefinition, params: JsonObject, context?: JsonObject): ResolvedRuntimeInputLimits;
+export interface MediaDimensions {
+    width: number;
+    height: number;
+}
+export interface MediaDimensionViolation {
+    rule: keyof RuntimeMediaDimensionConstraints;
+    limit: number;
+    actual: number;
+}
+/**
+ * 按模型声明的尺寸约束检查一份素材，返回第一条不满足的规则；全部满足返回 null。
+ * 宿主在提交前用它拦下注定被供应商拒绝的素材，文案由宿主按 rule 自行组织。
+ */
+export declare function findMediaDimensionViolation(constraints: RuntimeMediaDimensionConstraints | undefined, size: MediaDimensions): MediaDimensionViolation | null;
 /**
  * 返回消费方应渲染的上传控件契约。
  *

package/dist/catalog/consumer-contract.js

@@ -36,11 +36,42 @@ export function resolveRuntimeInputLimits(model, params, context = {}) {
         resolved.images = mergeLimit(resolved.images, rule.images);
         resolved.videos = mergeLimit(resolved.videos, rule.videos);
         resolved.audios = mergeLimit(resolved.audios, rule.audios);
+        if (rule.imageConstraints)
+            resolved.imageConstraints = { ...rule.imageConstraints };
         if (rule.videoConstraints)
             resolved.videoConstraints = { ...rule.videoConstraints };
     }
     return resolved;
 }
+// 宽高比来自整数相除，边界值（如 1080×2700 = 0.4）不能因浮点舍入被误判。
+const ASPECT_RATIO_EPSILON = 1e-6;
+/**
+ * 按模型声明的尺寸约束检查一份素材，返回第一条不满足的规则；全部满足返回 null。
+ * 宿主在提交前用它拦下注定被供应商拒绝的素材，文案由宿主按 rule 自行组织。
+ */
+export function findMediaDimensionViolation(constraints, size) {
+    if (!constraints)
+        return null;
+    const aspectRatio = size.width / size.height;
+    const measured = {
+        minShortSidePx: Math.min(size.width, size.height),
+        maxLongSidePx: Math.max(size.width, size.height),
+        minPixels: size.width * size.height,
+        maxPixels: size.width * size.height,
+        minAspectRatio: aspectRatio,
+        maxAspectRatio: aspectRatio,
+    };
+    for (const rule of Object.keys(measured)) {
+        const limit = constraints[rule];
+        if (limit === undefined)
+            continue;
+        const actual = measured[rule];
+        const tolerance = rule.endsWith('AspectRatio') ? ASPECT_RATIO_EPSILON : 0;
+        if (rule.startsWith('min') ? actual < limit - tolerance : actual > limit + tolerance)
+            return { rule, limit, actual };
+    }
+    return null;
+}
 /**
  * 返回消费方应渲染的上传控件契约。
  *

package/dist/catalog/continuation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 续接生成的公共读写：完成时按模型声明取出续接引用，续接请求时读出 `__continuation`。
+ * 引用是平台内部标识（任务 ID、草稿缓存地址），只在请求构建里使用，不进入界面。
+ */
+import { type ModelRuntimeDefinition, type RuntimeContinuation, type RuntimeContinuationParam } from '../types/model.js';
+import type { JsonObject, JsonValue } from '../types/runtime.js';
+/** 完成结果能做的续接：动作标识 → 平台引用。没有可续接的动作时返回 undefined。 */
+export declare function captureContinuations(model: Pick<ModelRuntimeDefinition, 'continuations'>, params: JsonObject, result: {
+    taskId?: string;
+    metadata: JsonValue;
+}): Record<string, JsonObject> | undefined;
+/** 找到源模型上的某个续接动作。 */
+export declare function findContinuation(model: Pick<ModelRuntimeDefinition, 'continuations'> | undefined, id: string): RuntimeContinuation | undefined;
+/**
+ * 续接请求的完整参数：源参数经动作调整，再带上续接引用。
+ * 源参数里上一次续接的引用不再沿用，避免把多步续接混成一次。
+ */
+export declare function buildContinuationParams(sourceModelId: string, continuation: RuntimeContinuation, source: JsonObject, reference: JsonObject): JsonObject;
+/** 读出请求参数里的续接引用；指定动作时只认这个动作。 */
+export declare function readContinuation(params: JsonObject, id?: string): RuntimeContinuationParam | null;

package/dist/catalog/continuation.js

@@ -0,0 +1,41 @@
+/**
+ * 续接生成的公共读写：完成时按模型声明取出续接引用，续接请求时读出 `__continuation`。
+ * 引用是平台内部标识（任务 ID、草稿缓存地址），只在请求构建里使用，不进入界面。
+ */
+import { CONTINUATION_PARAM } from '../types/model.js';
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** 完成结果能做的续接：动作标识 → 平台引用。没有可续接的动作时返回 undefined。 */
+export function captureContinuations(model, params, result) {
+    const captured = {};
+    for (const continuation of model.continuations ?? []) {
+        if (continuation.available && !continuation.available(params))
+            continue;
+        const reference = continuation.capture(result);
+        if (reference)
+            captured[continuation.id] = reference;
+    }
+    return Object.keys(captured).length > 0 ? captured : undefined;
+}
+/** 找到源模型上的某个续接动作。 */
+export function findContinuation(model, id) {
+    return model?.continuations?.find(continuation => continuation.id === id);
+}
+/**
+ * 续接请求的完整参数：源参数经动作调整，再带上续接引用。
+ * 源参数里上一次续接的引用不再沿用，避免把多步续接混成一次。
+ */
+export function buildContinuationParams(sourceModelId, continuation, source, reference) {
+    const { [CONTINUATION_PARAM]: _previous, ...rest } = source;
+    return { ...continuation.params(rest), [CONTINUATION_PARAM]: { id: continuation.id, sourceModelId, reference } };
+}
+/** 读出请求参数里的续接引用；指定动作时只认这个动作。 */
+export function readContinuation(params, id) {
+    const value = params[CONTINUATION_PARAM];
+    if (!isObject(value) || typeof value.id !== 'string' || typeof value.sourceModelId !== 'string' || !isObject(value.reference))
+        return null;
+    if (id && value.id !== id)
+        return null;
+    return { id: value.id, sourceModelId: value.sourceModelId, reference: value.reference };
+}

package/dist/catalog/fal/bria-creative-upscale.model.js

@@ -6,7 +6,7 @@ export const falBriaCreativeUpscaleModel = defineModel({
         canonicalModelId: 'bria-creative-upscale',
         provider: 'fal',
         type: 'image',
-        tags: ['image-to-image', 'upscaling', 'alpha-preserving', 'provider-fal'],
+        tags: ['upscaling', 'transparent-background'],
         polling: { interval: 3000, maxAttempts: 200, expectedAttempts: 45 },
     },
     acceptsPrompt: false,

package/dist/catalog/fal/eleven-v3-tts.model.js

@@ -3,7 +3,7 @@ import { speechCharacterPrice, speechNumber, speechString, speechText } from '..
 export const falElevenV3TtsModel = defineModel({
     meta: {
         id: 'fal-eleven-v3-tts', canonicalModelId: 'eleven-v3-tts', provider: 'fal', type: 'audio',
-        tags: ['text-to-audio', 'provider-fal'],
+        tags: ['text-to-audio'],
         polling: { interval: 3000, maxAttempts: 120, expectedAttempts: 20 },
     },
     inputLimits: { images: { max: 0 }, videos: { max: 0 } },

package/dist/catalog/fal/eleven-v4-tts.model.d.ts

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

package/dist/catalog/fal/eleven-v4-tts.model.js

@@ -0,0 +1,38 @@
+import { defineModel } from '../defineModel.js';
+import { speechCharacterPrice, speechNumber, speechString, speechText } from '../audio/tts-common.js';
+// 字段与价格来源：docs/model-adaptation/Eleven-v4/Eleven-v4_Fal.md（Fal 模型页与 OpenAPI，2026-11-07 读取）
+const turbo = (params) => params.falElevenV4Version === 'turbo';
+export const falElevenV4TtsModel = defineModel({
+    meta: {
+        id: 'fal-eleven-v4-tts', canonicalModelId: 'eleven-v4-tts', provider: 'fal', type: 'audio',
+        tags: ['text-to-audio'],
+        polling: { interval: 3000, maxAttempts: 120, expectedAttempts: 20 },
+    },
+    inputLimits: { images: { max: 0 }, videos: { max: 0 } },
+    params: [
+        { id: 'falElevenV4Version', type: 'dropdown', order: 1, default: 'standard', options: [{ value: 'standard' }, { value: 'turbo' }] },
+        { id: 'falElevenV4Voice', type: 'composite', valueType: 'string', order: 2, default: 'Rachel' },
+        { id: 'falElevenV4Stability', type: 'number', order: 3, default: 0.5, min: 0, max: 1, step: 0.05 },
+        { id: 'falElevenV4Language', type: 'text', order: 4, default: '' },
+    ],
+    endpoints: { selector: params => turbo(params) ? 'elevenlabs/tts/eleven-v4-turbo' : 'elevenlabs/tts/eleven-v4' },
+    request: {
+        builder: (params) => {
+            const body = {
+                text: speechText(params, 5000),
+                voice: speechString(params.falElevenV4Voice) ?? 'Rachel',
+                stability: speechNumber(params.falElevenV4Stability) ?? 0.5,
+            };
+            const language = speechString(params.falElevenV4Language);
+            if (language)
+                body.language_code = language;
+            return body;
+        },
+    },
+    pricing: {
+        currency: '$',
+        calculator: params => speechCharacterPrice(params, turbo(params) ? 0.04 : 0.08),
+        description: 'v4 $0.08/千字符，v4 Turbo $0.04/千字符',
+    },
+});
+export default falElevenV4TtsModel;

package/dist/catalog/fal/flux-3-video.model.d.ts

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