@maiyunnet/kebab 8.0.6 → 8.1.0

package/doc/kebab-rag.md

@@ -1385,7 +1385,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"8.0.6"` = `'8.0.6'`
+> `const` **VER**: `"8.1.0"` = `'8.1.0'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -1432,7 +1432,7 @@ lib/ai/classes/Ai.md
 
 # Class: Ai
 
-Defined in: [lib/ai.ts:49](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L49)
+Defined in: [lib/ai.ts:58](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L58)
 
 ## Constructors
 
@@ -1440,7 +1440,7 @@ Defined in: [lib/ai.ts:49](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > **new Ai**(`ctrEtc`, `opt`): `Ai`
 
-Defined in: [lib/ai.ts:56](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L56)
+Defined in: [lib/ai.ts:71](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L71)
 
 #### Parameters
 
@@ -1462,9 +1462,25 @@ Defined in: [lib/ai.ts:56](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > `readonly` **link**: `OpenAI`
 
-Defined in: [lib/ai.ts:52](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L52)
+Defined in: [lib/ai.ts:61](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L61)
+
+openai 原生对象
+
+## Accessors
+
+### service
+
+#### Get Signature
+
+> **get** **service**(): [`ESERVICE`](../enumerations/ESERVICE.md)
+
+Defined in: [lib/ai.ts:143](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L143)
 
-openai 原生对象，建议只读
+获取当前服务商
+
+##### Returns
+
+[`ESERVICE`](../enumerations/ESERVICE.md)
 
 ## Methods
 
@@ -1476,7 +1492,7 @@ openai 原生对象，建议只读
 
 > **chat**(`body`): `Promise`\<`false` \| `APIPromise`\<`ChatCompletion`\>\>
 
-Defined in: [lib/ai.ts:111](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L111)
+Defined in: [lib/ai.ts:148](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L148)
 
 创建非流式对话
 
@@ -1494,7 +1510,7 @@ Defined in: [lib/ai.ts:111](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **chat**(`body`): `Promise`\<`false` \| `APIPromise`\<`Stream`\<`ChatCompletionChunk`\>\>\>
 
-Defined in: [lib/ai.ts:115](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L115)
+Defined in: [lib/ai.ts:152](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L152)
 
 创建流式对话
 
@@ -1514,7 +1530,7 @@ Defined in: [lib/ai.ts:115](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 > **embedding**(`body`): `Promise`\<`false` \| `APIPromise`\<`CreateEmbeddingResponse`\>\>
 
-Defined in: [lib/ai.ts:135](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L135)
+Defined in: [lib/ai.ts:172](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L172)
 
 创建向量
 
@@ -1528,6 +1544,180 @@ Defined in: [lib/ai.ts:135](https://github.com/maiyunnet/kebab/blob/master/lib/a
 
 `Promise`\<`false` \| `APIPromise`\<`CreateEmbeddingResponse`\>\>
 
+***
+
+### image()
+
+> **image**(`opt`): `Promise`\<`false` \| \{ `list`: `object`[]; `request`: `string`; `seed`: `number`; \}\>
+
+Defined in: [lib/ai.ts:186](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L186)
+
+生成图像，不支持 GEMINI、GROK 服务商
+
+#### Parameters
+
+##### opt
+
+###### extend?
+
+`boolean`
+
+模型是否自动优化提示词，默认为 false，但有些服务商可能无效
+
+###### imgs?
+
+`string`[]
+
+参考图，请注意模型是否支持，以及是否支持多张，仅支持 ALICN、ALIAS、VOLCN、VOLAS 服务商
+
+###### model
+
+`string`
+
+###### n?
+
+`number`
+
+###### negative?
+
+`string`
+
+负面提示词，用于引导模型避免生成某些内容
+
+###### prompt
+
+`string`
+
+提示词
+
+###### seed?
+
+`number`
+
+随机种子，默认为随机
+
+###### size
+
+`number`[]
+
+长 x 宽，不同模型要求不同，如 [1664, 928]
+
+#### Returns
+
+`Promise`\<`false` \| \{ `list`: `object`[]; `request`: `string`; `seed`: `number`; \}\>
+
+***
+
+### poll()
+
+> **poll**(`opt`): `Promise`\<`false` \| \{ `add?`: `number`; `end?`: `number`; `error?`: `string`; `start?`: `number`; `status`: `"PENDING"` \| `"RUNNING"` \| `"SUCCEEDED"` \| `"FAILED"` \| `"CANCELED"` \| `"UNKNOWN"`; `task`: `string`; `url?`: `string`; \}\>
+
+Defined in: [lib/ai.ts:534](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L534)
+
+轮询任务
+
+#### Parameters
+
+##### opt
+
+###### task
+
+`string`
+
+###### type
+
+`"video"`
+
+#### Returns
+
+`Promise`\<`false` \| \{ `add?`: `number`; `end?`: `number`; `error?`: `string`; `start?`: `number`; `status`: `"PENDING"` \| `"RUNNING"` \| `"SUCCEEDED"` \| `"FAILED"` \| `"CANCELED"` \| `"UNKNOWN"`; `task`: `string`; `url?`: `string`; \}\>
+
+***
+
+### video()
+
+> **video**(`opt`): `Promise`\<`false` \| \{ `request`: `string`; `seed`: `number`; `status`: `"PENDING"` \| `"RUNNING"` \| `"SUCCEEDED"` \| `"FAILED"` \| `"CANCELED"` \| `"UNKNOWN"`; `task`: `string`; \}\>
+
+Defined in: [lib/ai.ts:366](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L366)
+
+异步生成视频，仅支持 ALICN、ALIAS
+
+#### Parameters
+
+##### opt
+
+###### audio?
+
+`string` \| `boolean`
+
+视频声音，默认 false，true 代表自动配音，字符串代表自定义音频网址
+
+###### duration?
+
+`number`
+
+视频时长，默认 2 秒
+
+###### extend?
+
+`boolean`
+
+模型是否自动优化提示词，默认为 false，但有些服务商可能无效
+
+###### imgs?
+
+`string`[]
+
+###### mode?
+
+`"frame"` \| `"text"` \| `"ref"`
+
+文本(默认)、首尾帧、参考图
+
+###### model
+
+`string`
+
+###### negative?
+
+`string`
+
+负面提示词，用于引导模型避免生成某些内容
+
+###### prompt
+
+`string`
+
+提示词，参考类可用 [I1] 指代图片，如 `[I1] 看向 [I2]`
+
+###### ratio?
+
+`"16:9"` \| `"9:16"` \| `"4:3"` \| `"3:4"` \| `"1:1"` \| `"21:9"`
+
+比例，默认 16:9
+
+###### resolution?
+
+`"480p"` \| `"720p"` \| `"1080p"`
+
+分辨率，默认 720p
+
+###### seed?
+
+`number`
+
+随机种子，默认为随机，范围 0 - 2147483647
+
+###### shot?
+
+`"multi"` \| `"single"`
+
+镜头，默认单镜头 single
+
+#### Returns
+
+`Promise`\<`false` \| \{ `request`: `string`; `seed`: `number`; `status`: `"PENDING"` \| `"RUNNING"` \| `"SUCCEEDED"` \| `"FAILED"` \| `"CANCELED"` \| `"UNKNOWN"`; `task`: `string`; \}\>
+
 lib/ai/enumerations/ESERVICE.md
 ---
 
@@ -1539,7 +1729,7 @@ lib/ai/enumerations/ESERVICE.md
 
 # Enumeration: ESERVICE
 
-Defined in: [lib/ai.ts:18](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L18)
+Defined in: [lib/ai.ts:19](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L19)
 
 服务商定义
 
@@ -1549,7 +1739,7 @@ Defined in: [lib/ai.ts:18](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > **ALIAS**: `1`
 
-Defined in: [lib/ai.ts:22](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L22)
+Defined in: [lib/ai.ts:23](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L23)
 
 阿里国际区
 
@@ -1559,7 +1749,7 @@ Defined in: [lib/ai.ts:22](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > **ALICN**: `0`
 
-Defined in: [lib/ai.ts:20](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L20)
+Defined in: [lib/ai.ts:21](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L21)
 
 阿里中国大陆区
 
@@ -1569,7 +1759,7 @@ Defined in: [lib/ai.ts:20](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > **AZURE**: `2`
 
-Defined in: [lib/ai.ts:24](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L24)
+Defined in: [lib/ai.ts:25](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L25)
 
 微软 Azure
 
@@ -1579,7 +1769,7 @@ Defined in: [lib/ai.ts:24](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > **AZURE2**: `3`
 
-Defined in: [lib/ai.ts:26](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L26)
+Defined in: [lib/ai.ts:27](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L27)
 
 微软 Azure 2
 
@@ -1589,10 +1779,50 @@ Defined in: [lib/ai.ts:26](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > **AZURE3**: `4`
 
-Defined in: [lib/ai.ts:28](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L28)
+Defined in: [lib/ai.ts:29](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L29)
 
 微软 Azure 3
 
+***
+
+### GEMINI
+
+> **GEMINI**: `5`
+
+Defined in: [lib/ai.ts:31](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L31)
+
+Gemini
+
+***
+
+### GROK
+
+> **GROK**: `6`
+
+Defined in: [lib/ai.ts:33](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L33)
+
+Grok
+
+***
+
+### VOLAS
+
+> **VOLAS**: `8`
+
+Defined in: [lib/ai.ts:37](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L37)
+
+火山引擎国际区
+
+***
+
+### VOLCN
+
+> **VOLCN**: `7`
+
+Defined in: [lib/ai.ts:35](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L35)
+
+火山引擎中国大陆区
+
 lib/ai/functions/get.md
 ---
 
@@ -1606,7 +1836,7 @@ lib/ai/functions/get.md
 
 > **get**(`ctrEtc`, `opt`): [`Ai`](../classes/Ai.md)
 
-Defined in: [lib/ai.ts:154](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L154)
+Defined in: [lib/ai.ts:589](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L589)
 
 创建一个 AI 对象
 
@@ -1664,7 +1894,7 @@ lib/ai/interfaces/IOptions.md
 
 # Interface: IOptions
 
-Defined in: [lib/ai.ts:32](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L32)
+Defined in: [lib/ai.ts:41](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L41)
 
 选项
 
@@ -1674,7 +1904,7 @@ Defined in: [lib/ai.ts:32](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > `optional` **endpoint**: `string`
 
-Defined in: [lib/ai.ts:36](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L36)
+Defined in: [lib/ai.ts:45](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L45)
 
 接入点
 
@@ -1684,7 +1914,7 @@ Defined in: [lib/ai.ts:36](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > `optional` **fetch**: (`input`, `init?`) => `Promise`\<`Response`\>
 
-Defined in: [lib/ai.ts:40](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L40)
+Defined in: [lib/ai.ts:49](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L49)
 
 自定义 fetch 函数
 
@@ -1708,7 +1938,7 @@ Defined in: [lib/ai.ts:40](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > `optional` **secretKey**: `string`
 
-Defined in: [lib/ai.ts:38](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L38)
+Defined in: [lib/ai.ts:47](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L47)
 
 密钥
 
@@ -1718,7 +1948,7 @@ Defined in: [lib/ai.ts:38](https://github.com/maiyunnet/kebab/blob/master/lib/ai
 
 > **service**: [`ESERVICE`](../enumerations/ESERVICE.md)
 
-Defined in: [lib/ai.ts:34](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L34)
+Defined in: [lib/ai.ts:43](https://github.com/maiyunnet/kebab/blob/master/lib/ai.ts#L43)
 
 服务商 -
 

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "8.0.6";
+export declare const VER = "8.1.0";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 export declare const LIB_PATH: string;

package/index.js

@@ -6,7 +6,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export const VER = '8.0.6';
+export const VER = '8.1.0';
 // --- 服务端用的路径 ---
 const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */

package/lib/ai.d.ts

@@ -22,7 +22,15 @@ export declare enum ESERVICE {
     /** --- 微软 Azure 2 --- */
     'AZURE2' = 3,
     /** --- 微软 Azure 3 --- */
-    'AZURE3' = 4
+    'AZURE3' = 4,
+    /** --- Gemini --- */
+    'GEMINI' = 5,
+    /** --- Grok --- */
+    'GROK' = 6,
+    /** --- 火山引擎中国大陆区 --- */
+    'VOLCN' = 7,
+    /** --- 火山引擎国际区 --- */
+    'VOLAS' = 8
 }
 /** --- 选项 --- */
 export interface IOptions {
@@ -36,16 +44,97 @@ export interface IOptions {
     'fetch'?: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 }
 export declare class Ai {
-    /** --- openai 原生对象，建议只读 --- */
+    /** --- openai 原生对象 --- */
     readonly link: openai.OpenAI;
+    private readonly _fetch;
+    private readonly _service;
+    private readonly _endpoint;
     private readonly _ctr?;
     constructor(ctrEtc: sCtr.Ctr | kebab.IConfigAi, opt: IOptions);
+    /** --- 获取当前服务商 --- */
+    get service(): ESERVICE;
     /** --- 创建非流式对话 --- */
     chat(body: openai.default.Chat.Completions.ChatCompletionCreateParamsNonStreaming): Promise<openai.APIPromise<openai.default.Chat.ChatCompletion> | false>;
     /** --- 创建流式对话 --- */
     chat(body: openai.default.Chat.Completions.ChatCompletionCreateParamsStreaming): Promise<openai.APIPromise<streaming.Stream<openai.default.Chat.ChatCompletionChunk>> | false>;
     /** --- 创建向量 --- */
     embedding(body: openai.default.EmbeddingCreateParams): Promise<openai.APIPromise<openai.default.CreateEmbeddingResponse> | false>;
+    /** --- 生成图像，不支持 GEMINI、GROK 服务商 --- */
+    image(opt: {
+        'model': string;
+        /** --- 提示词 --- */
+        'prompt': string;
+        /** --- 参考图，请注意模型是否支持，以及是否支持多张，仅支持 ALICN、ALIAS、VOLCN、VOLAS 服务商 --- */
+        'imgs'?: string[];
+        /** --- 模型是否自动优化提示词，默认为 false，但有些服务商可能无效 --- */
+        'extend'?: boolean;
+        /** --- 负面提示词，用于引导模型避免生成某些内容 --- */
+        'negative'?: string;
+        /** --- 长 x 宽，不同模型要求不同，如 [1664, 928] --- */
+        'size': number[];
+        'n'?: number;
+        /** --- 随机种子，默认为随机 --- */
+        'seed'?: number;
+    }): Promise<{
+        /** --- 图像列表 --- */
+        'list': Array<{
+            'url': string;
+            /** --- 优化后的提示词 --- */
+            'text': string;
+        }>;
+        /** --- 随机种子 --- */
+        'seed': number;
+        /** --- 请求编号 --- */
+        'request': string;
+    } | false>;
+    /** --- 异步生成视频，仅支持 ALICN、ALIAS --- */
+    video(opt: {
+        'model': string;
+        /** --- 提示词，参考类可用 [I1] 指代图片，如 `[I1] 看向 [I2]` --- */
+        'prompt': string;
+        /** --- 文本(默认)、首尾帧、参考图 --- */
+        'mode'?: 'text' | 'frame' | 'ref';
+        'imgs'?: string[];
+        /** --- 负面提示词，用于引导模型避免生成某些内容 --- */
+        'negative'?: string;
+        /** --- 模型是否自动优化提示词，默认为 false，但有些服务商可能无效 --- */
+        'extend'?: boolean;
+        /** --- 分辨率，默认 720p --- */
+        'resolution'?: '480p' | '720p' | '1080p';
+        /** --- 比例，默认 16:9 --- */
+        'ratio'?: '16:9' | '9:16' | '4:3' | '3:4' | '1:1' | '21:9';
+        /** --- 视频时长，默认 2 秒 --- */
+        'duration'?: number;
+        /** --- 镜头，默认单镜头 single --- */
+        'shot'?: 'single' | 'multi';
+        /** --- 视频声音，默认 false，true 代表自动配音，字符串代表自定义音频网址 --- */
+        'audio'?: boolean | string;
+        /** --- 随机种子，默认为随机，范围 0 - 2147483647 --- */
+        'seed'?: number;
+    }): Promise<{
+        'task': string;
+        'status': 'PENDING' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELED' | 'UNKNOWN';
+        'seed': number;
+        'request': string;
+    } | false>;
+    /** --- 轮询任务 --- */
+    poll(opt: {
+        'type': 'video';
+        'task': string;
+    }): Promise<{
+        'task': string;
+        'status': 'PENDING' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELED' | 'UNKNOWN';
+        /** --- 任务提交时间 --- */
+        'add'?: number;
+        /** --- 任务开始时间 --- */
+        'start'?: number;
+        /** --- 任务结束时间 --- */
+        'end'?: number;
+        /** --- 文件地址 --- */
+        'url'?: string;
+        /** --- 错误信息，成功时不返回 --- */
+        'error'?: string;
+    } | false>;
 }
 /**
  * --- 创建一个 AI 对象 ---

package/lib/ai.js

@@ -5,6 +5,7 @@
  */
 import * as openai from 'openai';
 import * as lCore from '#kebab/lib/core.js';
+import * as lText from '#kebab/lib/text.js';
 import * as sCtr from '#kebab/sys/ctr.js';
 /**
  * --- 参考：https://help.aliyun.com/zh/model-studio/what-is-model-studio ---
@@ -23,12 +24,23 @@ export var ESERVICE;
     ESERVICE[ESERVICE["AZURE2"] = 3] = "AZURE2";
     /** --- 微软 Azure 3 --- */
     ESERVICE[ESERVICE["AZURE3"] = 4] = "AZURE3";
+    /** --- Gemini --- */
+    ESERVICE[ESERVICE["GEMINI"] = 5] = "GEMINI";
+    /** --- Grok --- */
+    ESERVICE[ESERVICE["GROK"] = 6] = "GROK";
+    /** --- 火山引擎中国大陆区 --- */
+    ESERVICE[ESERVICE["VOLCN"] = 7] = "VOLCN";
+    /** --- 火山引擎国际区 --- */
+    ESERVICE[ESERVICE["VOLAS"] = 8] = "VOLAS";
 })(ESERVICE || (ESERVICE = {}));
 /** --- openai 的连接对象 --- */
 const links = [];
 export class Ai {
-    /** --- openai 原生对象，建议只读 --- */
+    /** --- openai 原生对象 --- */
     link;
+    _fetch;
+    _service;
+    _endpoint;
     _ctr;
     constructor(ctrEtc, opt) {
         let configAi = null;
@@ -41,6 +53,7 @@ export class Ai {
             configAi = ctrEtc;
         }
         const secretKey = opt.secretKey ?? configAi.skey ?? '';
+        const token = `${opt.service}-${secretKey}`;
         let endpoint;
         switch (opt.service) {
             case ESERVICE.ALICN: {
@@ -59,16 +72,32 @@ export class Ai {
                 endpoint = opt.endpoint ?? configAi.endpoint ?? '';
                 break;
             }
-            case ESERVICE.AZURE3: {
-                endpoint = opt.endpoint ?? configAi.endpoint ?? '';
+            case ESERVICE.GEMINI: {
+                endpoint = opt.endpoint ?? `https://generativelanguage.googleapis.com/v1beta/openai/`;
+                break;
+            }
+            case ESERVICE.GROK: {
+                endpoint = opt.endpoint ?? `https://api.x.ai/v1`;
+                break;
+            }
+            case ESERVICE.VOLCN: {
+                endpoint = opt.endpoint ?? `https://ark.cn-beijing.volces.com/api/v3`;
+                break;
+            }
+            case ESERVICE.VOLAS: {
+                endpoint = opt.endpoint ?? `https://ark.ap-southeast.bytepluses.com/api/v3`;
                 break;
             }
             default: {
-                endpoint = undefined;
+                // --- ESERVICE.AZURE3 ---
+                endpoint = opt.endpoint ?? configAi.endpoint ?? '';
             }
         }
-        const token = `${opt.service}-${secretKey}`;
-        const link = links.find((item) => item.token === token);
+        this._fetch = opt.fetch ?? fetch;
+        this._service = opt.service;
+        this._endpoint = endpoint;
+        // --- 处理连接 ---
+        const link = links.find(item => item.token === token);
         if (link) {
             this.link = link.link;
             return;
@@ -83,6 +112,10 @@ export class Ai {
             'link': this.link,
         });
     }
+    /** --- 获取当前服务商 --- */
+    get service() {
+        return this._service;
+    }
     /** --- 创建对话 --- */
     async chat(body) {
         try {
@@ -105,6 +138,327 @@ export class Ai {
             return false;
         }
     }
+    /** --- 生成图像，不支持 GEMINI、GROK 服务商 --- */
+    async image(opt) {
+        const seed = opt.seed ?? lCore.rand(0, 2147483647);
+        switch (this._service) {
+            case ESERVICE.ALICN:
+            case ESERVICE.ALIAS: {
+                try {
+                    const res = await this._fetch(`https://dashscope${this._service === ESERVICE.ALIAS ? '-intl' : ''}.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation`, {
+                        'method': 'POST',
+                        'headers': {
+                            'authorization': `Bearer ${this.link.apiKey}`,
+                            'content-type': 'application/json',
+                        },
+                        'body': lText.stringifyJson({
+                            'model': opt.model,
+                            'input': {
+                                'messages': [
+                                    {
+                                        'role': 'user',
+                                        'content': [
+                                            ...(opt.imgs?.map(url => ({
+                                                'image': url,
+                                            })) ?? []),
+                                            {
+                                                'text': opt.prompt,
+                                            }
+                                        ]
+                                    }
+                                ]
+                            },
+                            'parameters': {
+                                'negative_prompt': opt.negative ?? ' ',
+                                'prompt_extend': opt.extend ?? false,
+                                'watermark': false,
+                                'size': `${opt.size[0]}*${opt.size[1]}`,
+                                'n': opt.n ?? 1,
+                                'seed': seed,
+                            },
+                        }),
+                    });
+                    const json = await res.json();
+                    if (!json.output?.choices?.[0]) {
+                        lCore.debug('[AI][IMAGE]', json);
+                        lCore.log(this._ctr ?? {}, `[AI][IMAGE] ${lText.stringifyJson(json)}`, '-error');
+                        return false;
+                    }
+                    return {
+                        'list': json.output.choices[0].message.content.filter((item) => item.image).map((item) => {
+                            const content = json.output.choices[0].message.content;
+                            const itemIndex = content.indexOf(item);
+                            return {
+                                'url': item.image,
+                                'text': content[itemIndex + 1]?.text ?? '',
+                            };
+                        }),
+                        'seed': seed,
+                        'request': json.request_id,
+                    };
+                }
+                catch (e) {
+                    lCore.debug('[AI][IMAGE]', e);
+                    lCore.log(this._ctr ?? {}, `[AI][IMAGE] ${e.message}`, '-error');
+                    return false;
+                }
+            }
+            case ESERVICE.AZURE:
+            case ESERVICE.AZURE2:
+            case ESERVICE.AZURE3: {
+                try {
+                    const json = await this.link.images.generate({
+                        'model': opt.model,
+                        'prompt': opt.prompt,
+                        'size': `${opt.size[0]}x${opt.size[1]}`,
+                        'n': opt.n ?? 1,
+                    });
+                    if (!json.data?.[0]) {
+                        lCore.debug('[AI][IMAGE]', json);
+                        lCore.log(this._ctr ?? {}, `[AI][IMAGE] ${lText.stringifyJson(json)}`, '-error');
+                        return false;
+                    }
+                    return {
+                        'list': json.data.map((item) => ({
+                            'url': item.url ?? item.b64_json,
+                            'text': item.revised_prompt ?? opt.prompt,
+                        })),
+                        'seed': seed,
+                        'request': json.created.toString(),
+                    };
+                }
+                catch (e) {
+                    lCore.debug('[AI][IMAGE]', e);
+                    lCore.log(this._ctr ?? {}, `[AI][IMAGE] ${e.message}`, '-error');
+                    return false;
+                }
+            }
+            case ESERVICE.GEMINI: {
+                return false;
+            }
+            case ESERVICE.GROK: {
+                return false;
+            }
+            case ESERVICE.VOLCN:
+            case ESERVICE.VOLAS: {
+                try {
+                    const res = await this._fetch(`${this._endpoint}/images/generations`, {
+                        'method': 'POST',
+                        'headers': {
+                            'authorization': `Bearer ${this.link.apiKey}`,
+                            'content-type': 'application/json',
+                        },
+                        'body': lText.stringifyJson({
+                            'model': opt.model,
+                            'prompt': opt.prompt,
+                            'watermark': false,
+                            'size': `${opt.size[0]}x${opt.size[1]}`,
+                            'seed': seed,
+                            ...(opt.n && opt.n > 1 ? {
+                                'sequential_image_generation': 'auto',
+                                'sequential_image_generation_options': {
+                                    'max_images': 4,
+                                },
+                            } : {
+                                'sequential_image_generation': 'disabled',
+                            }),
+                            ...(opt.imgs?.length ? {
+                                'image': opt.imgs.length === 1 ? opt.imgs[0] : opt.imgs,
+                            } : {}),
+                        }),
+                    });
+                    const json = await res.json();
+                    if (!json.data?.[0]) {
+                        lCore.debug('[AI][IMAGE]', json);
+                        lCore.log(this._ctr ?? {}, `[AI][IMAGE] ${lText.stringifyJson(json)}`, '-error');
+                        return false;
+                    }
+                    return {
+                        'list': json.data.map((item) => ({
+                            'url': item.url,
+                            'text': opt.prompt,
+                        })),
+                        'seed': seed,
+                        'request': json.created.toString(),
+                    };
+                }
+                catch (e) {
+                    lCore.debug('[AI][IMAGE]', e);
+                    lCore.log(this._ctr ?? {}, `[AI][IMAGE] ${e.message}`, '-error');
+                    return false;
+                }
+            }
+        }
+    }
+    /** --- 异步生成视频，仅支持 ALICN、ALIAS --- */
+    async video(opt) {
+        if (this._service !== ESERVICE.ALICN && this._service !== ESERVICE.ALIAS) {
+            return false;
+        }
+        const mode = opt.mode ?? 'text';
+        const imgs = opt.imgs ?? [];
+        const resolution = opt.resolution ?? '720p';
+        const ratio = opt.ratio ?? '16:9';
+        const duration = opt.duration ?? 2;
+        const shot = opt.shot ?? 'single';
+        const audio = opt.audio ?? false;
+        const seed = opt.seed ?? lCore.rand(0, 2147483647);
+        const extend = opt.extend ?? false;
+        /** --- x*x --- */
+        let size = '';
+        if (resolution === '480p') {
+            // --- 不支持 ---
+            return false;
+        }
+        else if (resolution === '720p') {
+            switch (ratio) {
+                case '21:9': {
+                    // --- 不支持 ---
+                    return false;
+                }
+                case '16:9': {
+                    size = '1280*720';
+                    break;
+                }
+                case '9:16': {
+                    size = '720*1280';
+                    break;
+                }
+                case '4:3': {
+                    size = '1088*832';
+                    break;
+                }
+                case '3:4': {
+                    size = '832*1088';
+                    break;
+                }
+                default: {
+                    // --- 1:1 ---
+                    size = '960*960';
+                }
+            }
+        }
+        else {
+            // --- 1080p ---
+            switch (ratio) {
+                case '21:9': {
+                    // --- 不支持 ---
+                    return false;
+                }
+                case '16:9': {
+                    size = '1920*1080';
+                    break;
+                }
+                case '9:16': {
+                    size = '1080*1920';
+                    break;
+                }
+                case '4:3': {
+                    size = '1632*1248';
+                    break;
+                }
+                case '3:4': {
+                    size = '1248*1632';
+                    break;
+                }
+                default: {
+                    // --- 1:1 ---
+                    size = '1440*1440';
+                }
+            }
+        }
+        try {
+            const res = await this._fetch(`https://dashscope${this._service === ESERVICE.ALIAS ? '-intl' : ''}.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis`, {
+                'method': 'POST',
+                'headers': {
+                    'authorization': `Bearer ${this.link.apiKey}`,
+                    'content-type': 'application/json',
+                    'X-DashScope-Async': 'enable',
+                },
+                'body': lText.stringifyJson({
+                    'model': opt.model,
+                    'input': {
+                        'prompt': opt.prompt.replace(/\[I(\d+)\]/g, 'Character$1'),
+                        ...(typeof audio === 'string' ? {
+                            'audio_url': audio,
+                        } : {})
+                    },
+                    'parameters': {
+                        'negative_prompt': opt.negative ?? ' ',
+                        'watermark': false,
+                        'size': size,
+                        'seed': seed,
+                        'audio': audio ? true : false,
+                        'duration': duration,
+                        'shot_type': shot,
+                        'prompt_extend': extend,
+                        ...((mode !== 'text') && (mode === 'frame' ? (imgs.length > 1 ? {
+                            // --- 首尾帧 ---
+                            'first_frame_url': imgs[0],
+                            'last_frame_url': imgs[1],
+                        } : {
+                            // --- 首帧 ---
+                            'img_url': imgs[0],
+                        }) : {
+                            'reference_urls': imgs,
+                        })),
+                    },
+                }),
+            });
+            const json = await res.json();
+            if (!json.output?.task_id) {
+                lCore.debug('[AI][VIDEO]', json);
+                lCore.log(this._ctr ?? {}, `[AI][VIDEO] ${lText.stringifyJson(json)}`, '-error');
+                return false;
+            }
+            const task = json.output.task_id;
+            return {
+                'task': task,
+                'status': json.output.task_status,
+                'seed': seed,
+                'request': json.request_id,
+            };
+        }
+        catch (e) {
+            lCore.debug('[AI][VIDEO]', e);
+            lCore.log(this._ctr ?? {}, `[AI][VIDEO] ${e.message}`, '-error');
+            return false;
+        }
+    }
+    /** --- 轮询任务 --- */
+    async poll(opt) {
+        if (this._service !== ESERVICE.ALICN && this._service !== ESERVICE.ALIAS) {
+            return false;
+        }
+        try {
+            const res = await this._fetch(`https://dashscope${this._service === ESERVICE.ALIAS ? '-intl' : ''}.aliyuncs.com/api/v1/tasks/${opt.task}`, {
+                'method': 'GET',
+                'headers': {
+                    'authorization': `Bearer ${this.link.apiKey}`,
+                },
+            });
+            const json = await res.json();
+            if (!json.output?.task_status) {
+                lCore.debug('[AI][POLL]', json);
+                lCore.log(this._ctr ?? {}, `[AI][POLL] ${lText.stringifyJson(json)}`, '-error');
+                return false;
+            }
+            return {
+                'task': json.output.task_id,
+                'status': json.output.task_status,
+                'add': json.output.submit_time,
+                'start': json.output.scheduled_time,
+                'end': json.output.end_time,
+                'url': json.output.video_url,
+                'error': json.output.message ? `(${json.output.code})${json.output.message}` : undefined,
+            };
+        }
+        catch (e) {
+            lCore.debug('[AI][POLL]', e);
+            lCore.log(this._ctr ?? {}, `[AI][POLL] ${e.message}`, '-error');
+            return false;
+        }
+    }
 }
 /**
  * --- 创建一个 AI 对象 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "8.0.6",
+  "version": "8.1.0",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [
@@ -22,30 +22,30 @@
     "#kebab/*": "./*"
   },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.985.0",
-    "@aws-sdk/lib-storage": "^3.985.0",
+    "@aws-sdk/client-s3": "^3.992.0",
+    "@aws-sdk/lib-storage": "^3.992.0",
     "@litert/http-client": "^1.1.2",
     "@litert/mime": "^0.1.3",
     "@litert/redis": "^3.1.0",
     "@litert/websocket": "^0.2.8",
     "@types/ssh2": "^1.15.5",
-    "@zilliz/milvus2-sdk-node": "^2.6.9",
+    "@zilliz/milvus2-sdk-node": "^2.6.10",
     "ejs": "^4.0.1",
     "jszip": "^3.10.1",
-    "mysql2": "^3.16.3",
+    "mysql2": "^3.17.2",
     "node-cron": "^4.2.1",
-    "openai": "^6.18.0",
+    "openai": "^6.22.0",
     "pg": "^8.18.0",
     "ssh2": "^1.17.0",
     "svg-captcha": "^1.4.0",
-    "tencentcloud-sdk-nodejs": "^4.1.185"
+    "tencentcloud-sdk-nodejs": "^4.1.186"
   },
   "devDependencies": {
     "@litert/eslint-plugin-rules": "^0.3.1",
     "@types/ejs": "^3.1.5",
-    "@types/node": "^25.2.2",
+    "@types/node": "^25.2.3",
     "@types/pg": "^8.16.0",
-    "typedoc": "^0.28.16",
+    "typedoc": "^0.28.17",
     "typedoc-plugin-markdown": "^4.10.0",
     "typescript": "^5.9.3"
   }

package/sys/cmd.js

@@ -177,6 +177,14 @@ async function run() {
         config.ai['AZURE3'] ??= {};
         config.ai['AZURE3'].endpoint ??= '';
         config.ai['AZURE3'].skey ??= '';
+        config.ai['GEMINI'] ??= {};
+        config.ai['GEMINI'].skey ??= '';
+        config.ai['GROK'] ??= {};
+        config.ai['GROK'].skey ??= '';
+        config.ai['VOLCN'] ??= {};
+        config.ai['VOLCN'].skey ??= '';
+        config.ai['VOLAS'] ??= {};
+        config.ai['VOLAS'].skey ??= '';
         // --- config - vector ---
         config.vector ??= {};
         config.vector.host ??= '127.0.0.1';

package/www/example/ctr/test.js

@@ -127,8 +127,12 @@ export default class extends sCtr.Ctr {
             `<br><a href="${this._config.const.urlBase}test/mod-update-list">View "test/mod-update-list"</a>`,
             '<br><br><b>Library test:</b>',
             `<br><br><b>Ai:</b>`,
-            `<br><br><a href="${this._config.const.urlBase}test/ai">View "test/ai"</a>`,
             `<br><a href="${this._config.const.urlBase}test/ai-stream">View "test/ai-stream"</a>`,
+            `<br><a href="${this._config.const.urlBase}test/ai?action=chat">View "test/ai?action=chat"</a>`,
+            `<br><a href="${this._config.const.urlBase}test/ai?action=text-to-image">View "test/ai?action=text-to-image"</a>`,
+            `<br><a href="${this._config.const.urlBase}test/ai?action=image-to-image">View "test/ai?action=image-to-image"</a>`,
+            `<br><a href="${this._config.const.urlBase}test/ai?action=text-to-video">View "test/ai?action=text-to-video"</a>`,
+            `<br><a href="${this._config.const.urlBase}test/ai?action=image-to-video">View "test/ai?action=image-to-video"</a>`,
             '<br><br><b>Core:</b>',
             `<br><br><a href="${this._config.const.urlBase}test/core-random">View "test/core-random"</a>`,
             `<br><a href="${this._config.const.urlBase}test/core-rand">View "test/core-rand"</a>`,
@@ -3337,31 +3341,177 @@ rtn.push(reader.readBCDString());</pre>${JSON.stringify(rtn)}`);
         return echo.join('') + '<br>' + this._getEnd();
     }
     async ai() {
-        const ai = lAi.get(this, {
-            'service': lAi.ESERVICE.ALICN,
-        });
         const echo = [`<pre>const ai = lAi.get(this, {
-    'service': lAi.ESERVICE.ALICN,
+    'service': lAi.ESERVICE.${lText.htmlescape(this._get['service']?.toUpperCase() ?? 'ALICN')},
 });</pre>`];
-        const completion = await ai.chat({
-            'model': 'qwen-plus',
-            'messages': [
-                { 'role': 'system', 'content': 'You are Kebab, a friendly and knowledgeable assistant based on an open-source Node framework. You do not mention any model names or AI identity. You can chat casually, answer questions, and provide guidance naturally. Respond in a human-like, approachable manner, as if you are a helpful companion rather than a traditional AI assistant.' },
-                { 'role': 'user', 'content': '你是谁？' },
-            ],
+        const ai = lAi.get(this, {
+            'service': lAi.ESERVICE[this._get['service']?.toUpperCase() ?? 'ALICN'] ?? lAi.ESERVICE.ALICN,
         });
-        echo.push(`<pre>await ai.chat({
-    'model': 'qwen-plus',
+        switch (this._get['action']) {
+            case 'text-to-image': {
+                // --- 文生图 ---
+                let model = 'z-image-turbo';
+                let size = [1280, 720];
+                if (ai.service !== lAi.ESERVICE.ALICN && ai.service !== lAi.ESERVICE.ALIAS) {
+                    switch (ai.service) {
+                        case lAi.ESERVICE.AZURE:
+                        case lAi.ESERVICE.AZURE2:
+                        case lAi.ESERVICE.AZURE3: {
+                            model = 'FLUX.2-pro';
+                            break;
+                        }
+                        default: {
+                            // --- 火山引擎 ---
+                            model = 'doubao-seedream-4-5-251128';
+                            size = [2560, 1440];
+                        }
+                    }
+                }
+                const imgResult = await ai.image({
+                    'model': model,
+                    'prompt': 'A cute cat sitting on a windowsill watching the sunset',
+                    'size': size,
+                    'n': 1,
+                });
+                echo.push(`<pre>await ai.image({
+    'model': '${model}',
+    'prompt': 'A cute cat sitting on a windowsill watching the sunset',
+    'size': [${size[0]}, ${size[1]}],
+    'n': 1,
+});</pre>`);
+                if (imgResult && imgResult.list?.length) {
+                    for (const img of imgResult.list) {
+                        echo.push(`<div><img src="${img.url.startsWith('http') ? img.url : 'data:image/png;base64,' + img.url}" style="max-width: 512px;" /></div>${lText.htmlescape(img.text)}`);
+                    }
+                    echo.push('<br>request: ' + imgResult.request, ', seed: ' + imgResult.seed);
+                }
+                else {
+                    echo.push('Failed');
+                }
+                break;
+            }
+            case 'image-to-image': {
+                // --- 图生图 ---
+                let model = 'wan2.6-image';
+                let size = [1280, 720];
+                const prompt = '用图1的绘画风格重绘图2的场景，桌上增加一盘番茄炒蛋';
+                if (ai.service !== lAi.ESERVICE.ALICN && ai.service !== lAi.ESERVICE.ALIAS) {
+                    switch (ai.service) {
+                        default: {
+                            // --- 火山引擎 ---
+                            model = 'doubao-seedream-4-5-251128';
+                            size = [2560, 1440];
+                        }
+                    }
+                }
+                const imgResult = await ai.image({
+                    'model': model,
+                    'imgs': [
+                        'https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png',
+                        'https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp',
+                    ],
+                    'prompt': prompt,
+                    'size': size,
+                    'n': 1,
+                });
+                echo.push(`<pre>await ai.image({
+    'model': '${model}',
+    'imgs': [
+        'https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png',
+        'https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp',
+    ],
+    'prompt': '${prompt}',
+    'size': [${size[0]}, ${size[1]}],
+    'n': 1,
+});</pre>`);
+                if (imgResult && imgResult.list?.length) {
+                    echo.push(`<div>Reference Images:</div><div>
+    <img src="https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png" style="max-width: 256px; margin-right: 5px;" />
+    <img src="https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp" style="max-width: 256px;" />
+</div>`);
+                    for (const img of imgResult.list) {
+                        echo.push(`<div><img src="${img.url.startsWith('http') ? img.url : 'data:image/png;base64,' + img.url}" style="max-width: 512px;" /></div>${lText.htmlescape(img.text || prompt)}`);
+                    }
+                    echo.push('<br>request: ' + imgResult.request, ', seed: ' + imgResult.seed);
+                }
+                else {
+                    echo.push('Failed');
+                }
+                break;
+            }
+            case 'text-to-video': {
+                // --- 文生视频 ---
+                const model = 'wan2.6-t2v';
+                const vidResult = await ai.video({
+                    'prompt': 'A cat playing with a ball of yarn',
+                    'model': model,
+                });
+                echo.push(`<pre>await aiVid.video({
+    'prompt': 'A cat playing with a ball of yarn',
+    'model': '${model}',
+});</pre>`);
+                if (vidResult) {
+                    echo.push(`<pre>${JSON.stringify(vidResult, null, 4)}</pre><a href="${this._config.const.urlBase}test/ai?action=video-poll&task=${vidResult.task}">poll</a>`);
+                }
+                else {
+                    echo.push('Failed');
+                }
+                break;
+            }
+            case 'image-to-video': {
+                // --- 图生视频 ---
+                echo.push('Not yet implemented');
+                break;
+            }
+            case 'video-poll': {
+                // --- 视频生成轮询 ---
+                if (!this._get['task']) {
+                    echo.push('Task ID not found.');
+                    break;
+                }
+                const pollResult = await ai.poll({
+                    'type': 'video',
+                    'task': this._get['task'],
+                });
+                echo.push(`<pre>await ai.poll({
+    'type': 'video',
+    'task': '${this._get['task']}',
+});</pre>`);
+                if (pollResult) {
+                    echo.push(`<pre>${JSON.stringify(pollResult, null, 4)}</pre>Result.`);
+                }
+                else {
+                    echo.push('Failed');
+                }
+                break;
+            }
+            default: {
+                // --- CHAT ---
+                let model = ai.service === lAi.ESERVICE.ALICN ? 'qwen-plus' : 'doubao-seed-2-0-mini-260215';
+                if (ai.service === lAi.ESERVICE.AZURE) {
+                    model = 'gpt-4.1-nano';
+                }
+                const completion = await ai.chat({
+                    'model': model,
+                    'messages': [
+                        { 'role': 'system', 'content': 'You are Kebab, a friendly and knowledgeable assistant based on an open-source Node framework. You do not mention any model names or AI identity. You can chat casually, answer questions, and provide guidance naturally. Respond in a human-like, approachable manner, as if you are a helpful companion rather than a traditional AI assistant.' },
+                        { 'role': 'user', 'content': '你是谁？' },
+                    ],
+                });
+                echo.push(`<pre>await ai.chat({
+    'model': ${model},
     'messages': [
         { 'role': 'system', 'content': 'You are Kebab, a friendly and knowledgeable assistant based on an open-source Node framework. You do not mention any model names or AI identity. You can chat casually, answer questions, and provide guidance naturally. Respond in a human-like, approachable manner, as if you are a helpful companion rather than a traditional AI assistant.' },
         { 'role': 'user', 'content': '你是谁？' },
     ],
 });</pre>`);
-        if (completion) {
-            echo.push(JSON.stringify(completion.choices[0].message.content));
-        }
-        else {
-            echo.push('Failed');
+                if (completion) {
+                    echo.push(JSON.stringify(completion.choices[0].message.content));
+                }
+                else {
+                    echo.push('Failed');
+                }
+            }
         }
         return echo.join('') + '<br><br>' + this._getEnd();
     }