@henjicc/ai-sdk 0.8.0 → 0.10.0

package/dist/catalog/shared/nanoBanana21.js

@@ -0,0 +1,30 @@
+export const NANO21_RATIOS = ['1:1', '2:3', '3:2', '1:4', '4:1', '3:4', '4:3', '4:5', '5:4', '1:8', '8:1', '9:16', '16:9', '21:9'];
+export const NANO21_RESOLUTIONS = ['1K', '2K', '4K'];
+export const nano21Options = (values) => values.map(value => ({ value }));
+export function nano21Choice(value, choices, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== 'string' || !choices.includes(value))
+        throw new Error(`Nano Banana 2.1 不支持参数值 ${String(value)}`);
+    return value;
+}
+export function nano21Count(value, max) {
+    if (value === undefined)
+        return 1;
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 1 || value > max) {
+        throw new Error(`Nano Banana 2.1 当前渠道每次支持 1–${max} 张输出图`);
+    }
+    return value;
+}
+export function nano21Prompt(params, max) {
+    if (typeof params.prompt !== 'string' || !params.prompt.trim())
+        throw new Error('请输入 Nano Banana 2.1 提示词');
+    if (max !== undefined && params.prompt.length > max)
+        throw new Error(`Nano Banana 2.1 提示词最多 ${max} 字符`);
+    return params.prompt;
+}
+/** 智能比例使用供应商原生 auto，不自行裁剪参考图或重新猜测比例。 */
+export function nano21Ratio(value) {
+    const ratio = nano21Choice(value, ['smart', 'auto', ...NANO21_RATIOS], 'smart');
+    return ratio === 'smart' ? 'auto' : ratio;
+}

package/dist/catalog/shared/shotList.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 分镜列表参数的值结构与校验：`[{ id?, prompt, duration }]`，按顺序成片，总时长等于各镜秒数之和。
+ * 界面（生成面板与画布节点）共用同一个 `shot-list` 面板写入这个结构，请求构建只读这里。
+ */
+import type { JsonValue } from '../../types/runtime.js';
+export interface ShotEntry {
+    prompt: string;
+    duration: number;
+}
+export interface ShotListLimits {
+    /** 单镜提示词最多字符数 */
+    maxPromptLength: number;
+    minShotSeconds: number;
+    maxShotSeconds: number;
+    /** 总时长范围，与不分镜时的时长参数一致 */
+    minTotalSeconds: number;
+    maxTotalSeconds: number;
+}
+/** 读出分镜；不是数组或没有镜头时返回空数组，表示没有使用分镜。 */
+export declare function readShots(value: JsonValue | undefined): ShotEntry[];
+/** 估价与界面汇总用：非法秒数按 0 计，结果夹在总时长范围内。 */
+export declare function shotTotalSeconds(value: JsonValue | undefined, limits: Pick<ShotListLimits, 'minTotalSeconds' | 'maxTotalSeconds'>): number;
+/**
+ * 提交前校验并转成供应商的 `multi_prompt` 结构；不合法时抛出能直接给用户看的原因。
+ * 平台的分镜与主提示词二选一，所以主提示词当作整体描述（人物、风格、场景）拼在每一镜前面，
+ * 每镜只写这一镜发生什么，不必重复交代。
+ */
+export declare function buildShotPrompts(value: JsonValue | undefined, limits: ShotListLimits, modelName: string, sharedPrompt?: string): Array<{
+    prompt: string;
+    duration: number;
+}>;

package/dist/catalog/shared/shotList.js

