@henjicc/ai-sdk 0.9.0 → 0.10.0

package/dist/packs/provider-packs/modelscope.js

@@ -2,8 +2,8 @@
 import model1 from '../../catalog/modelscope/flux-1-krea-dev.model.js';
 import model2 from '../../catalog/modelscope/majicmix-realistic.model.js';
 import model3 from '../../catalog/modelscope/modelscope-custom.model.js';
-import model4 from '../../catalog/modelscope/qwen-image-edit-2509.model.js';
-import model5 from '../../catalog/modelscope/qwen-image.model.js';
+import model4 from '../../catalog/modelscope/qwen-image-2512.model.js';
+import model5 from '../../catalog/modelscope/qwen-image-edit-2511.model.js';
 import model6 from '../../catalog/modelscope/sdxl-14-ckpt.model.js';
 import model7 from '../../catalog/modelscope/z-image-turbo.model.js';
 import { provider } from '../provider-adapters/modelscope.js';

package/dist/packs/provider-packs/ppio.d.ts

@@ -1,4 +1,4 @@
 import type { GenerationPack } from '../../generation/core.js';
-export declare const models: readonly [import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition];
+export declare const models: readonly [import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition];
 export declare const pack: GenerationPack;
 export default pack;

package/dist/packs/provider-packs/ppio.js

@@ -1,11 +1,7 @@
 /** 由 scripts/generate-catalog-index.cjs 自动生成；只聚合当前供应商的真实模型文件。 */
 import model1 from '../../catalog/ppio/kling-3.0.model.js';
-import model2 from '../../catalog/ppio/minimax-hailuo-2.3.model.js';
-import model3 from '../../catalog/ppio/minimax-speech.model.js';
-import model4 from '../../catalog/ppio/wan-2.5-preview.model.js';
-import model5 from '../../catalog/ppio/wan-2.6.model.js';
-import model6 from '../../catalog/ppio/wan-2.7.model.js';
+import model2 from '../../catalog/ppio/minimax-speech.model.js';
 import { provider } from '../provider-adapters/ppio.js';
-export const models = [model1, model2, model3, model4, model5, model6];
+export const models = [model1, model2];
 export const pack = { models, providers: [provider] };
 export default pack;

package/dist/packs/provider-packs/volcengine.d.ts

@@ -1,4 +1,4 @@
 import type { GenerationPack } from '../../generation/core.js';
-export declare const models: readonly [import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition];
+export declare const models: readonly [import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition, import("../../index.js").ModelRuntimeDefinition];
 export declare const pack: GenerationPack;
 export default pack;

package/dist/packs/provider-packs/volcengine.js

@@ -1,8 +1,12 @@
 /** 由 scripts/generate-catalog-index.cjs 自动生成；只聚合当前供应商的真实模型文件。 */
-import model1 from '../../catalog/volcengine/seedream-5.0-flash.model.js';
-import model2 from '../../catalog/volcengine/seedream-5.0-lite.model.js';
-import model3 from '../../catalog/volcengine/seedream-5.0-pro.model.js';
+import model1 from '../../catalog/volcengine/seedance-2.0-fast.model.js';
+import model2 from '../../catalog/volcengine/seedance-2.0-mini.model.js';
+import model3 from '../../catalog/volcengine/seedance-2.0.model.js';
+import model4 from '../../catalog/volcengine/seedance-2.5.model.js';
+import model5 from '../../catalog/volcengine/seedream-5.0-flash.model.js';
+import model6 from '../../catalog/volcengine/seedream-5.0-lite.model.js';
+import model7 from '../../catalog/volcengine/seedream-5.0-pro.model.js';
 import { provider } from '../provider-adapters/volcengine.js';
-export const models = [model1, model2, model3];
+export const models = [model1, model2, model3, model4, model5, model6, model7];
 export const pack = { models, providers: [provider] };
 export default pack;

package/dist/pricing/index.d.ts

@@ -1 +1,2 @@
 export * from './mediaContext.js';
+export * from './tokenPricing.js';

package/dist/pricing/index.js

@@ -1 +1,2 @@
 export * from './mediaContext.js';
+export * from './tokenPricing.js';

package/dist/pricing/mediaContext.d.ts

@@ -10,16 +10,21 @@ export interface PricingVideoMetadata {
     height: number;
     durationSeconds: number;
 }
