@henjicc/ai-sdk 0.9.0 → 0.10.0

package/dist/catalog/kie/gemini-3.1-flash-tts.model.js

@@ -3,7 +3,7 @@ import { speechNumber, speechString, speechText } from '../audio/tts-common.js';
 export const kieGemini31FlashTtsModel = defineModel({
     meta: {
         id: 'kie-gemini-3.1-flash-tts', canonicalModelId: 'gemini-3.1-flash-tts', provider: 'kie', type: 'audio',
-        tags: ['text-to-audio', 'provider-kie'],
+        tags: ['text-to-audio'],
         polling: { interval: 3000, maxAttempts: 120, expectedAttempts: 20 },
     },
     inputLimits: { images: { max: 0 }, videos: { max: 0 } },
@@ -17,7 +17,8 @@ export const kieGemini31FlashTtsModel = defineModel({
         builder: (params) => {
             const speakers = Array.isArray(params.kieGeminiTtsSpeakers) && params.kieGeminiTtsSpeakers.length > 0
                 ? params.kieGeminiTtsSpeakers
-                : [{ speaker_id: 'Speaker 1', voice_name: speechString(params.kieGeminiTtsVoice) ?? 'Fenrir' }];
+                // 官方每个说话人必填 accent，没有口音设置时用 Neutral。
+                : [{ speaker_id: 'Speaker 1', voice_name: speechString(params.kieGeminiTtsVoice) ?? 'Fenrir', accent: 'Neutral' }];
             const dialogueTurns = Array.isArray(params.kieGeminiTtsDialogueTurns) && params.kieGeminiTtsDialogueTurns.length > 0
                 ? params.kieGeminiTtsDialogueTurns
                 : [{ speaker_id: 'Speaker 1', text: speechText(params) }];
@@ -33,8 +34,10 @@ export const kieGemini31FlashTtsModel = defineModel({
         },
     },
     pricing: {
-        currency: '$', calculator: () => Number.NaN,
-        description: '输入 $0.7/百万 Token、音频输出 $14/百万 Token；输出 Token 无法在提交前准确估算',
+        currency: '$', billingMode: 'estimated',
+        // 按 Google 同名模型的完整输入/输出 token 窗口预留，避免把语速猜测当硬上限。
+        calculator: () => (8192 * 0.7 + 16384 * 14) / 1_000_000,
+        description: '上限估价 $0.2351：按输入8192、输出16384 Token预留；KIE费率$0.7/$14每百万Token。依据Google同名模型窗口，实际以KIE账单为准。',
     },
 });
 export default kieGemini31FlashTtsModel;

package/dist/catalog/kie/gemini-3.8-flash-lite-tts.model.d.ts

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

package/dist/catalog/kie/gemini-3.8-flash-lite-tts.model.js

@@ -0,0 +1,11 @@
+import { defineModel } from '../defineModel.js';
+import { gemini38TtsDefinition } from './gemini38Tts.js';
+export const kieGemini38FlashLiteTtsModel = defineModel({
+    meta: {
+        id: 'kie-gemini-3.8-flash-lite-tts', canonicalModelId: 'gemini-3.8-flash-lite-tts', provider: 'kie', type: 'audio',
+        tags: ['text-to-audio'],
+        polling: { interval: 3000, maxAttempts: 120, expectedAttempts: 20 },
+    },
+    ...gemini38TtsDefinition('google/gemini-3-8-flash-lite-tts', 8.4, 'Flash-Lite'),
+});
+export default kieGemini38FlashLiteTtsModel;

package/dist/catalog/kie/gemini-3.8-flash-tts.model.d.ts

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

package/dist/catalog/kie/gemini-3.8-flash-tts.model.js

@@ -0,0 +1,11 @@
+import { defineModel } from '../defineModel.js';
+import { gemini38TtsDefinition } from './gemini38Tts.js';
+export const kieGemini38FlashTtsModel = defineModel({
+    meta: {
+        id: 'kie-gemini-3.8-flash-tts', canonicalModelId: 'gemini-3.8-flash-tts', provider: 'kie', type: 'audio',
+        tags: ['text-to-audio'],
+        polling: { interval: 3000, maxAttempts: 120, expectedAttempts: 20 },
+    },
+    ...gemini38TtsDefinition('google/gemini-3-8-flash-tts', 12.6, 'Flash'),
+});
+export default kieGemini38FlashTtsModel;

package/dist/catalog/kie/gemini-omni-video.model.js

@@ -7,7 +7,7 @@ export const kieGeminiOmniVideoModel = defineModel({
         canonicalModelId: 'gemini-omni-video',
         provider: 'kie',
         type: 'video',
-        tags: ['text-to-video', 'image-to-video', 'multi-image-reference', 'video-reference', 'provider-kie'],
+        tags: ['text-to-video', 'image-to-video', 'reference-mode', 'video-to-video'],
         polling: {
             interval: 3000,
             maxAttempts: 180,
@@ -142,9 +142,8 @@ export const kieGeminiOmniVideoModel = defineModel({
                 const clipDuration = Math.min(10, Math.max(1, Math.round(rawClipDuration)));
                 input.video_list = [{ url: videos[0], start: 0, ends: clipDuration }];
             }
-            else {
-                input.duration = String(params.kieGeminiOmniVideoDuration || '8');
-            }
+            // 官方 OpenAPI 把 duration 列为必填；带参考视频时官方忽略它，界面也隐藏，固定发 8。
+            input.duration = videos.length > 0 ? '8' : String(params.kieGeminiOmniVideoDuration || '8');
             return {
                 model: 'gemini-omni-video',
                 input

package/dist/catalog/kie/gemini38Tts.d.ts

@@ -0,0 +1,3 @@
+import type { ModelRuntimeDefinition } from '../../types/model.js';
+/** Gemini 3.8 Flash TTS 与 Flash-Lite TTS 请求结构相同，只有模型 ID 与输出单价不同。 */
+export declare function gemini38TtsDefinition(model: string, outputRate: number, name: string): Omit<ModelRuntimeDefinition, 'meta'>;

package/dist/catalog/kie/gemini38Tts.js

@@ -0,0 +1,40 @@
+import { speechNumber, speechString, speechText } from '../audio/tts-common.js';
+// KIE 按 Google 官方价七折卖；Google 2026 年内半价促销，2027-01-01 起恢复原价。估价直接用原价，促销期内实际扣费更低。
+const INPUT_RATE = 0.7;
+/** Gemini 3.8 Flash TTS 与 Flash-Lite TTS 请求结构相同，只有模型 ID 与输出单价不同。 */
+export function gemini38TtsDefinition(model, outputRate, name) {
+    // 按 Gemini 3.1 Flash TTS 同样的输入 8192 / 输出 16384 Token 窗口预留上限；KIE 输入单价两档相同。
+    const estimate = (8192 * INPUT_RATE + 16384 * outputRate) / 1_000_000;
+    return {
+        inputLimits: { images: { max: 0 }, videos: { max: 0 } },
+        params: [
+            { id: 'kieGemini38TtsVoice', type: 'composite', valueType: 'string', order: 1, default: 'Fola' },
+            { id: 'kieGemini38TtsStyle', type: 'text', order: 2, default: '' },
+            { id: 'kieGemini38TtsTemperature', type: 'number', order: 3, default: 1, min: 0, max: 2, step: 0.1 },
+        ],
+        endpoints: '/api/v1/jobs/createTask',
+        request: {
+            builder: (params) => {
+                const speakers = Array.isArray(params.kieGeminiTtsSpeakers) && params.kieGeminiTtsSpeakers.length > 0
+                    ? params.kieGeminiTtsSpeakers
+                    : [{ speaker_id: 'Speaker 1', voice_name: speechString(params.kieGemini38TtsVoice) ?? 'Fola' }];
+                const style = speechString(params.kieGemini38TtsStyle);
+                const turn = { speaker_id: 'Speaker 1', text: speechText(params, 10000) };
+                if (style)
+                    turn.style = style;
+                const dialogueTurns = Array.isArray(params.kieGeminiTtsDialogueTurns) && params.kieGeminiTtsDialogueTurns.length > 0
+                    ? params.kieGeminiTtsDialogueTurns
+                    : [turn];
+                return {
+                    model,
+                    input: { speakers, dialogue_turns: dialogueTurns, temperature: speechNumber(params.kieGemini38TtsTemperature) ?? 1 },
+                };
+            },
+        },
+        pricing: {
+            currency: '$', billingMode: 'estimated',
+            calculator: () => estimate,
+            description: `上限估价 $${estimate.toFixed(4)}：按输入8192、输出16384 Token预留；KIE ${name} 原价输入$${INPUT_RATE}/输出$${outputRate}每百万Token（2026 年内跟随 Google 促销减半），实际以KIE账单为准。`,
+        },
+    };
+}

package/dist/catalog/kie/gpt-image-2.5.model.js

@@ -5,7 +5,7 @@ export const kieGptImage25Model = defineModel({
     meta: {
         id: 'kie-gpt-image-2.5', canonicalModelId: 'gpt-image-2.5', seriesId: 'gpt-image', seriesRank: 2.5,
         provider: 'kie', type: 'image',
-        tags: ['text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'supports-4k', 'provider-kie'],
+        tags: ['text-to-image', 'image-to-image', 'transparent-background'],
     },
     inputLimits: { images: { max: 16 }, videos: { max: 0 } },
     params: [

package/dist/catalog/kie/gpt-image-2.6.model.d.ts

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

package/dist/catalog/kie/gpt-image-2.6.model.js

@@ -0,0 +1,87 @@
+import { defineModel } from '../defineModel.js';
+import { hasUploadedImage, resolveUploadedImageSources } from '../shared/mediaPresence.js';
+import { GPT25_BACKGROUNDS, GPT25_QUALITIES, GPT25_RATIOS, GPT25_RESOLUTIONS, gpt25Options, gpt25Ratio } from '../shared/gptImage25.js';
+import { GPT25_OUTPUT_REFERENCE } from '../shared/gptImage25Pricing.js';
+const VARIANTS = ['flare', 'sunburst', 'economy'];
+const ECONOMY_RATIOS = ['1:1', '16:9', '9:16', '3:2', '2:3', '21:9', '4:3'];
+const COMPLEXITIES = ['low', 'medium', 'high'];
+function choice(value, values, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== 'string' || !values.includes(value))
+        throw new Error(`GPT Image 2.6 参数不支持：${String(value)}`);
+    return value;
+}
+const variantOf = (params) => choice(params.kieGpt26Variant, VARIANTS, 'flare');
+const isTokenBilled = (params) => variantOf(params) !== 'economy';
+export const kieGptImage26Model = defineModel({
+    meta: {
+        id: 'kie-gpt-image-2.6', canonicalModelId: 'gpt-image-2.6', seriesId: 'gpt-image', seriesRank: 2.6,
+        provider: 'kie', type: 'image',
+        tags: ['text-to-image', 'image-to-image', 'inpainting', 'transparent-background'],
+        polling: { interval: 3000, maxAttempts: 200 },
+    },
+    inputLimits: { images: { max: 16 }, videos: { max: 0 } },
+    params: [
+        { id: 'kieGpt26Variant', type: 'dropdown', order: 1, default: 'flare', options: gpt25Options(VARIANTS) },
+        { id: 'kieGpt26AspectRatio', type: 'dropdown', order: 2, default: 'smart', options: gpt25Options(['smart', ...GPT25_RATIOS]) },
+        { id: 'kieGpt26Resolution', type: 'dropdown', order: 3, default: '1K', options: gpt25Options(GPT25_RESOLUTIONS), visible: { condition: isTokenBilled } },
+        { id: 'kieGpt26Quality', type: 'dropdown', order: 4, default: 'medium', options: gpt25Options(GPT25_QUALITIES), visible: { condition: isTokenBilled } },
+        { id: 'kieGpt26Complexity', type: 'dropdown', order: 5, default: 'high', options: gpt25Options(COMPLEXITIES), visible: { condition: isTokenBilled } },
+        { id: 'kieGpt26Background', type: 'dropdown', order: 6, default: 'auto', options: gpt25Options(GPT25_BACKGROUNDS) },
+        {
+            id: 'kieGpt26Mask', type: 'image-upload', order: 7, default: [], valueType: 'array', maxCount: 1, format: 'url', accept: ['image/png'],
+            visible: { condition: params => isTokenBilled(params) && hasUploadedImage(params) },
+        },
+    ],
+    runtimeConstraints: { mediaFields: [{ field: 'mask_url', kind: 'image' }] },
+    endpoints: '/api/v1/jobs/createTask',
+    request: { builder: (params) => {
+            const variant = variantOf(params);
+            const economy = variant === 'economy';
+            const images = resolveUploadedImageSources(params);
+            if (images.length > 16)
+                throw new Error('GPT Image 2.6 最多支持 16 张参考图');
+            const maxPrompt = economy ? 20000 : 32000;
+            if (typeof params.prompt !== 'string' || !params.prompt.trim())
+                throw new Error('请输入 GPT Image 2.6 提示词');
+            if (params.prompt.length > maxPrompt)
+                throw new Error(`GPT Image 2.6 提示词最多 ${maxPrompt} 字符`);
+            const input = {
+                prompt: params.prompt,
+                aspect_ratio: gpt25Ratio(params, params.kieGpt26AspectRatio, economy ? ECONOMY_RATIOS : GPT25_RATIOS),
+                background: choice(params.kieGpt26Background, GPT25_BACKGROUNDS, 'auto'),
+            };
+            if (!economy) {
+                input.resolution = choice(params.kieGpt26Resolution, GPT25_RESOLUTIONS, '1K');
+                input.quality = choice(params.kieGpt26Quality, GPT25_QUALITIES, 'medium');
+                input.complexity = choice(params.kieGpt26Complexity, COMPLEXITIES, 'high');
+            }
+            if (images.length)
+                input.input_urls = images;
+            const masks = params.kieGpt26Mask === undefined ? [] : params.kieGpt26Mask;
+            if (!Array.isArray(masks) || masks.length > 1 || masks.some(m => typeof m !== 'string' || !m.trim()))
+                throw new Error('局部重绘遮罩必须是单张图片');
+            if (masks.length && !economy) {
+                if (!images.length)
+                    throw new Error('局部重绘需要先添加参考图');
+                input.mask_url = masks[0];
+            }
+            return { model: `gpt-image-2-6/${variant}-${images.length ? 'image-to-image' : 'text-to-image'}`, input };
+        } },
+    pricing: {
+        currency: '$', billingMode: 'estimated',
+        calculator: (params) => {
+            if (!isTokenBilled(params))
+                return 0.025;
+            const ratio = gpt25Ratio(params, params.kieGpt26AspectRatio, GPT25_RATIOS);
+            const resolution = choice(params.kieGpt26Resolution, GPT25_RESOLUTIONS, '1K');
+            const quality = choice(params.kieGpt26Quality, GPT25_QUALITIES, 'medium');
+            const index = ['low', 'medium', 'high', 'xhigh', 'max'].indexOf(quality === 'auto' ? 'max' : quality);
+            const reference = GPT25_OUTPUT_REFERENCE[ratio + (resolution === '1K' ? '' : '@' + resolution.toLowerCase())];
+            return reference.tokens[index] * 27 / 1_000_000;
+        },
+        description: 'Economy 1K $0.025/张；Flare/Sunburst 按 Token 计费（图片输出 $27、图片输入 $7.2、文本输入 $4.5 每百万 Token），按 2.5 同尺寸输出 Token 表估算输出费，输入另计，自动质量按最高档预估',
+    },
+});
+export default kieGptImage26Model;

package/dist/catalog/kie/gpt-image-2.model.js

@@ -6,14 +6,7 @@ export const kieGptImage2Model = defineModel({
         canonicalModelId: 'gpt-image-2',
         provider: 'kie',
         type: 'image',
-        tags: [
-            'text-to-image',
-            'image-to-image',
-            'supports-image-editing',
-            'supports-multi-image',
-            'supports-4k',
-            'provider-kie'
-        ],
+        tags: ['text-to-image', 'image-to-image'],
         aliases: ['gpt-image-2-kie']
     },
     inputLimits: {
@@ -67,9 +60,12 @@ export const kieGptImage2Model = defineModel({
                 }
                 return pair[0] / pair[1];
             };
-            const pickClosestRatio = (target) => {
-                const options = ['3:1', '21:9', '2:1', '16:9', '3:2', '4:3', '5:4', '1:1', '4:5', '3:4', '2:3', '9:16', '1:2', '9:21', '1:3'];
-                let best = '1:1';
+            // 智能比例只在当前分辨率与有无参考图下支持的比例里挑最接近的，不自己挑出平台会拒绝的组合。
+            const pickClosestRatio = (target, resolution, hasImages) => {
+                const options = ['3:1', '21:9', '2:1', '16:9', '3:2', '4:3', '5:4', '1:1', '4:5', '3:4', '2:3', '9:16', '1:2', '9:21', '1:3']
+                    .filter(ratio => resolution === '1K' || (!['5:4', '4:5'].includes(ratio)
+                    && (hasImages ? !(ratio === '1:1' && resolution === '4K') : !['3:1', '1:3', '9:21'].includes(ratio))));
+                let best = options[0];
                 let bestDiff = Number.POSITIVE_INFINITY;
                 for (const ratioText of options) {
                     const ratio = parseRatio(ratioText);
@@ -102,7 +98,7 @@ export const kieGptImage2Model = defineModel({
                 : null;
             const aspectRatioText = typeof rawAspectRatio === 'string' ? rawAspectRatio : '';
             const aspectRatio = !aspectRatioText || aspectRatioText === 'smart' || aspectRatioText === 'auto'
-                ? (ratioHint ? pickClosestRatio(ratioHint) : '1:1')
+                ? pickClosestRatio(ratioHint ?? 1, String(rawResolution), images.length > 0)
                 : aspectRatioText;
             const resolution = String(rawResolution);
             const textUnsupportedRatios = ['5:4', '4:5', '3:1', '1:3', '9:21'];

package/dist/catalog/kie/grok-imagine-2.0.model.js

@@ -8,7 +8,7 @@ export const kieGrokImagine20Model = defineModel({
         seriesRank: 2,
         provider: 'kie',
         type: 'image',
-        tags: ['text-to-image', 'image-to-image', 'supports-image-editing', 'multi-mode-switch', 'provider-kie'],
+        tags: ['text-to-image', 'image-to-image'],
         aliases: ['grok-imagine-image-2-kie']
     },
     inputLimits: {

package/dist/catalog/kie/grok-imagine-video-1.5.model.d.ts

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

package/dist/catalog/kie/grok-imagine-video-1.5.model.js

@@ -0,0 +1,52 @@
+import { defineModel } from '../defineModel.js';
+import { resolveKieImageSources } from './mediaSources.js';
+const RATIOS = ['auto', '16:9', '9:16', '1:1', '4:3', '3:4', '3:2', '2:3'];
+// 官方价格页只列 480p/720p，1080p 没有公开价格，不开放。
+const RATES = { '480p': 0.012, '720p': 0.0225 };
+const resolutionOf = (params) => params.kieGrokVideo15Resolution === '720p' ? '720p' : '480p';
+const secondsOf = (params) => Math.min(15, Math.max(1, Math.round(Number(params.kieGrokVideo15Duration ?? 8) || 8)));
+export const kieGrokImagineVideo15Model = defineModel({
+    meta: {
+        id: 'kie-grok-imagine-video-1.5', canonicalModelId: 'grok-imagine-video-1.5', seriesId: 'grok-imagine-video', seriesRank: 1.5,
+        provider: 'kie', type: 'video',
+        tags: ['image-to-video'],
+        promptLanguage: 'en',
+        polling: { interval: 3000, maxAttempts: 200, expectedAttempts: 40 },
+    },
+    // 官方 schema 把 image_urls 列为必填且最多 1 张。
+    inputLimits: { images: { exact: 1 }, videos: { max: 0 } },
+    requirements: [{
+            id: 'kie-grok-video-1.5-image', require: { images: { exact: 1 } },
+            message: { title: '图片必需', message: 'Grok Imagine Video 1.5 需要上传 1 张图片。', type: 'warning' },
+        }],
+    params: [
+        { id: 'kieGrokVideo15AspectRatio', type: 'dropdown', order: 1, default: 'auto', options: RATIOS.map(value => ({ value })) },
+        { id: 'kieGrokVideo15Resolution', type: 'dropdown', order: 2, default: '480p', options: Object.keys(RATES).map(value => ({ value })) },
+        { id: 'kieGrokVideo15Duration', type: 'number', order: 3, default: 8, min: 1, max: 15, step: 1 },
+    ],
+    endpoints: '/api/v1/jobs/createTask',
+    request: { builder: (params) => {
+            const images = resolveKieImageSources(params);
+            if (images.length !== 1)
+                throw new Error('Grok Imagine Video 1.5 需要 1 张图片');
+            const prompt = typeof params.prompt === 'string' ? params.prompt : '';
+            if (prompt.length > 4096)
+                throw new Error('Grok Imagine Video 1.5 提示词最多 4096 字符');
+            const ratio = String(params.kieGrokVideo15AspectRatio ?? 'auto');
+            const input = {
+                image_urls: images,
+                aspect_ratio: RATIOS.includes(ratio) ? ratio : 'auto',
+                resolution: resolutionOf(params),
+                duration: secondsOf(params),
+            };
+            if (prompt)
+                input.prompt = prompt;
+            return { model: 'grok-imagine-video-1-5-preview', input };
+        } },
+    pricing: {
+        currency: '$',
+        calculator: params => RATES[resolutionOf(params)] * secondsOf(params),
+        description: '480p $0.012/秒，720p $0.0225/秒（含同步生成的音频）',
+    },
+});
+export default kieGrokImagineVideo15Model;

package/dist/catalog/kie/grok-imagine-video.model.js

@@ -1,5 +1,5 @@
 import { defineModel } from "../defineModel.js";
-import { resolveKieImageSources } from './mediaSources.js';
+import { hasUploadedImage, resolveKieImageSources } from './mediaSources.js';
 const KIE_CREATE_TASK_ENDPOINT = '/api/v1/jobs/createTask';
 export const kieGrokImagineVideoModel = defineModel({
     meta: {
@@ -7,7 +7,8 @@ export const kieGrokImagineVideoModel = defineModel({
         canonicalModelId: 'grok-imagine-video',
         provider: 'kie',
         type: 'video',
-        tags: ['text-to-video', 'image-to-video', 'english-prompt-only', 'provider-kie'],
+        tags: ['text-to-video', 'image-to-video'],
+        promptLanguage: 'en',
         aliases: ['grok-imagine-video-kie'],
         polling: {
             interval: 3000,
@@ -24,6 +25,8 @@ export const kieGrokImagineVideoModel = defineModel({
             id: 'kieGrokImagineVideoAspectRatio',
             type: 'dropdown',
             order: 1,
+            // 图生视频的比例跟随图片，不发送。
+            visible: { condition: (params) => !hasUploadedImage(params) },
             default: '2:3',
             options: [
                 { value: '2:3' },
@@ -79,7 +82,8 @@ export const kieGrokImagineVideoModel = defineModel({
             const model = hasImages
                 ? 'grok-imagine/image-to-video'
                 : 'grok-imagine/text-to-video';
-            const input = { prompt, duration, resolution };
+            // 官方图生视频端点的 duration 是字符串，文生视频端点是数字。
+            const input = { prompt, duration: hasImages ? String(duration) : duration, resolution };
             if (!hasImages && aspectRatio) {
                 input.aspect_ratio = aspectRatio;
             }

package/dist/catalog/kie/grok-imagine.model.js

@@ -6,7 +6,7 @@ export const kieGrokImagineModel = defineModel({
         canonicalModelId: 'grok-imagine-image',
         provider: 'kie',
         type: 'image',
-        tags: ['text-to-image', 'provider-kie'],
+        tags: ['text-to-image', 'image-to-image'],
         aliases: ['grok-imagine-kie']
     },
     inputLimits: {
@@ -54,6 +54,7 @@ export const kieGrokImagineModel = defineModel({
             id: 'kieGrokImagineAspectRatio',
             type: 'dropdown',
             order: 3,
+            visible: { condition: 'kieGrokImagineMode !== "image-to-image"' },
             default: '1:1',
             options: [
                 { value: '1:1' },
@@ -76,7 +77,8 @@ export const kieGrokImagineModel = defineModel({
             const aspectRatio = params.kieGrokImagineAspectRatio || params.aspect_ratio;
             const mode = params.kieGrokImagineMode === 'image-to-image' ? 'image-to-image' : 'text-to-image';
             const input = { prompt };
-            if (aspectRatio && aspectRatio !== 'smart' && aspectRatio !== 'auto') {
+            // 图生图接口没有比例字段（官方 OpenAPI），比例跟随原图。
+            if (mode !== 'image-to-image' && aspectRatio && aspectRatio !== 'smart' && aspectRatio !== 'auto') {
                 input.aspect_ratio = aspectRatio;
             }
             if (mode === 'image-to-image') {

package/dist/catalog/kie/hailuo-02.model.js

@@ -8,8 +8,10 @@ function resolveHailuo02Spec(params) {
     let resolution = requestedResolution === '512P' || requestedResolution === '1080P'
         ? requestedResolution
         : '768P';
-    // KIE 的 512P 只属于 Standard 图生视频；文生视频 Standard 固定按 768P 请求/计价。
-    if (images.length === 0 && resolution === '512P') {
+    // 512P 只属于 Standard 单图图生视频：文生视频固定 768P；MiniMax 首尾帧不支持 512P
+    // （官方首尾帧文档原文；KIE 文档未写，带尾帧的 512P 请求在 KIE 内部失败 500，2026-11-08 实调），
+    // 两种情况都按 768P 请求和计价。
+    if (images.length !== 1 && resolution === '512P') {
         resolution = '768P';
     }
     // 1080P 只有 6 秒 Pro 档，历史工程的 10s + 1080P 回收到合法的 10s + 768P。
@@ -31,7 +33,7 @@ export const kieHailuo02Model = defineModel({
         seriesRank: 2.0,
         provider: 'kie',
         type: 'video',
-        tags: ['text-to-video', 'image-to-video', 'start-end-frame', 'provider-kie'],
+        tags: ['text-to-video', 'image-to-video', 'start-end-frame'],
         aliases: ['hailuo-02-kie'],
         polling: {
             interval: 3000,
@@ -119,7 +121,7 @@ export const kieHailuo02Model = defineModel({
                 return 0.285;
             return (resolution === '512P' ? 0.01 : 0.025) * duration;
         },
-        description: 'Standard：文生固定 768P $0.025/秒，图生 768P $0.025/秒、512P $0.010/秒；Pro（1080P 固定 6 秒）：$0.285/条'
+        description: 'Standard：文生与首尾帧固定 768P $0.025/秒，单图图生 768P $0.025/秒、512P $0.010/秒；Pro（1080P 固定 6 秒）：$0.285/条'
     }
 });
 export default kieHailuo02Model;

package/dist/catalog/kie/hailuo-2-3.model.js

@@ -21,7 +21,7 @@ export const kieHailuo23Model = defineModel({
         seriesRank: 2.3,
         provider: 'kie',
         type: 'video',
-        tags: ['image-to-video', 'provider-kie'],
+        tags: ['image-to-video'],
         aliases: ['hailuo-2-3-kie'],
         polling: {
             interval: 3000,

package/dist/catalog/kie/happyhorse-1.1.model.js

@@ -12,12 +12,15 @@ export const kieHappyHorse11Model = defineModel({
     meta: {
         id: 'kie-happyhorse-1.1', canonicalModelId: 'happyhorse-1.1', seriesId: 'happyhorse', seriesRank: 1.1,
         provider: 'kie', type: 'video',
-        tags: ['text-to-video', 'image-to-video', 'reference-mode', 'multi-mode-switch', 'supports-multi-image', 'provider-kie'],
+        tags: ['text-to-video', 'image-to-video', 'reference-mode'],
         polling: { interval: 5000, maxAttempts: 180, expectedAttempts: 60 },
     },
     inputLimits: {
         images: { max: 1 }, videos: { max: 0 }, audios: { max: 0 },
-        rules: [{ when: 'kieHappyHorse11Mode === "reference-to-video"', images: { min: 1, max: 9 } }],
+        rules: [
+            { imageConstraints: { minShortSidePx: 300, minAspectRatio: 0.4, maxAspectRatio: 2.5 } },
+            { when: 'kieHappyHorse11Mode === "reference-to-video"', images: { min: 1, max: 9 }, imageConstraints: { minShortSidePx: 400 } },
+        ],
     },
     params: [
         { id: 'kieHappyHorse11Mode', type: 'dropdown', order: 1, default: 'text-image-to-video',

package/dist/catalog/kie/kling-3.0-omni.model.js

@@ -1,5 +1,5 @@
 import { defineModel } from "../defineModel.js";
-import { hasUploadedVideo } from './mediaSources.js';
+import { hasUploadedImage, hasUploadedVideo } from './mediaSources.js';
 const KIE_CREATE_TASK_ENDPOINT = '/api/v1/jobs/createTask';
 export const kieKling30OmniModel = defineModel({
     meta: {
@@ -9,18 +9,7 @@ export const kieKling30OmniModel = defineModel({
         seriesRank: 3.02,
         provider: 'kie',
         type: 'video',
-        tags: [
-            'text-to-video',
-            'image-to-video',
-            'video-to-video',
-            'supports-video-editing',
-            'reference-mode',
-            'multi-mode-switch',
-            'mixed-upload-mode',
-            'supports-audio-generation',
-            'supports-4k',
-            'provider-kie'
-        ],
+        tags: ['text-to-video', 'image-to-video', 'reference-mode', 'video-to-video'],
         polling: { interval: 3000, maxAttempts: 300, expectedAttempts: 90 }
     },
     inputLimits: {
@@ -34,13 +23,17 @@ export const kieKling30OmniModel = defineModel({
             },
             {
                 when: 'kieKling30OmniMode === "transformation"',
-                images: { max: 7 },
+                images: { max: 4 },
                 videos: { exact: 1 }
             },
             {
                 when: 'kieKling30OmniMode === "reference-to-video"',
                 images: { max: 7 },
                 videos: { max: 1 }
+            },
+            {
+                imageConstraints: { minShortSidePx: 300, minAspectRatio: 0.4, maxAspectRatio: 2.5 },
+                videoConstraints: { minShortSidePx: 700, maxLongSidePx: 4553, maxPixels: 8_294_400, minAspectRatio: 0.4, maxAspectRatio: 2 }
             }
         ]
     },
@@ -83,6 +76,9 @@ export const kieKling30OmniModel = defineModel({
             id: 'kieKling30OmniAspectRatio',
             type: 'dropdown',
             order: 2,
+            // 图生视频、只带视频的风格转换由构建器固定发 auto，比例跟随素材。
+            visible: { condition: (params) => params.kieKling30OmniMode !== 'image-to-video'
+                    && !(['transformation', 'reference-to-video'].includes(String(params.kieKling30OmniMode)) && hasUploadedVideo(params) && !hasUploadedImage(params)) },
             default: 'smart',
             options: [
                 { value: 'smart' },
@@ -106,6 +102,8 @@ export const kieKling30OmniModel = defineModel({
             id: 'kieKling30OmniDuration',
             type: 'dropdown',
             order: 4,
+            // 只带视频的风格转换与参考生视频时长跟随视频，不发送。
+            visible: { condition: (params) => !(['transformation', 'reference-to-video'].includes(String(params.kieKling30OmniMode)) && hasUploadedVideo(params) && !hasUploadedImage(params)) },
             default: '5',
             options: Array.from({ length: 13 }, (_, index) => {
                 const value = String(index + 3);
@@ -116,6 +114,8 @@ export const kieKling30OmniModel = defineModel({
             id: 'kieKling30OmniAudio',
             type: 'switch',
             order: 5,
+            // 带参考视频的参考生视频官方只允许关闭音频。
+            visible: { condition: (params) => !(params.kieKling30OmniMode === 'reference-to-video' && hasUploadedVideo(params)) },
             default: false
         }
     ],
@@ -160,7 +160,7 @@ export const kieKling30OmniModel = defineModel({
                 aspect_ratio: aspectRatio,
                 audio: params.kieKling30OmniAudio === true
             };
-            if (!input.prompt && mode !== 'transformation')
+            if (!input.prompt)
                 throw new Error('Kling 3.0 Omni 的提示词不能为空');
             if (mode === 'image-to-video') {
                 input.aspect_ratio = 'auto';
@@ -168,14 +168,37 @@ export const kieKling30OmniModel = defineModel({
                     input.image_urls = [images[0]];
                 return { model: 'kling-3.0-omni/image-to-video', input };
             }
+            // 官方 OpenAPI 的风格转换与参考生视频按“只带视频 / 视频加图 / 只带图”分成互斥的几种请求体，
+            // 多余字段会被拒绝：只带视频时不传时长和图，比例只能 auto；视频加图时最多 4 张图；带视频的参考生视频不能开音频。
+            if (videos.length > 0 && images.length > 4)
+                throw new Error('Kling 3.0 Omni 带参考视频时最多 4 张参考图');
+            if (mode === 'reference-to-video' && images.length + videos.length === 0)
+                throw new Error('Kling 3.0 Omni 参考生视频至少需要一张参考图或一段参考视频');
             if (mode === 'transformation') {
+                const transformation = { prompt: input.prompt, resolution: input.resolution, audio: input.audio };
                 if (videos[0])
-                    input.video_urls = [videos[0]];
-                if (images.length > 0)
-                    input.image_urls = images.slice(0, 7);
-                if (videos.length > 0 && images.length === 0)
-                    input.aspect_ratio = 'auto';
-                return { model: 'kling-3.0-omni/transformation', input };
+                    transformation.video_urls = [videos[0]];
+                if (images.length > 0) {
+                    transformation.image_urls = images;
+                    transformation.duration = String(input.duration);
+                    transformation.aspect_ratio = aspectRatio;
+                }
+                else {
+                    transformation.aspect_ratio = 'auto';
+                }
+                return { model: 'kling-3.0-omni/transformation', input: transformation };
+            }
+            if (mode === 'reference-to-video' && videos.length > 0) {
+                const reference = { prompt: input.prompt, resolution: input.resolution, video_urls: [videos[0]], audio: false };
+                if (images.length > 0) {
+                    reference.image_urls = images;
+                    reference.duration = input.duration;
+                    reference.aspect_ratio = aspectRatio;
+                }
+                else {
+                    reference.aspect_ratio = 'auto';
+                }
+                return { model: 'kling-3.0-omni/reference-to-video', input: reference };
             }
             if (mode === 'reference-to-video') {
                 if (images.length > 0)
@@ -190,9 +213,14 @@ export const kieKling30OmniModel = defineModel({
     pricing: {
         currency: '$',
         calculator: (params) => {
-            const duration = Math.min(15, Math.max(3, Number(params.kieKling30OmniDuration || 5)));
-            const resolution = String(params.kieKling30OmniResolution || '720p');
             const hasVideoInput = hasUploadedVideo(params);
+            // 只带视频的风格转换与参考生视频不发时长，输出跟随视频，按视频时长估价。
+            const followsVideo = hasVideoInput && !hasUploadedImage(params) && ['transformation', 'reference-to-video'].includes(String(params.kieKling30OmniMode));
+            const videoSeconds = typeof params.__firstVideoDurationSeconds === 'number' && params.__firstVideoDurationSeconds > 0 ? params.__firstVideoDurationSeconds : 10;
+            const duration = followsVideo
+                ? Math.min(10, Math.max(3, Math.ceil(videoSeconds)))
+                : Math.min(15, Math.max(3, Number(params.kieKling30OmniDuration || 5)));
+            const resolution = String(params.kieKling30OmniResolution || '720p');
             if (resolution === '4k')
                 return duration * 0.335;
             if (hasVideoInput || params.kieKling30OmniMode === 'transformation') {

package/dist/catalog/kie/kling-3.0-turbo.model.js

@@ -9,7 +9,7 @@ export const kieKling30TurboModel = defineModel({
         seriesRank: 3.01,
         provider: 'kie',
         type: 'video',
-        tags: ['text-to-video', 'image-to-video', 'turbo-mode', 'provider-kie'],
+        tags: ['text-to-video', 'image-to-video'],
         polling: { interval: 3000, maxAttempts: 240, expectedAttempts: 70 }
     },
     inputLimits: {