@@ -0,0 +1,48 @@
+/**
+ * 分镜列表参数的值结构与校验：`[{ id?, prompt, duration }]`，按顺序成片，总时长等于各镜秒数之和。
+ * 界面（生成面板与画布节点）共用同一个 `shot-list` 面板写入这个结构，请求构建只读这里。
+ */
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** 读出分镜；不是数组或没有镜头时返回空数组，表示没有使用分镜。 */
+export function readShots(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter(isObject).map((shot) => ({
+        prompt: typeof shot.prompt === 'string' ? shot.prompt.trim() : '',
+        duration: Math.round(Number(shot.duration)),
+    }));
+}
+/** 估价与界面汇总用：非法秒数按 0 计，结果夹在总时长范围内。 */
+export function shotTotalSeconds(value, limits) {
+    const total = readShots(value).reduce((sum, shot) => sum + (Number.isFinite(shot.duration) && shot.duration > 0 ? shot.duration : 0), 0);
+    return Math.min(limits.maxTotalSeconds, Math.max(limits.minTotalSeconds, total));
+}
+/**
+ * 提交前校验并转成供应商的 `multi_prompt` 结构；不合法时抛出能直接给用户看的原因。
+ * 平台的分镜与主提示词二选一，所以主提示词当作整体描述（人物、风格、场景）拼在每一镜前面，
+ * 每镜只写这一镜发生什么，不必重复交代。
+ */
+export function buildShotPrompts(value, limits, modelName, sharedPrompt = '') {
+    const shared = sharedPrompt.trim();
+    const shots = readShots(value).map(shot => ({ ...shot, prompt: shot.prompt && shared ? `${shared}\n${shot.prompt}` : shot.prompt }));
+    shots.forEach((shot, index) => {
+        const label = `${modelName} 第 ${index + 1} 镜`;
+        if (!shot.prompt)
+            throw new Error(`${label}的提示词不能为空`);
+        if (shot.prompt.length > limits.maxPromptLength) {
+            throw new Error(shared
+                ? `${label}加上主提示词后超过 ${limits.maxPromptLength} 字符，请缩短主提示词或这一镜`
+                : `${label}的提示词最多 ${limits.maxPromptLength} 字符`);
+        }
+        if (!Number.isInteger(shot.duration) || shot.duration < limits.minShotSeconds || shot.duration > limits.maxShotSeconds) {
+            throw new Error(`${label}的时长须为 ${limits.minShotSeconds}–${limits.maxShotSeconds} 秒`);
+        }
+    });
+    const total = shots.reduce((sum, shot) => sum + shot.duration, 0);
+    if (shots.length > 0 && (total < limits.minTotalSeconds || total > limits.maxTotalSeconds)) {
+        throw new Error(`${modelName} 分镜总时长须为 ${limits.minTotalSeconds}–${limits.maxTotalSeconds} 秒，当前 ${total} 秒`);
+    }
+    return shots.map(({ prompt, duration }) => ({ prompt, duration }));
+}

package/dist/catalog/shared/subjectElements.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 元素（角色 / 物体主体）参数的值结构与校验，供 Kling 4.0 在 Fal 与 KIE 上共用。
+ *
+ * 值结构：`[{ id?, name?, kind: 'image' | 'video', images: string[], videos: string[], videoSeconds? }]`，
+ * `videoSeconds` 是上传时读到的视频时长，只用于估价，不发给平台。
+ * 图片元素第 1 张是正面主图、其余是其他角度；视频元素只用一段 3–8 秒单镜头视频。
+ * Fal 在提示词里按顺序写 `@Element1`，KIE 写元素名 `@名称`，所以名称只对 KIE 有意义。
+ * 媒体值是本地受管路径，由公共上传预处理按字段名（`frontal_image_url`、`image_urls`、`video_url`）上传替换。
+ */
+import type { JsonObject, JsonValue } from '../../types/runtime.js';
+export interface SubjectElementEntry {
+    name: string;
+    kind: 'image' | 'video';
+    images: string[];
+    video?: string;
+    videoSeconds?: number;
+}
+/** 两家对元素的共同上限：最多 7 个，其中视频元素最多 3 个；图片元素 2–4 张图。 */
+export declare const SUBJECT_ELEMENT_LIMITS: {
+    readonly maxItems: 7;
+    readonly maxVideoItems: 3;
+    readonly minImages: 2;
+    readonly maxImages: 4;
+};
+export declare function readSubjectElements(value: JsonValue | undefined): SubjectElementEntry[];
+/** 视频元素按视频输入计费的总秒数：用上传时读到的时长，读不到按上限计。 */
+export declare function subjectElementVideoSeconds(value: JsonValue | undefined): number;
+/** Fal：图片元素拆成正面主图与其他角度，视频元素只给视频；提示词按顺序引用 `@Element1`。 */
+export declare function buildFalSubjectElements(value: JsonValue | undefined, modelName: string): JsonObject[];
+/**
+ * KIE：每个元素必须有唯一名称，提示词用 `@名称` 引用。
+ * Flash 端点用 `type` 区分图片与视频元素，标准版没有这个字段。
+ */
+export declare function buildKieSubjectElements(value: JsonValue | undefined, modelName: string, options: {
+    sendType: boolean;
+}): JsonObject[];

package/dist/catalog/shared/subjectElements.js