+export interface PricingAudioMetadata {
+    durationSeconds: number;
+}
 export interface PricingMediaMetadataReaders {
     image: (source: string) => Promise<PricingImageMetadata>;
     video: (source: string) => Promise<PricingVideoMetadata>;
+    /** 可选：宿主没有音频探针时，按音频计价的指标记为缺失。 */
+    audio?: (source: string) => Promise<PricingAudioMetadata>;
 }
 export interface ResolvedPricingMediaContext {
     params: JsonObject;
     complete: boolean;
     missingTargets: string[];
 }
-export declare function resolvePricingMediaSources(mediaType: 'image' | 'video', params: JsonObject): string[];
+export declare function resolvePricingMediaSources(mediaType: 'image' | 'video' | 'audio', params: JsonObject): string[];
 /**
  * 用宿主提供的媒体探针补齐 calculator 所需指标。函数不依赖 DOM、Node 或 Electron，
  * Web、桌面和插件宿主可以共用同一套来源优先级、聚合与倍率换算。

package/dist/pricing/mediaContext.js

@@ -1,6 +1,7 @@
 const MEDIA_SOURCE_KEYS = {
     image: ['uploadedFilePaths', 'images', 'uploadedImages'],
     video: ['uploadedVideoFilePaths', 'videos', 'uploadedVideos'],
+    audio: ['uploadedAudioFilePaths', 'audios', 'uploadedAudios'],
 };
 function cachedRead(cache, source, reader) {
     const cached = cache.get(source);
@@ -28,7 +29,7 @@ export function resolvePricingMediaSources(mediaType, params) {
 }
 function readMetric(requirement, metadata) {
     if (requirement.metric === 'megapixels') {
-        return metadata.width > 0 && metadata.height > 0
+        return 'width' in metadata && metadata.width > 0 && metadata.height > 0
             ? metadata.width * metadata.height / 1_000_000
             : null;
     }
@@ -61,8 +62,10 @@ async function resolveRequirement(requirement, params, readers) {
         try {
             const metadata = requirement.mediaType === 'image'
                 ? await readers.image(source)
-                : await readers.video(source);
-            return readMetric(requirement, metadata);
+                : requirement.mediaType === 'video'
+                    ? await readers.video(source)
+                    : readers.audio ? await readers.audio(source) : null;
+            return metadata ? readMetric(requirement, metadata) : null;
         }
         catch {
             return null;
@@ -86,14 +89,18 @@ export async function resolvePricingMediaContext(requirements, params, readers)
     }
     const imageReads = new Map();
     const videoReads = new Map();
+    const audioReads = new Map();
+    const audioReader = readers.audio;
     const memoizedReaders = {
         image: (source) => cachedRead(imageReads, source, readers.image),
         video: (source) => cachedRead(videoReads, source, readers.video),
+        ...(audioReader ? { audio: (source) => cachedRead(audioReads, source, audioReader) } : {}),
     };
-    const resolvedValues = await Promise.all(requirements.map((requirement) => resolveRequirement(requirement, params, memoizedReaders)));
+    const applicable = requirements.filter((requirement) => requirement.when?.(params) ?? true);
+    const resolvedValues = await Promise.all(applicable.map((requirement) => resolveRequirement(requirement, params, memoizedReaders)));
     const next = { ...params };
     const missingTargets = [];
-    requirements.forEach((requirement, index) => {
+    applicable.forEach((requirement, index) => {
         const value = resolvedValues[index];
         if (value === null || !Number.isFinite(value) || value <= 0) {
             delete next[requirement.targetParam];

package/dist/pricing/tokenPricing.d.ts

@@ -0,0 +1,36 @@
+/** 每百万 tokens 的单价。 */
+export interface TokenPrice {
+    inputPerMillionTokens: number;
+    outputPerMillionTokens: number;
+    /** 命中上下文缓存的输入单价；供应商未单列时省略。 */
+    cacheReadPerMillionTokens?: number;
+}
+/**
+ * 供应商公布的按量标准价：不含限时优惠、Batch 折扣与免费额度，只用于展示与参考估价，不代表账单。
+ * 价格随供应商走：同一模型在不同平台托管，单价各自登记。
+ */
+export interface TokenListPricing extends TokenPrice {
+    currency: 'CNY' | 'USD';
+    /** 按单次请求的输入长度分档：输入超过 aboveInputTokens 时整次请求按该档结算；顶层是最低一档。 */
+    tiers?: ReadonlyArray<TokenPrice & {
+        aboveInputTokens: number;
+    }>;
+    /** 分时计价：顶层是高峰价（参考估价取保守值），offPeak 是其余时段的价格。 */
+    offPeak?: TokenPrice & {
+        peakHours: string;
+    };
+}
+/** 按“输入 / 输出 / 缓存命中”的顺序登记单价，和供应商价格表的列序一致，便于逐行对照。 */
+export declare function tokenListPrice(currency: TokenListPricing['currency'], input: number, output: number, cacheRead?: number): TokenListPricing;
+export declare function tokenPrice(input: number, output: number, cacheRead?: number): TokenPrice;
+/** 每个汉字约折多少 token，附官方出处；用来把 token 单价换成“每万字”的参考价。 */
+export interface TextTokenRatio {
+    tokensPerChineseChar: number;
+    source: string;
+}
+export declare function textTokenRatioFor(modelId: string): TextTokenRatio;
+/** 按顶层单价（最低档、高峰时段）估算一段中文输入与输出的费用，币种同 pricing。 */
+export declare function estimateChineseTextCost(pricing: TokenListPricing, ratio: TextTokenRatio, chars: {
+    input: number;
+    output: number;
+}): number;

