ai-world-sdk 1.5.8 → 1.5.10

package/dist/__tests__/llm.real.test.js

@@ -45,6 +45,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 const dotenv = __importStar(require("dotenv"));
 const llm_1 = require("../llm");
+const image_1 = require("../image");
 const config_1 = require("../config");
 const ai_1 = require("ai");
 // 加载环境变量
@@ -214,17 +215,17 @@ describe("llm.ts — 真实集成测试（文本 + 图像）", () => {
     // ============================================================
     // createProvider + generateImage（kunpo 图像生成）
     // ============================================================
-    describe("createProvider + generateImage（kunpo 图像）", () => {
+    describe("generateKunpoImage（kunpo 图像）", () => {
         const promptArg = "A simple red circle on a white background";
-        test("kunpo — openai/gpt-5.4-image-2", async () => {
-            const modelId = process.env.KUNPO_IMAGE_MODEL || "openai/gpt-5.4-image-2";
-            const provider = (0, llm_1.createProvider)("kunpo", "openai", PLUGIN_ID);
-            const imageModel = provider.imageModel(modelId);
-            const result = await (0, ai_1.generateImage)({
-                model: imageModel,
+        test("kunpo — Image-GI2（异步）", async () => {
+            const modelId = process.env.KUNPO_IMAGE_MODEL || "Image-GI2";
+            const result = await (0, image_1.generateKunpoImage)({
+                pluginId: PLUGIN_ID,
+                model: modelId,
                 prompt: promptArg,
-                n: 1,
                 size: "1024x1024",
+                quality: "high",
+                async: true,
             });
             expect(result.images).toBeDefined();
             expect(result.images.length).toBeGreaterThan(0);
@@ -294,9 +295,10 @@ describe("llm.ts — 真实集成测试（文本 + 图像）", () => {
             const provider = (0, llm_1.createProvider)("api2img", "openai", "test");
             expect(typeof provider.languageModel).toBe("function");
         });
-        test("kunpo provider 实例有 imageModel 方法", () => {
-            const provider = (0, llm_1.createProvider)("kunpo", "openai", "test");
-            expect(typeof provider.imageModel).toBe("function");
+        test("getImageProxyConfig 返回 /api/llm/image 代理地址", () => {
+            const { getImageProxyConfig } = require("../image");
+            const cfg = getImageProxyConfig("test");
+            expect(cfg.baseUrl).toContain("/api/llm/image");
         });
     });
 });

package/dist/cli/commands/image.js

@@ -36,9 +36,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerImageCommands = registerImageCommands;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const ai_1 = require("ai");
 const index_1 = require("../../index");
-const config_1 = require("../config");
+const config_1 = require("../../config");
+const config_2 = require("../config");
 const output_1 = require("../output");
 const utils_1 = require("../utils");
 function collectOpts(cmd) {
@@ -63,22 +63,86 @@ function stripB64ForLog(obj) {
     }
     return copy;
 }
+async function downloadUrlToFile(url, outputPath) {
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`下载图像失败: ${res.status}`);
+    }
+    const abs = path.resolve(outputPath);
+    const dir = path.dirname(abs);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(abs, Buffer.from(await res.arrayBuffer()));
+}
+/** OpenAI 图像：经 /api/llm/openai 代理（HTTP，非 AI SDK） */
+async function generateOpenAIImageViaProxy(pluginId, model, prompt, size) {
+    const serverUrl = config_1.sdkConfig.getServerUrl() || '';
+    const token = config_1.sdkConfig.getToken() || '';
+    const body = {
+        model,
+        prompt,
+        n: 1,
+        response_format: 'b64_json',
+    };
+    if (size)
+        body.size = size;
+    const res = await fetch(`${serverUrl}/api/llm/openai/images/generations`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-Plugin-Id': pluginId,
+            'X-Provider': 'api2img',
+            Authorization: `Bearer ${token}`,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        throw new Error(`OpenAI 图像生成失败: ${res.status} ${text}`);
+    }
+    const json = (await res.json());
+    const first = json.data?.[0];
+    if (!first) {
+        throw new Error('OpenAI 图像生成响应无数据');
+    }
+    if (first.b64_json) {
+        const buf = Buffer.from(first.b64_json, 'base64');
+        return { uint8Array: new Uint8Array(buf), mediaType: 'image/png' };
+    }
+    if (first.url) {
+        const imgRes = await fetch(first.url);
+        if (!imgRes.ok) {
+            throw new Error(`下载图像失败: ${imgRes.status}`);
+        }
+        const buf = Buffer.from(await imgRes.arrayBuffer());
+        return {
+            uint8Array: new Uint8Array(buf),
+            mediaType: imgRes.headers.get('content-type') || 'image/png',
+            url: first.url,
+        };
+    }
+    throw new Error('OpenAI 图像生成响应无 url 或 b64_json');
+}
 function registerImageCommands(program) {
-    const image = program.command('image').description('图像生成（doubao / gemini / openai）');
+    const image = program
+        .command('image')
+        .description('图像生成（doubao / gemini / openai / kunpo）');
     image
         .command('generate')
-        .requiredOption('--provider <name>', 'doubao, gemini, or openai')
+        .requiredOption('--provider <name>', 'doubao, gemini, openai, or kunpo')
         .requiredOption('--prompt <text>', 'Prompt text')
         .option('--model <id>', 'Model id')
-        .option('--size <value>', 'Size (provider-specific)')
+        .option('--size <value>', 'Size e.g. 1024x1024, 1536x1024')
+        .option('--quality <value>', 'KUNPO quality: low, standard, medium, high, hd')
+        .option('--sync', 'KUNPO: use sync /images/generations (not recommended)')
         .option('--output <file>', 'Write first image to file')
-        .option('--plugin-id <id>', 'Plugin id (required for openai)')
+        .option('--plugin-id <id>', 'Plugin id (required for openai / kunpo)')
         .action(async (options, cmd) => {
         const commandName = 'image generate';
         try {
             void (0, utils_1.getFormat)(program);
             const o = collectOpts(cmd);
-            const auth = (0, config_1.resolveAuth)({
+            const auth = (0, config_2.resolveAuth)({
                 baseUrl: o.baseUrl,
                 token: o.token,
                 pluginId: options.pluginId ??
@@ -88,8 +152,8 @@ function registerImageCommands(program) {
             (0, utils_1.requireOption)(options.prompt, 'prompt');
             (0, utils_1.requireOption)(options.provider, 'provider');
             const providerName = options.provider.toLowerCase();
-            if (!['doubao', 'gemini', 'openai'].includes(providerName)) {
-                const err = new Error('缺少必需参数: --provider 必须是 doubao、gemini 或 openai');
+            if (!['doubao', 'gemini', 'openai', 'kunpo'].includes(providerName)) {
+                const err = new Error('缺少必需参数: --provider 必须是 doubao、gemini、openai 或 kunpo');
                 err.code = 'VALIDATION_ERROR';
                 throw err;
             }
@@ -106,15 +170,7 @@ function registerImageCommands(program) {
                         (0, utils_1.writeOutputFile)(options.output, Buffer.from(first.b64_json, 'base64'));
                     }
                     else if (first?.url) {
-                        const abs = path.resolve(options.output);
-                        const dir = path.dirname(abs);
-                        if (!fs.existsSync(dir))
-                            fs.mkdirSync(dir, { recursive: true });
-                        const res = await fetch(first.url);
-                        if (!res.ok) {
-                            throw new Error(`下载图像失败: ${res.status}`);
-                        }
-                        fs.writeFileSync(abs, Buffer.from(await res.arrayBuffer()));
+                        await downloadUrlToFile(first.url, options.output);
                     }
                 }
                 (0, output_1.outputJSON)(options.output ? stripB64ForLog({ ...result, savedTo: options.output }) : result);
@@ -136,15 +192,7 @@ function registerImageCommands(program) {
                         (0, utils_1.writeOutputFile)(options.output, Buffer.from(first.b64_json, 'base64'));
                     }
                     else if (first?.url) {
-                        const abs = path.resolve(options.output);
-                        const dir = path.dirname(abs);
-                        if (!fs.existsSync(dir))
-                            fs.mkdirSync(dir, { recursive: true });
-                        const res = await fetch(first.url);
-                        if (!res.ok) {
-                            throw new Error(`下载图像失败: ${res.status}`);
-                        }
-                        fs.writeFileSync(abs, Buffer.from(await res.arrayBuffer()));
+                        await downloadUrlToFile(first.url, options.output);
                     }
                 }
                 (0, output_1.outputJSON)(options.output ? stripB64ForLog({ ...result, savedTo: options.output }) : result);
@@ -155,28 +203,83 @@ function registerImageCommands(program) {
                 auth.pluginId;
             (0, utils_1.requireOption)(pluginId, 'plugin-id');
             (0, utils_1.initSDK)({ ...auth, pluginId });
-            const provider = (0, index_1.createProvider)('api2img', 'openai', pluginId);
-            const modelId = options.model || 'dall-e-3';
-            const genOpts = {
-                model: provider.imageModel(modelId),
-                prompt: options.prompt,
-                n: 1,
-            };
-            if (options.size) {
-                genOpts.size = options.size;
+            if (providerName === 'kunpo') {
+                const modelId = options.model || 'Image-GI2';
+                const useSync = Boolean(options.sync);
+                if (useSync) {
+                    const body = {
+                        model: modelId,
+                        prompt: options.prompt,
+                        response_format: 'b64_json',
+                        n: 1,
+                    };
+                    if (options.size && /^\d+x\d+$|auto/.test(options.size)) {
+                        body.size = options.size;
+                    }
+                    if (options.quality) {
+                        body.quality = options.quality;
+                    }
+                    const resp = await (0, index_1.generateImageSync)(pluginId, body);
+                    const first = resp.data?.[0];
+                    if (options.output && first?.b64_json) {
+                        (0, utils_1.writeOutputFile)(options.output, Buffer.from(first.b64_json, 'base64'));
+                    }
+                    else if (options.output && first?.url) {
+                        await downloadUrlToFile(first.url, options.output);
+                    }
+                    (0, output_1.outputJSON)({
+                        provider: 'kunpo',
+                        model: modelId,
+                        mode: 'sync',
+                        proxy: (0, index_1.getImageProxyConfig)(pluginId).baseUrl,
+                        savedTo: options.output || undefined,
+                        data: resp.data?.map((d) => ({
+                            ...d,
+                            b64_json: d.b64_json ? '[omitted]' : undefined,
+                        })),
+                    });
+                    return;
+                }
+                const kunpoOpts = {
+                    pluginId: pluginId,
+                    model: modelId,
+                    prompt: options.prompt,
+                    async: true,
+                };
+                if (options.size && /^\d+x\d+$|auto/.test(options.size)) {
+                    kunpoOpts.size = options.size;
+                }
+                if (options.quality) {
+                    kunpoOpts.quality = options.quality;
+                }
+                const imgResult = await (0, index_1.generateKunpoImage)(kunpoOpts);
+                const first = imgResult.images[0];
+                if (options.output && first) {
+                    (0, utils_1.writeOutputFile)(options.output, Buffer.from(first.uint8Array));
+                }
+                (0, output_1.outputJSON)({
+                    provider: 'kunpo',
+                    model: modelId,
+                    mode: 'async',
+                    taskId: imgResult.taskId,
+                    resultUrl: imgResult.resultUrl,
+                    mediaType: first?.mediaType,
+                    savedTo: options.output || undefined,
+                });
+                return;
             }
-            const imgResult = await (0, ai_1.generateImage)(genOpts);
-            const first = imgResult.images[0];
-            if (options.output && first) {
-                (0, utils_1.writeOutputFile)(options.output, Buffer.from(first.uint8Array));
+            // openai：/api/llm/openai 代理 HTTP
+            const modelId = options.model || 'dall-e-3';
+            const img = await generateOpenAIImageViaProxy(pluginId, modelId, options.prompt, options.size);
+            if (options.output) {
+                (0, utils_1.writeOutputFile)(options.output, Buffer.from(img.uint8Array));
             }
             (0, output_1.outputJSON)({
                 provider: 'openai',
                 model: modelId,
-                mediaType: first?.mediaType,
+                mediaType: img.mediaType,
+                url: img.url,
                 savedTo: options.output || undefined,
-                usage: imgResult.usage,
-                warnings: imgResult.warnings,
             });
         }
         catch (err) {

package/dist/cli/commands/plugin-token.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerPluginTokenCommands(program: Command): void;

package/dist/cli/commands/plugin-token.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPluginTokenCommands = registerPluginTokenCommands;
+const config_1 = require("../config");
+const output_1 = require("../output");
+const utils_1 = require("../utils");
+function collectOpts(cmd) {
+    const chain = [];
+    for (let c = cmd; c; c = c.parent)
+        chain.unshift(c);
+    const o = {};
+    for (const c of chain)
+        Object.assign(o, c.opts());
+    return o;
+}
+function resolveAndInit(cmd) {
+    const o = collectOpts(cmd);
+    const auth = (0, config_1.resolveAuth)({
+        baseUrl: o.baseUrl,
+        token: o.token,
+        pluginId: o.pluginId,
+    });
+    (0, utils_1.initSDK)(auth);
+    return o;
+}
+function parsePositiveInt(raw, flag) {
+    if (raw == null || raw === '')
+        return undefined;
+    const n = parseInt(raw, 10);
+    if (!Number.isFinite(n)) {
+        const err = new Error(`无效的 ${flag}: ${raw}`);
+        err.code = 'VALIDATION_ERROR';
+        throw err;
+    }
+    return n;
+}
+function registerPluginTokenCommands(program) {
+    const pt = program.command('plugin-token').description('插件 Token 管理（需管理员权限）');
+    pt.command('list')
+        .description('列出插件 Token')
+        .option('--plugin-id <id>', '按插件 ID 过滤')
+        .option('--active', '仅显示启用')
+        .option('--inactive', '仅显示停用')
+        .option('--page <n>', '页码')
+        .option('--page-size <n>', '每页条数')
+        .action(async (opts, cmd) => {
+        try {
+            const o = resolveAndInit(cmd);
+            const { PluginTokenClient } = require('../../plugin-token');
+            const client = new PluginTokenClient();
+            const isActive = opts.active ? true : opts.inactive ? false : undefined;
+            const result = await client.list({
+                pluginId: opts.pluginId,
+                isActive,
+                page: parsePositiveInt(opts.page, '--page') || 1,
+                pageSize: parsePositiveInt(opts.pageSize, '--page-size') || 20,
+            });
+            (0, output_1.output)(result, (0, utils_1.getFormat)(program));
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, 'plugin-token list');
+        }
+    });
+    pt.command('create')
+        .description('创建插件 Token')
+        .requiredOption('--plugin-id <id>', '插件 ID')
+        .requiredOption('--name <name>', 'Token 名称')
+        .requiredOption('--role-id <id>', '角色 ID')
+        .option('--description <desc>', '描述')
+        .option('--expires <date>', '过期时间 (ISO 8601)')
+        .action(async (opts, cmd) => {
+        try {
+            resolveAndInit(cmd);
+            const { PluginTokenClient } = require('../../plugin-token');
+            const client = new PluginTokenClient();
+            const result = await client.create({
+                plugin_id: opts.pluginId,
+                name: opts.name,
+                role_id: Number(opts.roleId),
+                description: opts.description,
+                expires_at: opts.expires,
+            });
+            (0, output_1.output)(result, (0, utils_1.getFormat)(program));
+            console.error(`\n⚠️  Token 仅显示一次，请妥善保存: ${result.token}`);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, 'plugin-token create');
+        }
+    });
+    pt.command('get')
+        .argument('<id>', 'Token ID')
+        .description('获取插件 Token 详情')
+        .action(async (idArg, _opts, cmd) => {
+        try {
+            resolveAndInit(cmd);
+            const { PluginTokenClient } = require('../../plugin-token');
+            const client = new PluginTokenClient();
+            const result = await client.get(Number(idArg));
+            (0, output_1.output)(result, (0, utils_1.getFormat)(program));
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, 'plugin-token get');
+        }
+    });
+    pt.command('update')
+        .argument('<id>', 'Token ID')
+        .description('更新插件 Token')
+        .option('--name <name>', '名称')
+        .option('--description <desc>', '描述')
+        .option('--role-id <id>', '角色 ID')
+        .option('--expires <date>', '过期时间 (ISO 8601)')
+        .action(async (idArg, opts, cmd) => {
+        try {
+            resolveAndInit(cmd);
+            const { PluginTokenClient } = require('../../plugin-token');
+            const client = new PluginTokenClient();
+            const data = {};
+            if (opts.name != null)
+                data.name = opts.name;
+            if (opts.description != null)
+                data.description = opts.description;
+            if (opts.roleId != null)
+                data.role_id = Number(opts.roleId);
+            if (opts.expires != null)
+                data.expires_at = opts.expires;
+            const result = await client.update(Number(idArg), data);
+            (0, output_1.output)(result, (0, utils_1.getFormat)(program));
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, 'plugin-token update');
+        }
+    });
+    pt.command('delete')
+        .argument('<id>', 'Token ID')
+        .description('删除插件 Token')
+        .action(async (idArg, _opts, cmd) => {
+        try {
+            resolveAndInit(cmd);
+            const { PluginTokenClient } = require('../../plugin-token');
+            const client = new PluginTokenClient();
+            await client.delete(Number(idArg));
+            (0, output_1.output)({ deleted: true, id: Number(idArg) }, (0, utils_1.getFormat)(program));
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, 'plugin-token delete');
+        }
+    });
+    pt.command('regenerate')
+        .argument('<id>', 'Token ID')
+        .description('重新生成 Token（旧 Token 立即失效）')
+        .action(async (idArg, _opts, cmd) => {
+        try {
+            resolveAndInit(cmd);
+            const { PluginTokenClient } = require('../../plugin-token');
+            const client = new PluginTokenClient();
+            const result = await client.regenerate(Number(idArg));
+            (0, output_1.output)(result, (0, utils_1.getFormat)(program));
+            console.error(`\n⚠️  新 Token 仅显示一次: ${result.token}`);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, 'plugin-token regenerate');
+        }
+    });
+    pt.command('toggle')
+        .argument('<id>', 'Token ID')
+        .description('切换启用/停用状态')
+        .action(async (idArg, _opts, cmd) => {
+        try {
+            resolveAndInit(cmd);
+            const { PluginTokenClient } = require('../../plugin-token');
+            const client = new PluginTokenClient();
+            const result = await client.toggle(Number(idArg));
+            const status = result.is_active ? '已启用' : '已停用';
+            console.error(`Token #${idArg} ${status}`);
+            (0, output_1.output)(result, (0, utils_1.getFormat)(program));
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, 'plugin-token toggle');
+        }
+    });
+}

package/dist/cli/index.js

@@ -104,6 +104,7 @@ const stats_1 = require("./commands/stats");
 const ai_config_1 = require("./commands/ai-config");
 const shared_1 = require("./commands/shared");
 const chrome_1 = require("./commands/chrome");
+const plugin_token_1 = require("./commands/plugin-token");
 (0, help_1.registerHelpCommand)(program);
 (0, version_1.registerVersionCommand)(program);
 (0, auth_1.registerAuthCommands)(program);
@@ -121,6 +122,7 @@ const chrome_1 = require("./commands/chrome");
 (0, ai_config_1.registerAiConfigCommands)(program);
 (0, shared_1.registerSharedCommands)(program);
 (0, chrome_1.registerChromeCommands)(program);
+(0, plugin_token_1.registerPluginTokenCommands)(program);
 program.parseAsync(process.argv).catch((err) => {
     (0, utils_1.handleError)(err, process.argv.slice(2).join(' '));
 });

package/dist/config.d.ts

@@ -9,7 +9,7 @@
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.8";
+export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.10";
 /**
  * 版本兼容性错误
  */
@@ -35,8 +35,8 @@ declare class SDKConfig {
     private _authCheckPromise;
     private _currentUser;
     private _cliMode;
-    readonly sdkSignature = "AI_WORLD_SDK_V:1.5.8";
-    readonly sdkVersion = "1.5.8";
+    readonly sdkSignature = "AI_WORLD_SDK_V:1.5.10";
+    readonly sdkVersion = "1.5.10";
     constructor();
     /**
      * Set global base URL

package/dist/config.js

@@ -7,7 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.sdkConfig = exports.VersionCompatibilityError = exports.SDK_SIGNATURE = void 0;
 // SDK 版本号（构建时自动从 package.json 更新）
 // 此版本号会在运行 npm run build 时自动从 package.json 读取并更新
-const SDK_VERSION = "1.5.8";
+const SDK_VERSION = "1.5.10";
 /**
  * SDK 特征码 - 用于在构建后的 JS 文件中识别 SDK 版本
  * 格式: AI_WORLD_SDK_V:版本号
@@ -15,7 +15,7 @@ const SDK_VERSION = "1.5.8";
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.8";
+exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.10";
 /**
  * 版本兼容性错误
  */

package/dist/image.d.ts

@@ -0,0 +1,93 @@
+/** 腾讯 AIART 支持的模型 */
+export type KunpoTencentImageModel = "Image-GI" | "Image-GI2" | "Image-GPT2";
+/** OpenAI Images 兼容的 quality（GI 映射分辨率，GPT 映射质量档位） */
+export type KunpoImageQuality = "low" | "standard" | "medium" | "high" | "hd";
+export type KunpoInputFidelity = "high" | "low";
+export type KunpoResponseFormat = "url" | "b64_json";
+export interface KunpoImageGenerationOptions {
+    pluginId: string;
+    model: KunpoTencentImageModel | string;
+    prompt: string;
+    /** 默认 true：POST /images/tasks + 轮询 */
+    async?: boolean;
+    /** 图片数量，默认 1 */
+    n?: number;
+    /** 图片宽高，默认 auto：自动根据模型和质量生成 */
+    size?: `${number}x${number}` | "auto";
+    quality?: KunpoImageQuality;
+    responseFormat?: KunpoResponseFormat;
+    /** 图生图参考图 URL 数组 */
+    images?: string[];
+    /** 图生图 */
+    image?: string;
+    background?: string;
+    outputFormat?: "png";
+    inputFidelity?: KunpoInputFidelity;
+    seed?: number;
+    maxRetries?: number;
+    abortSignal?: AbortSignal;
+    headers?: Record<string, string>;
+    /** 轮询间隔时间，默认 30000ms */
+    pollIntervalMs?: number;
+    /** 轮询超时时间，默认 15 * 60 * 1000ms */
+    pollTimeoutMs?: number;
+}
+export interface GeneratedImageFile {
+    base64: string;
+    uint8Array: Uint8Array;
+    mediaType: string;
+    url?: string;
+}
+export interface KunpoImageGenerationResult {
+    image: GeneratedImageFile;
+    images: GeneratedImageFile[];
+    taskId?: string;
+    resultUrl?: string;
+}
+interface KunpoTaskSubmitResponse {
+    id?: string;
+    task_id?: string;
+    model?: string;
+    status?: string;
+    created_at?: number;
+}
+interface KunpoTaskQueryResponse {
+    code?: string;
+    data?: {
+        task_id?: string;
+        status?: string;
+        result_url?: string;
+        fail_reason?: string;
+    };
+}
+interface OpenAIImageGenerationResponse {
+    created?: number;
+    data?: Array<{
+        url?: string;
+        b64_json?: string;
+        revised_prompt?: string;
+    }>;
+}
+/** 后端图像专用代理 /api/llm/image */
+export declare function getImageProxyConfig(pluginId: string, headers?: Record<string, string>): {
+    baseUrl: string;
+    headers: Record<string, string>;
+};
+export declare function bytesFromUrl(url: string, signal?: AbortSignal): Promise<GeneratedImageFile>;
+/** POST /api/llm/image/images/tasks */
+export declare function submitImageTask(pluginId: string, body: Record<string, unknown>, signal?: AbortSignal, headers?: Record<string, string>): Promise<KunpoTaskSubmitResponse>;
+/** GET /api/llm/image/images/tasks/:taskId */
+export declare function getImageTask(pluginId: string, taskId: string, signal?: AbortSignal, headers?: Record<string, string>): Promise<KunpoTaskQueryResponse>;
+/** POST /api/llm/image/images/generations（同步，不推荐生产使用） */
+export declare function generateImageSync(pluginId: string, body: Record<string, unknown>, signal?: AbortSignal, headers?: Record<string, string>): Promise<OpenAIImageGenerationResponse>;
+export declare function pollImageTask(pluginId: string, taskId: string, options?: {
+    pollIntervalMs?: number;
+    pollTimeoutMs?: number;
+    abortSignal?: AbortSignal;
+    headers?: Record<string, string>;
+}): Promise<string>;
+/**
+ * 通过后端 /api/llm/image 代理生成图像（默认异步）
+ */
+export declare function generateKunpoImage(options: KunpoImageGenerationOptions): Promise<KunpoImageGenerationResult>;
+export {};