@@ -0,0 +1,93 @@
+/**
+ * 元素（角色 / 物体主体）参数的值结构与校验，供 Kling 4.0 在 Fal 与 KIE 上共用。
+ *
+ * 值结构：`[{ id?, name?, kind: 'image' | 'video', images: string[], videos: string[], videoSeconds? }]`，
+ * `videoSeconds` 是上传时读到的视频时长，只用于估价，不发给平台。
+ * 图片元素第 1 张是正面主图、其余是其他角度；视频元素只用一段 3–8 秒单镜头视频。
+ * Fal 在提示词里按顺序写 `@Element1`，KIE 写元素名 `@名称`，所以名称只对 KIE 有意义。
+ * 媒体值是本地受管路径，由公共上传预处理按字段名（`frontal_image_url`、`image_urls`、`video_url`）上传替换。
+ */
+/** 两家对元素的共同上限：最多 7 个，其中视频元素最多 3 个；图片元素 2–4 张图。 */
+export const SUBJECT_ELEMENT_LIMITS = { maxItems: 7, maxVideoItems: 3, minImages: 2, maxImages: 4 };
+/** 视频元素时长读不到时按官方上限 8 秒估价，宁可估高，避免付费授权金额偏低。 */
+const SUBJECT_ELEMENT_VIDEO_MAX_SECONDS = 8;
+const KIE_NAME_PATTERN = /^[一-龥A-Za-z0-9_]{1,20}$/;
+const KIE_RESERVED_NAME = /^(?:(?:image|video|keyframe|object|audio)_\d+|first_frame|last_frame)$/i;
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function sources(value) {
+    if (typeof value === 'string')
+        return value.trim() ? [value.trim()] : [];
+    return Array.isArray(value) ? value.filter((item) => typeof item === 'string' && item.trim().length > 0).map(item => item.trim()) : [];
+}
+export function readSubjectElements(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter(isObject).map((element) => {
+        const images = sources(element.images);
+        const videos = sources(element.videos);
+        const kind = element.kind === 'video' || (element.kind !== 'image' && videos.length > 0 && images.length === 0) ? 'video' : 'image';
+        return {
+            name: typeof element.name === 'string' ? element.name.trim() : '',
+            kind,
+            images: kind === 'image' ? images : [],
+            ...(kind === 'video' && videos[0] ? { video: videos[0] } : {}),
+            ...(kind === 'video' && typeof element.videoSeconds === 'number' && element.videoSeconds > 0 ? { videoSeconds: element.videoSeconds } : {}),
+        };
+    });
+}
+/** 视频元素按视频输入计费的总秒数：用上传时读到的时长，读不到按上限计。 */
+export function subjectElementVideoSeconds(value) {
+    return readSubjectElements(value)
+        .filter(element => element.kind === 'video')
+        .reduce((total, element) => total + Math.min(SUBJECT_ELEMENT_VIDEO_MAX_SECONDS, element.videoSeconds ?? SUBJECT_ELEMENT_VIDEO_MAX_SECONDS), 0);
+}
+function validate(elements, modelName) {
+    const limits = SUBJECT_ELEMENT_LIMITS;
+    if (elements.length > limits.maxItems)
+        throw new Error(`${modelName} 最多 ${limits.maxItems} 个元素`);
+    if (elements.filter(element => element.kind === 'video').length > limits.maxVideoItems)
+        throw new Error(`${modelName} 最多 ${limits.maxVideoItems} 个视频元素`);
+    elements.forEach((element, index) => {
+        const label = `${modelName} 第 ${index + 1} 个元素`;
+        if (element.kind === 'video') {
+            if (!element.video)
+                throw new Error(`${label}还没有上传视频`);
+        }
+        else if (element.images.length < limits.minImages || element.images.length > limits.maxImages) {
+            throw new Error(`${label}需要 ${limits.minImages}–${limits.maxImages} 张图（第 1 张为正面主图）`);
+        }
+    });
+}
+/** Fal：图片元素拆成正面主图与其他角度，视频元素只给视频；提示词按顺序引用 `@Element1`。 */
+export function buildFalSubjectElements(value, modelName) {
+    const elements = readSubjectElements(value);
+    validate(elements, modelName);
+    return elements.map((element) => element.kind === 'video'
+        ? { video_url: element.video }
+        : { frontal_image_url: element.images[0], reference_image_urls: element.images.slice(1) });
+}
+/**
+ * KIE：每个元素必须有唯一名称，提示词用 `@名称` 引用。
+ * Flash 端点用 `type` 区分图片与视频元素，标准版没有这个字段。
+ */
+export function buildKieSubjectElements(value, modelName, options) {
+    const elements = readSubjectElements(value);
+    validate(elements, modelName);
+    const seen = new Set();
+    return elements.map((element, index) => {
+        const label = `${modelName} 第 ${index + 1} 个元素`;
+        if (!KIE_NAME_PATTERN.test(element.name))
+            throw new Error(`${label}的名称须为 1–20 个汉字、字母、数字或下划线`);
+        if (KIE_RESERVED_NAME.test(element.name))
+            throw new Error(`${label}的名称“${element.name}”是保留名，请换一个`);
+        const key = element.name.toLowerCase();
+        if (seen.has(key))
+            throw new Error(`${label}的名称“${element.name}”与前面的元素重复`);
+        seen.add(key);
+        if (element.kind === 'video')
+            return { name: element.name, video_url: element.video, ...(options.sendType ? { type: 'video' } : {}) };
+        return { name: element.name, image_urls: element.images };
+    });
+}