package/dist/pricing/tokenPricing.js

@@ -0,0 +1,26 @@
+/** 按“输入 / 输出 / 缓存命中”的顺序登记单价，和供应商价格表的列序一致，便于逐行对照。 */
+export function tokenListPrice(currency, input, output, cacheRead) {
+    return { currency, ...tokenPrice(input, output, cacheRead) };
+}
+export function tokenPrice(input, output, cacheRead) {
+    return { inputPerMillionTokens: input, outputPerMillionTokens: output, ...(cacheRead === undefined ? {} : { cacheReadPerMillionTokens: cacheRead }) };
+}
+/**
+ * 换算比例跟着模型的分词器走，不跟托管平台走：硅基流动、派欧云、百炼上的 DeepSeek 仍按 DeepSeek 的比例。
+ * 公布区间的取偏多一端，参考价宁可偏高。没有公布比例的模型（Qwen、豆包、MiMo、gpt-oss 等）用硅基流动对“典型中文模型”的说法，
+ * 1 token 约 1–2 个汉字，同样取 1 字 1 token。
+ */
+const TEXT_TOKEN_RATIOS = [
+    { match: /deepseek/i, ratio: { tokensPerChineseChar: 0.6, source: 'https://api-docs.deepseek.com/zh-cn/quick_start/token_usage' } },
+    { match: /kimi|moonshot/i, ratio: { tokensPerChineseChar: 1 / 1.5, source: 'https://platform.kimi.com/docs/introduction' } },
+    { match: /glm/i, ratio: { tokensPerChineseChar: 1 / 1.6, source: 'https://docs.bigmodel.cn/cn/guide/start/introduction' } },
+    { match: /minimax/i, ratio: { tokensPerChineseChar: 1000 / 1600, source: 'https://platform.minimax.cn/docs/pricing/overview' } },
+];
+const FALLBACK_TEXT_TOKEN_RATIO = { tokensPerChineseChar: 1, source: 'https://docs.siliconflow.com/en/faqs/billing-rules' };
+export function textTokenRatioFor(modelId) {
+    return TEXT_TOKEN_RATIOS.find(item => item.match.test(modelId))?.ratio ?? FALLBACK_TEXT_TOKEN_RATIO;
+}
+/** 按顶层单价（最低档、高峰时段）估算一段中文输入与输出的费用，币种同 pricing。 */
+export function estimateChineseTextCost(pricing, ratio, chars) {
+    return (chars.input * pricing.inputPerMillionTokens + chars.output * pricing.outputPerMillionTokens) * ratio.tokensPerChineseChar / 1_000_000;
+}

package/dist/providers/bailian.d.ts

@@ -1,3 +1,3 @@
 import type { ProviderContinuePollingInput, ProviderExecutionInput, ProviderExecutionResult } from '../types/runtime.js';
 export declare function execute(input: ProviderExecutionInput): Promise<ProviderExecutionResult>;
-export declare function continuePolling(_input: ProviderContinuePollingInput): Promise<ProviderExecutionResult>;
+export declare function continuePolling(input: ProviderContinuePollingInput): Promise<ProviderExecutionResult>;

package/dist/providers/bailian.js

@@ -1,26 +1,60 @@
 import { AiRuntimeError } from '../runtime/AiRuntimeError.js';
+import { POLL_QUERY_FAILED, pollUntilResult } from '../protocols/polling.js';
 import { getPointer, isJsonObject, normalizeEndpoint, pushUniqueUrl, readJsonResponse, stringAt } from './helpers.js';
 import { fetchProvider } from './provider-fetch.js';
 import { hexAudioToDataUri } from './audio-data.js';
 const BAILIAN_BASE_URL = 'https://dashscope.aliyuncs.com';
+/** 只支持异步调用的 DashScope 路由：提交必须带 `X-DashScope-Async: enable`，结果按 `/api/v1/tasks/{task_id}` 查询。 */
+const ASYNC_ROUTES = new Set(['/api/v1/services/aigc/video-generation/video-synthesis']);
+function isAsyncRoute(route) {
+    return ASYNC_ROUTES.has(route.replace(/\/+$/, ''));
+}
+async function readBailianJson(response, model) {
+    return await readJsonResponse(response, 'Bailian', (body) => {
+        const message = ['/message', '/error/message', '/output/base_resp/status_msg']
+            .map((pointer) => stringAt(body, pointer))
+            .find((value) => value && /product is not activated|model.*(?:not activated|not authorized)|产品未开通|模型未开通/i.test(value));
+        if (message) {
+            throw new AiRuntimeError('provider_product_not_activated', `百炼账号未开通该模型（${model ?? '当前模型'}），请到百炼控制台 https://bailian.console.aliyun.com/ 开通后重试；开通前不要重复提交。`, {
+                retryable: false, category: 'authentication', status: response.status,
+                providerCode: stringAt(body, '/code') ?? stringAt(body, '/error/code') ?? getPointer(body, '/output/base_resp/status_code'),
+                providerMessage: message,
+            });
+        }
+    });
+}
 export async function execute(input) {
+    const asyncTask = isAsyncRoute(input.route);
+    const body = JSON.stringify(input.body);
     const response = await fetchProvider('Bailian', normalizeEndpoint(BAILIAN_BASE_URL, input.route), {
         method: input.method,
         headers: {
             Authorization: `Bearer ${input.apiKey}`,
             'Content-Type': 'application/json',
+            ...(asyncTask ? { 'X-DashScope-Async': 'enable' } : {}),
+            // 本地素材经临时存储上传成 oss:// 后，官方要求带这个头才会解析。
+            ...(body.includes('"oss://') ? { 'X-DashScope-OssResourceResolve': 'enable' } : {}),
         },
-        body: JSON.stringify(input.body),
+        body,
         signal: input.signal,
     }, {
         transport: input.runtime.transport,
         retryPreconnectOnce: true,
     });
-    const payload = await readJsonResponse(response, 'Bailian');
+    const payload = await readBailianJson(response, stringAt(input.body, '/model'));
     const errorCode = stringAt(payload, '/code');
     if (errorCode) {
         throw new AiRuntimeError('provider_task_failed', stringAt(payload, '/message') ?? errorCode);
     }
+    if (asyncTask) {
+        const taskStatus = stringAt(payload, '/output/task_status');
+        if (taskStatus === 'FAILED' || taskStatus === 'CANCELED')
+            throw taskFailure(payload, taskStatus);
+        const taskId = stringAt(payload, '/output/task_id')?.trim();
+        if (!taskId)
+            throw new AiRuntimeError('invalid_response', 'Bailian async task response has no task_id');
+        return { status: 'pending', url: '', taskId, metadata: payload };
+    }
     const speechStatus = getPointer(payload, '/output/base_resp/status_code');
     if (typeof speechStatus === 'number' && speechStatus !== 0) {
         throw new AiRuntimeError('provider_task_failed', stringAt(payload, '/output/base_resp/status_msg') ?? `MiniMax status ${speechStatus}`);
@@ -54,8 +88,41 @@ export async function execute(input) {
     }
     return { status: 'completed', url: urls.join('|||'), metadata: payload };
 }
-export async function continuePolling(_input) {
-    throw new AiRuntimeError('unsupported_provider', 'Bailian official image models use synchronous generation');
+export async function continuePolling(input) {
+    if (!isAsyncRoute(input.route)) {
+        throw new AiRuntimeError('unsupported_provider', 'Bailian official image models use synchronous generation');
+    }
+    const payload = await pollUntilResult(input, async () => {
+        const response = await fetchProvider('Bailian', `${BAILIAN_BASE_URL}/api/v1/tasks/${encodeURIComponent(input.taskId)}`, {
+            headers: { Authorization: `Bearer ${input.apiKey}` },
+            signal: input.signal,
+        }, {
+            transport: input.runtime.transport,
+            retryPreconnectOnce: true,
+        });
+        const result = await readBailianJson(response, undefined);
+        const status = stringAt(result, '/output/task_status');
+        if (status === 'SUCCEEDED')
+            return result;
+        if (status === 'PENDING' || status === 'RUNNING')
+            return undefined;
+        if (status === 'FAILED' || status === 'CANCELED')
+            throw taskFailure(result, status);
+        // UNKNOWN 表示任务不存在或已过 24 小时查询期；与缺状态一样计入连续查询失败，不立刻判死。
+        return POLL_QUERY_FAILED;
+    });
+    const videoUrl = stringAt(payload, '/output/video_url');
+    if (!videoUrl || !/^https?:\/\//i.test(videoUrl)) {
+        throw new AiRuntimeError('empty_result', `Bailian task has no video_url (task_id=${input.taskId})`);
+    }
+    return { status: 'completed', url: videoUrl, taskId: input.taskId, metadata: payload };
+}
+function taskFailure(payload, status) {
+    const code = stringAt(payload, '/output/code');
+    const message = stringAt(payload, '/output/message') ?? (status === 'CANCELED' ? '任务已取消' : 'Bailian task failed');
+    return new AiRuntimeError('provider_task_failed', code ? `${code}: ${message}` : message, {
+        providerCode: code, providerMessage: message,
+    });
 }
 function extractImageUrls(value) {
     const urls = [];

package/dist/providers/fal.js

@@ -121,9 +121,19 @@ function requireFalQueueUrl(value, field) {
     }
     return parsed.toString();
 }
+/**
+ * `draft_cache` 是 FLUX 3 草稿端点返回的加密缓存包，只用于转正片，不是生成结果；
+ * 收进媒体地址会被宿主当成第二段视频下载。它仍原样留在 metadata 里供续接读取。
+ */
 function extractUrls(payload) {
     const urls = [];
-    collectDeepUrls(payload, urls);
+    if (isJsonObject(payload) && 'draft_cache' in payload) {
+        const { draft_cache: _draftCache, ...media } = payload;
+        collectDeepUrls(media, urls);
+    }
+    else {
+        collectDeepUrls(payload, urls);
+    }
     return urls;
 }
 function enrichRequestId(value, requestId) {

package/dist/providers/helpers.d.ts

@@ -1,6 +1,6 @@
 import type { JsonObject, JsonValue } from '../types/runtime.js';
 export declare function normalizeEndpoint(base: string, route: string): string;
-export declare function readJsonResponse(response: Response, provider: string): Promise<JsonValue>;
+export declare function readJsonResponse(response: Response, provider: string, inspect?: (payload: JsonValue) => void): Promise<JsonValue>;
 export declare function asObject(value: JsonValue): JsonObject;
 export declare function getPointer(value: JsonValue, pointer: string): JsonValue | undefined;
 export declare function stringAt(value: JsonValue, pointer: string): string | undefined;

package/dist/providers/helpers.js

@@ -1,4 +1,5 @@
 import { AiRuntimeError } from '../runtime/AiRuntimeError.js';
+import { assertProviderAccess } from './providerAccessErrors.js';
 export function normalizeEndpoint(base, route) {
     if (route.startsWith('http://') || route.startsWith('https://')) {
         return route;
@@ -8,13 +9,24 @@ export function normalizeEndpoint(base, route) {
     }
     return `${base}/${route}`;
 }
-export async function readJsonResponse(response, provider) {
-    const payload = await response.json().catch((error) => {
+export async function readJsonResponse(response, provider, inspect) {
+    const text = await response.text();
+    let payload;
+    try {
+        payload = JSON.parse(text);
+    }
+    catch (error) {
+        if (!response.ok) {
+            assertProviderAccess(provider, {}, response.status);
+            throw new AiRuntimeError('provider_http_error', `${provider} HTTP ${response.status}: ${text.slice(0, 500)}`, { status: response.status });
+        }
         const message = error instanceof Error ? error.message : String(error);
-        throw new AiRuntimeError('invalid_json', message);
-    });
+        throw new AiRuntimeError('invalid_json', message, { status: response.status });
+    }
+    inspect?.(payload);
+    assertProviderAccess(provider, payload, response.status);
     if (!response.ok) {
-        throw new AiRuntimeError('provider_http_error', `${provider} HTTP ${response.status}: ${JSON.stringify(payload)}`);
+        throw new AiRuntimeError('provider_http_error', `${provider} HTTP ${response.status}: ${JSON.stringify(payload)}`, { status: response.status });
     }
     return payload;
 }

package/dist/providers/kie.js

@@ -42,6 +42,7 @@ async function sendCreateTask(input, endpoint) {
     const code = getPointer(payload, '/code');
     const success = getPointer(payload, '/success');
     if ((typeof code === 'number' && code !== 200) || success === false) {
+        assertKieTaskFailure(code, stringAt(payload, '/msg') ?? '');
         throw new AiRuntimeError('provider_task_failed', stringAt(payload, '/msg') ?? 'KIE create task failed');
     }
     return payload;
@@ -58,16 +59,18 @@ async function pollTask(input) {
         });
         const payload = await readJsonResponse(response, 'KIE');
         const code = getPointer(payload, '/code');
-        if (typeof code === 'number' && code !== 200) {
-            // 查询本身没成功（含 taskId 已被清理的情况），不是"任务还在跑"
-            return POLL_QUERY_FAILED;
+        if ((typeof code === 'number' && code !== 200) || getPointer(payload, '/success') === false) {
+            // 查询失败保留供应商事实；鉴权/余额错误已由 readJsonResponse 立即终止。
+            const message = stringAt(payload, '/msg') ?? stringAt(payload, '/message') ?? 'provider reported a non-success status';
+            throw new AiRuntimeError('provider_http_error', `KIE recordInfo code=${code ?? 'unknown'}: ${message}`, {
+                status: response.status, providerCode: code, providerMessage: message,
+            });
         }
-        if (getPointer(payload, '/success') === false)
-            return POLL_QUERY_FAILED;
         const state = (stringAt(payload, '/data/state') ?? '').trim().toLowerCase();
         if (state === 'success')
             return payload;
         if (state === 'fail') {
+            assertKieTaskFailure(getPointer(payload, '/data/failCode'), stringAt(payload, '/data/failMsg') ?? '');
             throw new AiRuntimeError('provider_task_failed', stringAt(payload, '/data/failMsg') ?? 'KIE task failed');
         }
         if (['waiting', 'queuing', 'generating'].includes(state))
@@ -75,6 +78,14 @@ async function pollTask(input) {
         return POLL_QUERY_FAILED;
     });
 }
+function assertKieTaskFailure(code, message) {
+    if (/^Internal Error(?:,|\.|$)/i.test(message.trim())) {
+        throw new AiRuntimeError('provider_internal_error', 'KIE 服务内部错误，可稍后手动重试。', { retryable: true, terminal: true, providerCode: code, providerMessage: message });
+    }
+    if (String(code) === '422') {
+        throw new AiRuntimeError('provider_invalid_request', `KIE 拒绝了请求参数，请修改后重试：${message}`, { retryable: false, providerCode: code, providerMessage: message });
+    }
+}
 function extractTaskId(payload) {
     return stringAt(payload, '/data/taskId');
 }

package/dist/providers/metadata.js

@@ -82,8 +82,8 @@ export const PROVIDER_METADATA = [
     {
         providerId: 'minimax',
         displayName: 'MiniMax',
-        websiteUrl: 'https://platform.minimaxi.com/',
-        apiKeyUrl: 'https://platform.minimaxi.com/console/access?tab=api-keys',
+        websiteUrl: 'https://platform.minimax.cn/',
+        apiKeyUrl: 'https://platform.minimax.cn/console/access?tab=api-keys',
         websiteUrlKind: 'official',
         docs: 'docs/llm-adaptation/供应商/MiniMax.md',
     },

package/dist/providers/openai-speech.d.ts

@@ -0,0 +1,6 @@
+import type { ProviderExecutionInput, ProviderExecutionResult } from '../types/runtime.js';
+/**
+ * OpenAI 兼容 `/audio/speech`：同步返回音频二进制，错误时返回 JSON 错误体。
+ * 返回的音频转成 data URI，由宿主按普通媒体结果落盘。
+ */
+export declare function executeOpenAiCompatibleSpeech(providerName: string, baseUrl: string, input: ProviderExecutionInput, defaultFormat: string): Promise<ProviderExecutionResult>;

package/dist/providers/openai-speech.js

@@ -0,0 +1,31 @@
+import { audioBytesToDataUri } from './audio-data.js';
+import { isJsonObject, normalizeEndpoint, readJsonResponse } from './helpers.js';
+import { fetchProvider } from './provider-fetch.js';
+/**
+ * OpenAI 兼容 `/audio/speech`：同步返回音频二进制，错误时返回 JSON 错误体。
+ * 返回的音频转成 data URI，由宿主按普通媒体结果落盘。
+ */
+export async function executeOpenAiCompatibleSpeech(providerName, baseUrl, input, defaultFormat) {
+    const response = await fetchProvider(providerName, normalizeEndpoint(baseUrl, input.route), {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${input.apiKey}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(input.body),
+        signal: input.signal,
+    }, {
+        transport: input.runtime.transport,
+        retryPreconnectOnce: true,
+    });
+    if (!response.ok) {
+        await readJsonResponse(response, providerName);
+    }
+    const bytes = new Uint8Array(await response.arrayBuffer());
+    const format = isJsonObject(input.body) && typeof input.body.response_format === 'string' ? input.body.response_format : defaultFormat;
+    return {
+        status: 'completed',
+        url: audioBytesToDataUri(bytes, format),
+        metadata: { contentType: response.headers.get('content-type'), byteLength: bytes.byteLength },
+    };
+}

package/dist/providers/providerAccessErrors.d.ts

@@ -0,0 +1,3 @@
+import type { JsonValue } from '../types/runtime.js';
+/** 仅按供应商官方错误契约识别；未知 403/500 保留原分类，禁止猜测余额或模型开通状态。 */
+export declare function assertProviderAccess(provider: string, payload: JsonValue, status: number): void;

package/dist/providers/providerAccessErrors.js

@@ -0,0 +1,73 @@
+import { AiRuntimeError } from '../runtime/AiRuntimeError.js';
+const object = (value) => value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+/** 仅按供应商官方错误契约识别；未知 403/500 保留原分类，禁止猜测余额或模型开通状态。 */
+export function assertProviderAccess(provider, payload, status) {
+    const body = object(payload);
+    const error = object(body.error ?? body.errors);
+    const code = String(error.code ?? body.code ?? '');
+    const providerMessage = String(error.message ?? body.message ?? body.msg ?? '');
+    if (provider === 'KIE' && (['401', '403'].includes(code) || status === 401 || status === 403)) {
+        throw new AiRuntimeError('provider_authentication_failed', 'KIE 鉴权失败，请检查 API Key 与账号权限。控制台：https://kie.ai/api-key', {
+            retryable: false, category: 'authentication', providerCode: code || String(status), status,
+            providerMessage: String(error.message ?? body.message ?? body.msg ?? ''),
+        });
+    }
+    let kind;
+    let accountNotVerified = false;
+    if (provider === 'Bailian') {
+        if (code === 'Arrearage')
+            kind = 'insufficient_balance';
+        else if (code === 'AccessDenied.Unpurchased')
+            kind = 'product_not_activated';
+        else if (code === 'Model.AccessDenied')
+            kind = 'model_access_denied';
+    }
+    else if (provider === 'KIE' && (code === '402' || status === 402))
+        kind = 'insufficient_balance';
+    else if (provider === 'PPIO') {
+        if (['BILLING_BALANCE_NOT_ENOUGH', 'NOT_ENOUGH_BALANCE'].includes(code))
+            kind = 'insufficient_balance';
+        else if (['API_NOT_ALLOWED', 'ACCESS_DENY'].includes(code))
+            kind = 'model_access_denied';
+    }
+    else if (provider === 'SiliconFlow') {
+        if (status === 402)
+            kind = 'insufficient_balance';
+        else if (status === 403)
+            kind = 'model_access_denied';
+    }
+    else if (provider === 'APIMart') {
+        if (code === '402' || status === 402)
+            kind = 'insufficient_balance';
+        else if (code === '403' || status === 403)
+            kind = 'model_access_denied';
+    }
+    else if (provider === 'ModelScope') {
+        // 魔搭 API 推理只对完成邮箱验证的账号开放；这个 403 只有英文 message，没有错误码。
+        if (status === 403 && /verified accounts|email verification/i.test(providerMessage)) {
+            kind = 'product_not_activated';
+            accountNotVerified = true;
+        }
+    }
+    else if (provider === 'Volcengine Ark') {
+        if (code === 'AccountOverdueError')
+            kind = 'insufficient_balance';
+        else if (['ModelNotOpen', 'OperationDenied.ServiceNotOpen'].includes(code))
+            kind = 'product_not_activated';
+        else if (['AccessDenied', 'OperationDenied.PermissionDenied'].includes(code))
+            kind = 'model_access_denied';
+    }
+    if (!kind)
+        return;
+    const name = provider === 'Bailian' ? '百炼' : provider === 'SiliconFlow' ? '硅基流动' : provider === 'Volcengine Ark' ? '火山方舟' : provider === 'ModelScope' ? '魔搭' : provider;
+    const destination = { Bailian: 'https://bailian.console.aliyun.com/', KIE: 'https://kie.ai/', PPIO: 'https://ppio.com/console', SiliconFlow: 'https://cloud.siliconflow.cn/', APIMart: 'https://apimart.ai/', 'Volcengine Ark': 'https://console.volcengine.com/ark/', ModelScope: 'https://modelscope.cn/my/settings/account' };
+    const action = accountNotVerified ? '账号需先完成邮箱验证才能调用 API 推理，请到账号设置完成验证后重试'
+        : kind === 'insufficient_balance' ? '账户余额不足或已欠费，请充值后重试'
+            : kind === 'product_not_activated' ? '账号未开通该模型，请先开通模型服务'
+                : '账号没有该模型的调用权限，请检查模型授权和实名认证';
+    throw new AiRuntimeError(`provider_${kind}`, `${name}${action}。控制台：${destination[provider]}`, {
+        retryable: false, category: 'authentication', providerCode: code, status,
+        providerMessage,
+        scope: kind === 'insufficient_balance' || accountNotVerified ? 'account' : 'model',
+    });
+}

package/dist/providers/siliconflow.js

@@ -1,33 +1,8 @@
 import { AiRuntimeError } from '../runtime/AiRuntimeError.js';
-import { audioBytesToDataUri } from './audio-data.js';
-import { normalizeEndpoint } from './helpers.js';
-import { isJsonObject } from './helpers.js';
-import { fetchProvider } from './provider-fetch.js';
+import { executeOpenAiCompatibleSpeech } from './openai-speech.js';
 const BASE_URL = 'https://api.siliconflow.cn';
 export async function execute(input) {
-    const response = await fetchProvider('SiliconFlow', normalizeEndpoint(BASE_URL, input.route), {
-        method: 'POST',
-        headers: {
-            Authorization: `Bearer ${input.apiKey}`,
-            'Content-Type': 'application/json',
-        },
-        body: JSON.stringify(input.body),
-        signal: input.signal,
-    }, {
-        transport: input.runtime.transport,
-        retryPreconnectOnce: true,
-    });
-    if (!response.ok) {
-        await response.body?.cancel().catch(() => undefined);
-        throw new AiRuntimeError('provider_task_failed', `SiliconFlow speech request failed (HTTP ${response.status})`);
-    }
-    const bytes = new Uint8Array(await response.arrayBuffer());
-    const requestedFormat = isJsonObject(input.body) && typeof input.body.response_format === 'string' ? input.body.response_format : 'mp3';
-    const url = audioBytesToDataUri(bytes, requestedFormat);
-    return {
-        status: 'completed', url,
-        metadata: { contentType: response.headers.get('content-type'), byteLength: bytes.byteLength },
-    };
+    return executeOpenAiCompatibleSpeech('SiliconFlow', BASE_URL, input, 'mp3');
 }
 export async function continuePolling(_input) {
     throw new AiRuntimeError('unsupported_provider', 'SiliconFlow speech response is synchronous');