package/dist/catalog/siliconflow/moss-ttsd-0.5.model.js

@@ -3,7 +3,7 @@ import { speechCharacterPrice, speechString, speechText } from '../audio/tts-com
 export const siliconflowMossTtsd05Model = defineModel({
     meta: {
         id: 'siliconflow-moss-ttsd-0.5', canonicalModelId: 'moss-ttsd-v0.5', provider: 'siliconflow', type: 'audio',
-        tags: ['text-to-audio'],
+        tags: ['text-to-audio', 'multi-speaker-dialogue'],
     },
     inputLimits: { images: { max: 0 }, videos: { max: 0 } },
     params: [

package/dist/catalog/validate.js

@@ -8,6 +8,7 @@
  * 同样的报错文案），应用侧改为调用本模块，不再维护第二份判断，避免源码与副本
  * 静默分叉。
  */
+import { isModelTag } from '../types/modelTags.js';
 export class ModelRuntimeValidationError extends Error {
     constructor(message) {
         super(message);
@@ -55,6 +56,10 @@ function validateMeta(model, fail) {
         if (!Array.isArray(meta.tags)) {
             fail('Model meta.tags must be an array');
         }
+        const unknown = meta.tags.filter((tag) => typeof tag !== 'string' || !isModelTag(tag));
+        if (unknown.length) {
+            fail(`Model meta.tags has tags outside MODEL_TAG_DEFINITIONS: ${unknown.join(', ')}`);
+        }
     }
     if (meta.polling) {
         if (typeof meta.polling.interval !== 'number' || meta.polling.interval <= 0) {
@@ -276,6 +281,9 @@ function validatePricing(model, fail) {
         fail('Model pricing.currency is required and must be a string');
     }
     const hasFixed = typeof pricing.fixed === 'number';
+    if (pricing.billingMode !== undefined && pricing.billingMode !== 'estimated') {
+        fail('Model pricing.billingMode must be estimated');
+    }
     const hasCalculator = typeof pricing.calculator === 'function';
     if (!hasFixed && !hasCalculator) {
         fail('Model pricing must have either fixed or calculator');
@@ -323,10 +331,15 @@ function validatePricing(model, fail) {
             ? ['megapixels', 'width', 'height', 'fileSizeBytes'].includes(requirement.metric)
             : requirement.mediaType === 'video'
                 ? ['durationSeconds', 'megapixels', 'width', 'height'].includes(requirement.metric)
-                : false;
+                : requirement.mediaType === 'audio'
+                    ? requirement.metric === 'durationSeconds'
+                    : false;
         if (!validMetric) {
             fail(`${prefix} has an unsupported mediaType/metric combination`);
         }
+        if (requirement.when !== undefined && typeof requirement.when !== 'function') {
+            fail(`${prefix}.when must be a function`);
+        }
         const multiplier = requirement.multiplier;
         if (!multiplier)
             return;

package/dist/catalog/volcengine/seedance-2.0-fast.model.d.ts

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

package/dist/catalog/volcengine/seedance-2.0-fast.model.js

@@ -0,0 +1,11 @@
+import { createVolcengineSeedanceModel } from './seedance.js';
+// 价格：https://www.volcengine.com/docs/82379/1544106 （在线推理 token 单价，分输入含 / 不含视频两档）
+export const volcengineSeedance20FastModel = createVolcengineSeedanceModel({
+    id: 'volcengine-seedance-2.0-fast', canonicalModelId: 'seedance-2.0-fast', seriesRank: 2.1,
+    apiModel: 'doubao-seedance-2-0-fast-260128', paramPrefix: 'volcengineSeedance20Fast', generation: '2.0',
+    resolutions: ['480p', '720p'],
+    tokenPrices: { '480p': 37, '720p': 37 },
+    videoTokenPrices: { '480p': 22, '720p': 22 },
+    priceDescription: '按 token 计费：480p/720p ¥37 每百万 token；token ≈ 时长 × 宽 × 高 × 24 / 1024（720p 16:9 5 秒约 ¥4.00）；带参考视频时 480p/720p ¥22 每百万 token，输入视频时长也计入（不足 4 秒按 4 秒）',
+});
+export default volcengineSeedance20FastModel;

package/dist/catalog/volcengine/seedance-2.0-mini.model.d.ts

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

package/dist/catalog/volcengine/seedance-2.0-mini.model.js

@@ -0,0 +1,11 @@
+import { createVolcengineSeedanceModel } from './seedance.js';
+// 价格：https://www.volcengine.com/docs/82379/1544106 （在线推理 token 单价，分输入含 / 不含视频两档）
+export const volcengineSeedance20MiniModel = createVolcengineSeedanceModel({
+    id: 'volcengine-seedance-2.0-mini', canonicalModelId: 'seedance-2.0-mini', seriesRank: 2.05,
+    apiModel: 'doubao-seedance-2-0-mini-260615', paramPrefix: 'volcengineSeedance20Mini', generation: '2.0',
+    resolutions: ['480p', '720p'],
+    tokenPrices: { '480p': 23, '720p': 23 },
+    videoTokenPrices: { '480p': 14, '720p': 14 },
+    priceDescription: '按 token 计费：480p/720p ¥23 每百万 token；token ≈ 时长 × 宽 × 高 × 24 / 1024（720p 16:9 5 秒约 ¥2.48）；带参考视频时 480p/720p ¥14 每百万 token，输入视频时长也计入（不足 4 秒按 4 秒）',
+});
+export default volcengineSeedance20MiniModel;

package/dist/catalog/volcengine/seedance-2.0.model.d.ts

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

package/dist/catalog/volcengine/seedance-2.0.model.js

@@ -0,0 +1,11 @@
+import { createVolcengineSeedanceModel } from './seedance.js';
+// 价格：https://www.volcengine.com/docs/82379/1544106 （在线推理 token 单价，分输入含 / 不含视频两档）
+export const volcengineSeedance20Model = createVolcengineSeedanceModel({
+    id: 'volcengine-seedance-2.0', canonicalModelId: 'seedance-2.0', seriesRank: 2,
+    apiModel: 'doubao-seedance-2-0-260128', paramPrefix: 'volcengineSeedance20', generation: '2.0',
+    resolutions: ['480p', '720p', '1080p', '4k'],
+    tokenPrices: { '480p': 46, '720p': 46, '1080p': 51, '4k': 26 },
+    videoTokenPrices: { '480p': 28, '720p': 28, '1080p': 31, '4k': 16 },
+    priceDescription: '按 token 计费：480p/720p ¥46、1080p ¥51、4K ¥26 每百万 token；token ≈ 时长 × 宽 × 高 × 24 / 1024（720p 16:9 5 秒约 ¥4.97）；带参考视频时 480p/720p ¥28、1080p ¥31、4K ¥16 每百万 token，输入视频时长也计入（不足 4 秒按 4 秒）',
+});
+export default volcengineSeedance20Model;

package/dist/catalog/volcengine/seedance-2.5.model.d.ts

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

package/dist/catalog/volcengine/seedance-2.5.model.js

@@ -0,0 +1,11 @@
+import { createVolcengineSeedanceModel } from './seedance.js';
+// 价格：https://www.volcengine.com/docs/82379/1544106 （在线推理 token 单价，分输入含 / 不含视频两档）
+export const volcengineSeedance25Model = createVolcengineSeedanceModel({
+    id: 'volcengine-seedance-2.5', canonicalModelId: 'seedance-2.5', seriesRank: 2.5,
+    apiModel: 'doubao-seedance-2-5-260628', paramPrefix: 'volcengineSeedance25', generation: '2.5',
+    resolutions: ['480p', '720p', '1080p'],
+    tokenPrices: { '480p': 70, '720p': 70, '1080p': 77 },
+    videoTokenPrices: { '480p': 42, '720p': 42, '1080p': 46 },
+    priceDescription: '按 token 计费：480p/720p ¥70、1080p ¥77 每百万 token；token ≈ 时长 × 宽 × 高 × 24 / 1024（720p 16:9 5 秒约 ¥7.56）；自动时长按 30 秒预估；带参考视频时 480p/720p ¥42、1080p ¥46 每百万 token，输入视频时长也计入（不足 4 秒按 4 秒）',
+});
+export default volcengineSeedance25Model;

package/dist/catalog/volcengine/seedance.d.ts

@@ -0,0 +1,17 @@
+/** 火山方舟官方 Seedance 2.5 / 2.0 系列视频生成模型的共用运行时契约。 */
+export interface VolcengineSeedanceConfig {
+    id: string;
+    canonicalModelId: string;
+    seriesRank: number;
+    apiModel: string;
+    /** 参数 ID 前缀，例如 `volcengineSeedance25`。 */
+    paramPrefix: string;
+    generation: '2.5' | '2.0';
+    resolutions: string[];
+    /** 输入不含视频时的在线推理 token 单价（元/百万 token），按输出分辨率。 */
+    tokenPrices: Record<string, number>;
+    /** 输入含参考视频时的 token 单价（元/百万 token）；输入视频时长同样计入 token 用量。 */
+    videoTokenPrices: Record<string, number>;
+    priceDescription: string;
+}
+export declare function createVolcengineSeedanceModel(config: VolcengineSeedanceConfig): import("../../index.js").ModelRuntimeDefinition;

package/dist/catalog/volcengine/seedance.js

@@ -0,0 +1,192 @@
+/** 火山方舟官方 Seedance 2.5 / 2.0 系列视频生成模型的共用运行时契约。 */
+import { defineModel } from '../defineModel.js';
+import { hasUploadedImage, resolveUploadedImageSources, resolveUploadedVideoDurationSeconds, resolveUploadedVideoSources } from '../shared/mediaPresence.js';
+const RATIOS = ['16:9', '4:3', '1:1', '3:4', '9:16', '21:9'];
+const MIN_BILLED_INPUT_VIDEO_SECONDS = 4;
+/** 官方「不同宽高比对应的宽高像素值」表；2.5 与 2.0 系列在 480p 档取值不同。 */
+const PIXELS = {
+    '2.5': {
+        '480p': { '16:9': [854, 480], '4:3': [752, 560], '1:1': [640, 640], '3:4': [560, 752], '9:16': [480, 854], '21:9': [992, 432] },
+        '720p': { '16:9': [1280, 720], '4:3': [1112, 834], '1:1': [960, 960], '3:4': [834, 1112], '9:16': [720, 1280], '21:9': [1470, 630] },
+        '1080p': { '16:9': [1920, 1080], '4:3': [1664, 1248], '1:1': [1440, 1440], '3:4': [1248, 1664], '9:16': [1080, 1920], '21:9': [2206, 946] },
+    },
+    '2.0': {
+        '480p': { '16:9': [864, 496], '4:3': [752, 560], '1:1': [640, 640], '3:4': [560, 752], '9:16': [496, 864], '21:9': [992, 432] },
+        '720p': { '16:9': [1280, 720], '4:3': [1112, 834], '1:1': [960, 960], '3:4': [834, 1112], '9:16': [720, 1280], '21:9': [1470, 630] },
+        '1080p': { '16:9': [1920, 1080], '4:3': [1664, 1248], '1:1': [1440, 1440], '3:4': [1248, 1664], '9:16': [1080, 1920], '21:9': [2206, 946] },
+        '4k': { '16:9': [3840, 2160], '4:3': [3326, 2494], '1:1': [2880, 2880], '3:4': [2494, 3326], '9:16': [2160, 3840], '21:9': [4398, 1886] },
+    },
+};
+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);
+}
+export function createVolcengineSeedanceModel(config) {
+    const key = (name) => config.paramPrefix + name;
+    const is25 = config.generation === '2.5';
+    const maxDuration = is25 ? 30 : 15;
+    const maxReferenceImages = is25 ? 30 : 9;
+    const maxReferenceAudios = is25 ? 10 : 3;
+    // 参考视频：2.5 最多 10 段、合计 ≤ 30 秒；2.0 系列最多 3 段、合计 ≤ 15 秒。只收公网 URL，本地文件经通用文件上传服务托管。
+    const maxReferenceVideos = is25 ? 10 : 3;
+    const maxReferenceVideoSeconds = is25 ? 30 : 15;
+    // 2.5 才有显式任务类型；编辑、延长都要求至少一段参考视频且比例自适应，编辑还不能指定时长。
+    // 默认显式发 reference：提交时就校验限制，也不会因提示词里的“替换”被平台判成编辑任务后异步失败。
+    const taskType = (params) => {
+        const value = String(params[key('TaskType')] ?? 'reference');
+        return is25 && (value === 'auto' || value === 'edit' || value === 'extend') ? value : 'reference';
+    };
+    const editing = `${key('Mode')} === "reference-to-video" && ${key('TaskType')} === "edit"`;
+    const resolution = (params) => {
+        const value = String(params[key('Resolution')] ?? '720p');
+        return config.resolutions.includes(value) ? value : '720p';
+    };
+    const autoDuration = (params) => is25 && params[key('AutoDuration')] === true;
+    const duration = (params) => Math.min(maxDuration, Math.max(4, Math.round(Number(params[key('Duration')] || 5))));
+    const params = [
+        {
+            id: key('Mode'), type: 'dropdown', order: 1,
+            // 参考模式不设素材下限（2.5 可以只传音频），默认放在文/图生视频，带多图或音频时由按素材选模式切过去。
+            default: 'text-image-to-video',
+            options: [{ value: 'text-image-to-video' }, { value: 'reference-to-video' }],
+        },
+        ...(is25 ? [{
+                id: key('TaskType'), type: 'dropdown', order: 2, default: 'reference',
+                visible: { condition: `${key('Mode')} === "reference-to-video"` },
+                options: [{ value: 'reference' }, { value: 'edit' }, { value: 'extend' }, { value: 'auto' }],
+            }] : []),
+        {
+            id: key('AspectRatio'), type: 'dropdown', order: 3,
+            // 2.5 的首帧 / 首尾帧与编辑、延长任务只接受 adaptive，比例跟随素材。
+            ...(is25 ? { visible: { condition: (params) => params[key('Mode')] === 'reference-to-video'
+                        ? !['edit', 'extend'].includes(String(params[key('TaskType')]))
+                        : !hasUploadedImage(params) } } : {}),
+            default: 'smart',
+            options: [{ value: 'smart' }, ...['1:1', '4:3', '3:4', '16:9', '9:16', '21:9'].map((value) => ({ value }))],
+        },
+        {
+            id: key('Resolution'), type: 'dropdown', order: 4,
+            default: '720p',
+            options: config.resolutions.map((value) => ({ value })),
+        },
+        {
+            id: key('Duration'), type: 'number', order: 5,
+            default: 5, min: 4, max: maxDuration, step: 1,
+            ...(is25 ? { visible: { condition: `!(${editing})` } } : {}),
+        },
+        ...(is25 ? [{ id: key('AutoDuration'), type: 'switch', order: 6, default: false, visible: { condition: `!(${editing})` } }] : []),
+        { id: key('GenerateAudio'), type: 'switch', order: 7, default: true },
+        { id: key('ReturnLastFrame'), type: 'switch', order: 8, default: false },
+        { id: key('WebSearch'), type: 'switch', order: 9, default: false },
+    ];
+    return defineModel({
+        meta: {
+            id: config.id, canonicalModelId: config.canonicalModelId, seriesId: 'seedance', seriesRank: config.seriesRank,
+            provider: 'volcengine', type: 'video',
+            tags: is25
+                ? ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode', 'video-to-video', 'video-extension']
+                : ['text-to-video', 'image-to-video', 'start-end-frame', 'reference-mode'],
+            polling: { interval: 5000, maxAttempts: 400, expectedAttempts: 60 },
+        },
+        inputLimits: {
+            images: { max: 2 }, videos: { max: 0 }, audios: { max: 0 },
+            rules: [
+                {
+                    when: `${key('Mode')} === "reference-to-video"`,
+                    images: { max: maxReferenceImages }, videos: { max: maxReferenceVideos }, audios: { max: maxReferenceAudios },
+                },
+                ...(is25 ? [{
+                        when: `${key('Mode')} === "reference-to-video" && (${key('TaskType')} === "edit" || ${key('TaskType')} === "extend")`,
+                        images: { max: maxReferenceImages }, videos: { min: 1, max: maxReferenceVideos }, audios: { max: maxReferenceAudios },
+                    }] : []),
+                { imageConstraints: { minShortSidePx: 300, maxLongSidePx: 6000, minAspectRatio: 0.4, maxAspectRatio: 2.5 } },
+            ],
+        },
+        params,
+        endpoints: '/api/v3/contents/generations/tasks',
+        request: {
+            builder: (input) => {
+                const images = resolveUploadedImageSources(input);
+                const audios = audioSources(input);
+                const videos = resolveUploadedVideoSources(input);
+                const reference = input[key('Mode')] !== 'text-image-to-video';
+                const rawRatio = String(input[key('AspectRatio')] || 'smart');
+                const prompt = typeof input.prompt === 'string' ? input.prompt.trim() : '';
+                const content = [];
+                if (prompt)
+                    content.push({ type: 'text', text: prompt });
+                const body = {
+                    model: config.apiModel,
+                    content,
+                    resolution: resolution(input),
+                    ratio: RATIOS.includes(rawRatio) ? rawRatio : 'adaptive',
+                    duration: autoDuration(input) ? -1 : duration(input),
+                    generate_audio: input[key('GenerateAudio')] !== false,
+                    return_last_frame: input[key('ReturnLastFrame')] === true,
+                    watermark: false,
+                };
+                if (input[key('WebSearch')] === true)
+                    body.tools = [{ type: 'web_search' }];
+                if (reference) {
+                    if (images.length + audios.length + videos.length === 0)
+                        throw new Error(`Seedance ${config.generation} 参考生视频至少需要一张参考图、一段参考视频或参考音频`);
+                    if (!is25 && audios.length > 0 && images.length + videos.length === 0)
+                        throw new Error('Seedance 2.0 的参考音频必须与参考图或参考视频一起使用');
+                    const task = taskType(input);
+                    if ((task === 'edit' || task === 'extend') && videos.length === 0) {
+                        throw new Error(`Seedance 2.5 的${task === 'edit' ? '视频编辑' : '视频延长'}至少需要一段参考视频`);
+                    }
+                    if (is25)
+                        body.omni_reference_task_type = task;
+                    if (task === 'edit' || task === 'extend')
+                        body.ratio = 'adaptive';
+                    // 编辑任务的输出时长跟随原视频，官方只接受 -1。
+                    if (task === 'edit')
+                        body.duration = -1;
+                    for (const url of images.slice(0, maxReferenceImages))
+                        content.push({ type: 'image_url', image_url: { url }, role: 'reference_image' });
+                    for (const url of videos.slice(0, maxReferenceVideos))
+                        content.push({ type: 'video_url', video_url: { url }, role: 'reference_video' });
+                    for (const url of audios.slice(0, maxReferenceAudios))
+                        content.push({ type: 'audio_url', audio_url: { url }, role: 'reference_audio' });
+                    return body;
+                }
+                if (!prompt && images.length === 0)
+                    throw new Error(`Seedance ${config.generation} 文生视频需要填写提示词`);
+                images.slice(0, 2).forEach((url, index) => {
+                    content.push({ type: 'image_url', image_url: { url }, role: index === 0 ? 'first_frame' : 'last_frame' });
+                });
+                // 2.5 首帧、首尾帧任务只接受 adaptive，输出比例跟随首帧。
+                if (is25 && images.length > 0)
+                    body.ratio = 'adaptive';
+                return body;
+            },
+        },
+        pricing: {
+            currency: '¥',
+            calculator: (input) => {
+                const res = resolution(input);
+                const rawRatio = String(input[key('AspectRatio')] || 'smart');
+                const table = PIXELS[config.generation][res] ?? PIXELS[config.generation]['720p'];
+                const [width, height] = table[rawRatio] ?? table['16:9'];
+                const withVideo = input[key('Mode')] !== 'text-image-to-video' && resolveUploadedVideoSources(input).length > 0;
+                const task = taskType(input);
+                // 读不到参考视频时长时按输出时长估，并封顶到平台的合计上限。
+                const inputSeconds = withVideo
+                    ? Math.min(maxReferenceVideoSeconds, resolveUploadedVideoDurationSeconds(input, duration(input)))
+                    : 0;
+                // 编辑任务输出时长跟随原视频；自动时长按上限预估。
+                const outputSeconds = task === 'edit' && withVideo ? inputSeconds : autoDuration(input) ? maxDuration : duration(input);
+                // 官方 token 用量估算：(输入视频时长 + 输出时长) × 宽 × 高 × 24fps / 1024。
+                // 含视频时另有最低 token 用量：官方价格示例里输入 2–4 秒同价，即输入视频不足 4 秒按 4 秒计。
+                const billedInputSeconds = withVideo ? Math.max(MIN_BILLED_INPUT_VIDEO_SECONDS, inputSeconds) : 0;
+                const tokens = (billedInputSeconds + outputSeconds) * width * height * 24 / 1024;
+                const prices = withVideo ? config.videoTokenPrices : config.tokenPrices;
+                return tokens * (prices[res] ?? prices['720p']) / 1_000_000;
+            },
+            description: config.priceDescription,
+        },
+    });
+}

package/dist/catalog/volcengine/seedream-5.0-lite.model.js

@@ -6,7 +6,8 @@ export const volcengineSeedream50LiteModel = defineModel({
     meta: {
         id: 'volcengine-seedream-5.0-lite', canonicalModelId: 'seedream-5.0-lite', seriesId: 'seedream', seriesRank: 5,
         provider: 'volcengine', type: 'image',
-        tags: ['text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'max-images-14', 'multi-output', 'supports-4k', 'provider-volcengine'],
+        deprecated: '火山方舟 2026-11-24 关停 doubao-seedream-5-0-260128，官方替代为 5.0 Pro',
+        tags: ['text-to-image', 'image-to-image'],
         aliases: ['seedream-5-lite-official']
     },
     inputLimits: { images: { max: 14 }, videos: { max: 0 } },

package/dist/catalog/volcengine/seedream-5.0.js

@@ -9,7 +9,7 @@ export function createSeedream50Model(config) {
         meta: {
             id: config.id, canonicalModelId: config.canonicalModelId, seriesId: 'seedream', seriesRank: 5.1,
             provider: 'volcengine', type: 'image',
-            tags: ['text-to-image', 'image-to-image', 'supports-image-editing', 'supports-multi-image', 'supports-layer-decomposition', 'max-images-10', 'provider-volcengine'],
+            tags: ['text-to-image', 'image-to-image', 'layer-decomposition', 'transparent-background'],
             aliases: config.aliases
         },
         inputLimits: {

package/dist/catalog/volcengine-speech/seed-icl-2.0.model.d.ts

@@ -1,2 +1,3 @@
+export declare const VOLC_CLONE_LANGUAGES: number[];
 export declare const volcengineSeedIcl20Model: import("../../index.js").ModelRuntimeDefinition;
 export default volcengineSeedIcl20Model;