ai-world-sdk 1.0.10 → 1.0.12

package/README.md

@@ -219,7 +219,6 @@ const result = await client.generate({
   prompt: 'A beautiful landscape',              // 必需
   model: 'gemini-2.5-flash-image',              // 推荐：快速、高效
   aspect_ratio: '16:9',                         // 可选: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
-  number_of_images: 1,                          // 可选: 1-4
 });
 
 // 高级用法（使用 Gemini 3 Pro - 专业模型，支持高分辨率）
@@ -228,7 +227,6 @@ const result2 = await client.generate({
   model: 'gemini-3-pro-image-preview',         // 专业级模型
   aspect_ratio: '16:9',
   image_size: '2K',                             // 可选: 1K, 2K, 4K（仅适用于 gemini-3-pro-image-preview）
-  number_of_images: 1,
   response_modalities: ['IMAGE'],              // 仅返回图片，不返回文本
   temperature: 0.7,                             // 可选: 0.0-2.0
   max_output_tokens: 1000,                      // 可选
@@ -244,12 +242,11 @@ const result3 = await aihubmixClient.generate({
   model: 'gemini-3-pro-image-preview',
   aspect_ratio: '16:9',
   image_size: '1K',
-  number_of_images: 1,
   response_modalities: ['IMAGE'],
 });
 
-// 图像编辑（使用文本提示编辑图片）
-const editResult = await client.edit({
+// 单图输入（文本 + 单张图片，实现编辑效果）
+const editResult = await client.generate({
   prompt: 'Add a small wizard hat on the cat\'s head',
   image: 'data:image/png;base64,iVBORw0KGgo...', // base64 编码的图片数据或 data URL
   model: 'gemini-2.5-flash-image',
@@ -283,13 +280,17 @@ const secondResponse = await client.chat({
 |------|------|------|--------|
 | `prompt` | `string` | 图像生成提示词（必需） | - |
 | `model` | `string` | 模型名称 | `gemini-2.0-flash-exp-image-generation` |
+| `image` | `string \| string[]` | 输入图片（base64 或 data URL）。可以是单个图片或图片数组（多图输入） | - |
 | `aspect_ratio` | `string` | 宽高比 | - |
 | `image_size` | `string` | 图片大小（仅 gemini-3-pro-image-preview） | - |
-| `number_of_images` | `number` | 生成图片数量 | `1` |
 | `response_modalities` | `array` | 响应模态 | `['TEXT', 'IMAGE']` |
 | `temperature` | `number` | 温度参数 | `0.7` |
 | `max_output_tokens` | `number` | 最大输出 token 数 | `1000` |
 
+**多图输入限制：**
+- `gemini-2.5-flash-image`: 最多支持 3 张输入图片
+- `gemini-3-pro-image-preview`: 最多支持 14 张输入图片（其中最多 5 张高保真图片）
+
 **支持的宽高比：** `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`
 
 **Provider 说明：**
@@ -304,11 +305,7 @@ const secondResponse = await client.chat({
 | `gemini-2.5-flash-image` | 1024px | 快速、高效、成本低 | 日常使用、批量生成 |
 | `gemini-3-pro-image-preview` | 1K/2K/4K | 专业级、高分辨率、高级功能 | 专业设计、高分辨率需求 |
 
-**图像编辑和多轮修改：**
-
-- **`edit()`** - 图像编辑：使用文本提示编辑图片，支持添加、移除或修改元素
-  - 需要提供输入图片（base64 编码或 data URL）
-  - 适用于单次编辑操作
+**多轮图片修改：**
 
 - **`chat()`** - 多轮图片修改：通过对话迭代式优化图片
   - 首次调用创建新的聊天会话，返回 `chat_id`
@@ -664,12 +661,11 @@ import { GeminiImageGenerationClient } from 'ai-world-sdk';
 
 const client = new GeminiImageGenerationClient({});
 
-// 使用 Gemini 2.5 Flash（快速模型）
+// 1. 文生图（仅文本提示）
 const result = await client.generate({
   prompt: 'A beautiful sunset over the ocean',
   model: 'gemini-2.5-flash-image',
   aspect_ratio: '16:9',
-  number_of_images: 1,
 });
 
 console.log('图像 URL:', result.data[0]?.url || 'Base64 编码');
@@ -677,8 +673,32 @@ if (result.text) {
   console.log('图像描述:', result.text);
 }
 
-// 使用 Gemini 3 Pro（专业模型，支持高分辨率）
+// 2. 单图输入（文本 + 单张图片）
 const result2 = await client.generate({
+  prompt: 'Create a picture of my cat eating a nano-banana in a fancy restaurant',
+  image: 'data:image/png;base64,iVBORw0KGgo...', // base64 编码的图片或 data URL
+  model: 'gemini-2.5-flash-image',
+  aspect_ratio: '16:9',
+});
+
+// 3. 多图输入（文本 + 多张图片）
+// gemini-2.5-flash-image 最多支持 3 张图片
+// gemini-3-pro-image-preview 最多支持 14 张图片
+const result3 = await client.generate({
+  prompt: 'An office group photo of these people, they are making funny faces.',
+  image: [
+    'data:image/png;base64,iVBORw0KGgo...', // 第一张图片
+    'data:image/png;base64,iVBORw0KGgo...', // 第二张图片
+    'data:image/png;base64,iVBORw0KGgo...', // 第三张图片
+  ],
+  model: 'gemini-3-pro-image-preview',
+  aspect_ratio: '5:4',
+  image_size: '2K',
+  response_modalities: ['IMAGE'],
+});
+
+// 4. 使用 Gemini 3 Pro（专业模型，支持高分辨率）
+const result4 = await client.generate({
   prompt: 'A futuristic city at night',
   model: 'gemini-3-pro-image-preview',
   aspect_ratio: '21:9', // 超宽屏
@@ -686,7 +706,7 @@ const result2 = await client.generate({
   response_modalities: ['IMAGE'], // 仅返回图片
 });
 
-console.log('4K 图像:', result2.data[0]?.b64_json ? 'Base64 编码' : result2.data[0]?.url);
+console.log('4K 图像:', result4.data[0]?.b64_json ? 'Base64 编码' : result4.data[0]?.url);
 ```
 
 ### 视频生成工作流

package/dist/__tests__/example.test.js

@@ -557,14 +557,13 @@ describe("Langchain SDK Tests", () => {
         expect(Array.isArray(message.content)).toBe(true);
         console.log("✅ HumanMessage with array content 测试成功");
     });
-    test("GeminiImageGenerationClient - 基础图像生成", async () => {
+    test("GeminiImageGenerationClient - 基础图像生成（文生图）", async () => {
         const imageClient = new index_1.GeminiImageGenerationClient({});
         const result = await imageClient.generate({
             prompt: 'A beautiful sunset over the ocean',
             model: 'gemini-3-pro-image-preview',
             aspect_ratio: '16:9',
             image_size: '1K', // 仅适用于 gemini-3-pro-image-preview
-            number_of_images: 1,
             response_modalities: ['IMAGE'], // 仅返回图片
         });
         expect(result).toBeDefined();
@@ -577,13 +576,72 @@ describe("Langchain SDK Tests", () => {
             expect(item).toBeDefined();
             expect(item.url || item.b64_json).toBeDefined();
         });
-        console.log("✅ GeminiImageGenerationClient 基础测试成功");
+        console.log("✅ GeminiImageGenerationClient 基础测试成功（文生图）");
         console.log(`生成图像数量: ${result.data.length}`);
         console.log("图像 URL:", result.data[0]?.url || ("Base64 编码" + result.data[0]?.b64_json));
         if (result.text) {
             console.log("图像描述:", result.text);
         }
     }, 120000);
+    test("GeminiImageGenerationClient - 单图输入图像生成", async () => {
+        const imageClient = new index_1.GeminiImageGenerationClient({});
+        // 先生成一张基础图片
+        const baseResult = await imageClient.generate({
+            prompt: 'A photorealistic picture of a fluffy ginger cat sitting on a wooden floor',
+            model: 'gemini-2.5-flash-image',
+            aspect_ratio: '1:1',
+            response_modalities: ['IMAGE'],
+        });
+        expect(baseResult.data.length).toBeGreaterThan(0);
+        const baseImage = baseResult.data[0]?.b64_json || baseResult.data[0]?.url;
+        expect(baseImage).toBeDefined();
+        // 使用生成的图片作为输入
+        const result = await imageClient.generate({
+            prompt: 'Using the provided image of my cat, please add a small, knitted wizard hat on its head',
+            image: baseImage,
+            model: 'gemini-2.5-flash-image',
+            aspect_ratio: '1:1',
+            response_modalities: ['IMAGE'],
+        });
+        expect(result).toBeDefined();
+        expect(result.data).toBeDefined();
+        expect(result.data.length).toBeGreaterThan(0);
+        console.log("✅ GeminiImageGenerationClient 单图输入测试成功");
+    }, 120000);
+    test("GeminiImageGenerationClient - 多图输入图像生成", async () => {
+        const imageClient = new index_1.GeminiImageGenerationClient({});
+        // 先生成两张基础图片
+        const baseResult1 = await imageClient.generate({
+            prompt: 'A professional headshot of a woman with brown hair and blue eyes',
+            model: 'gemini-2.5-flash-image',
+            aspect_ratio: '1:1',
+            response_modalities: ['IMAGE'],
+        });
+        const baseResult2 = await imageClient.generate({
+            prompt: 'A simple, modern logo with the letters G and A in a white circle',
+            model: 'gemini-2.5-flash-image',
+            aspect_ratio: '1:1',
+            response_modalities: ['IMAGE'],
+        });
+        expect(baseResult1.data.length).toBeGreaterThan(0);
+        expect(baseResult2.data.length).toBeGreaterThan(0);
+        const image1 = baseResult1.data[0]?.b64_json || baseResult1.data[0]?.url;
+        const image2 = baseResult2.data[0]?.b64_json || baseResult2.data[0]?.url;
+        expect(image1).toBeDefined();
+        expect(image2).toBeDefined();
+        // 使用多张图片作为输入（gemini-2.5-flash-image 最多支持 3 张）
+        const result = await imageClient.generate({
+            prompt: 'Take the first image of the woman and add the logo from the second image onto her black t-shirt',
+            image: [image1, image2],
+            model: 'gemini-2.5-flash-image',
+            aspect_ratio: '1:1',
+            response_modalities: ['IMAGE'],
+        });
+        expect(result).toBeDefined();
+        expect(result.data).toBeDefined();
+        expect(result.data.length).toBeGreaterThan(0);
+        console.log("✅ GeminiImageGenerationClient 多图输入测试成功");
+    }, 180000);
     test("GeminiImageGenerationClient - 使用 aihubmix provider", async () => {
         const imageClient = new index_1.GeminiImageGenerationClient({
             provider: "aihubmix",
@@ -593,7 +651,6 @@ describe("Langchain SDK Tests", () => {
             model: 'gemini-3-pro-image-preview',
             aspect_ratio: '16:9',
             image_size: '1K',
-            number_of_images: 1,
             response_modalities: ['IMAGE'], // 仅返回图片
         });
         expect(result).toBeDefined();
@@ -613,54 +670,6 @@ describe("Langchain SDK Tests", () => {
             console.log("图像描述:", result.text);
         }
     }, 120000);
-    test("GeminiImageGenerationClient - 图像编辑", async () => {
-        const imageClient = new index_1.GeminiImageGenerationClient({});
-        // 首先生成一张基础图片
-        const generateResult = await imageClient.generate({
-            prompt: 'A simple red apple on a white background',
-            model: 'gemini-2.5-flash-image',
-            aspect_ratio: '1:1',
-            response_modalities: ['IMAGE'],
-        });
-        expect(generateResult).toBeDefined();
-        expect(generateResult.data).toBeDefined();
-        expect(generateResult.data.length).toBeGreaterThan(0);
-        // 获取第一张图片的 base64 数据
-        const firstImage = generateResult.data[0];
-        expect(firstImage).toBeDefined();
-        // 提取 base64 数据（优先使用 b64_json，否则从 text 中提取）
-        let base64Image;
-        if (firstImage.b64_json) {
-            base64Image = firstImage.b64_json;
-        }
-        else if (firstImage.text && firstImage.text.startsWith('data:')) {
-            // 从 data URL 中提取 base64 部分
-            base64Image = firstImage.text.split(',')[1];
-        }
-        else {
-            throw new Error('无法获取图片的 base64 数据');
-        }
-        expect(base64Image).toBeDefined();
-        // 使用编辑功能添加元素
-        const editResult = await imageClient.edit({
-            prompt: 'Add a small green leaf on top of the apple',
-            image: base64Image, // 直接使用 base64 字符串
-            model: 'gemini-2.5-flash-image',
-            aspect_ratio: '1:1',
-            response_modalities: ['IMAGE'],
-        });
-        expect(editResult).toBeDefined();
-        expect(editResult.created).toBeDefined();
-        expect(editResult.data).toBeDefined();
-        expect(Array.isArray(editResult.data)).toBe(true);
-        expect(editResult.data.length).toBeGreaterThan(0);
-        editResult.data.forEach((item) => {
-            expect(item).toBeDefined();
-            expect(item.url || item.b64_json).toBeDefined();
-        });
-        console.log("✅ GeminiImageGenerationClient 图像编辑测试成功");
-        console.log(`编辑后图像数量: ${editResult.data.length}`);
-    }, 180000);
     test("GeminiImageGenerationClient - 多轮图片修改", async () => {
         const imageClient = new index_1.GeminiImageGenerationClient({});
         // 第一轮：创建初始图片

package/dist/gemini-image-generation.d.ts

@@ -10,7 +10,7 @@ export interface GeminiImageGenerationConfig {
 export interface GeminiImageGenerationRequest {
     prompt: string;
     model?: string;
-    number_of_images?: number;
+    image?: string | string[];
     aspect_ratio?: "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9";
     image_size?: "1K" | "2K" | "4K";
     temperature?: number;
@@ -28,16 +28,6 @@ export interface GeminiImageGenerationResponse {
     data: GeminiImageData[];
     text?: string;
 }
-export interface GeminiImageEditRequest {
-    prompt: string;
-    image: string;
-    model?: string;
-    provider?: "aihubmix" | "gemini";
-    aspect_ratio?: "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9";
-    image_size?: "1K" | "2K" | "4K";
-    response_modalities?: ("TEXT" | "IMAGE")[];
-    user?: string;
-}
 export interface GeminiImageChatRequest {
     message: string;
     chat_id?: string;
@@ -66,22 +56,8 @@ export declare class GeminiImageGenerationClient {
      * - aspect_ratio: 宽高比，支持 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
      * - image_size: 图片大小（仅 gemini-3-pro-image-preview），支持 1K, 2K, 4K
      * - response_modalities: 响应模态，["TEXT", "IMAGE"] 或 ["IMAGE"]
-     * - number_of_images: 生成图片数量（1-4）
      */
     generate(request: GeminiImageGenerationRequest): Promise<GeminiImageGenerationResponse>;
-    /**
-     * Edit images
-     * 编辑图像
-     *
-     * 使用文本提示编辑图片，支持添加、移除或修改元素
-     *
-     * 支持的参数：
-     * - image: base64 编码的图片数据，或 data URL（如 data:image/png;base64,...）
-     * - aspect_ratio: 宽高比
-     * - image_size: 图片大小（仅 gemini-3-pro-image-preview）
-     * - response_modalities: 响应模态
-     */
-    edit(request: GeminiImageEditRequest): Promise<GeminiImageGenerationResponse>;
     /**
      * Chat with images (multi-turn image editing)
      * 图像多轮对话（用于多轮图片修改）

package/dist/gemini-image-generation.js

@@ -33,14 +33,16 @@ class GeminiImageGenerationClient {
      * - aspect_ratio: 宽高比，支持 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
      * - image_size: 图片大小（仅 gemini-3-pro-image-preview），支持 1K, 2K, 4K
      * - response_modalities: 响应模态，["TEXT", "IMAGE"] 或 ["IMAGE"]
-     * - number_of_images: 生成图片数量（1-4）
      */
     async generate(request) {
         const requestBody = {
             prompt: request.prompt,
             model: request.model || "gemini-2.0-flash-exp-image-generation",
-            number_of_images: request.number_of_images || 1,
         };
+        // 添加图片输入参数（单图或多图）
+        if (request.image) {
+            requestBody.image = request.image;
+        }
         // 添加可选参数
         if (request.aspect_ratio) {
             requestBody.aspect_ratio = request.aspect_ratio;
@@ -76,56 +78,6 @@ class GeminiImageGenerationClient {
         (0, log_1.logResponse)(response.status, response.statusText, response.headers, data);
         return data;
     }
-    /**
-     * Edit images
-     * 编辑图像
-     *
-     * 使用文本提示编辑图片，支持添加、移除或修改元素
-     *
-     * 支持的参数：
-     * - image: base64 编码的图片数据，或 data URL（如 data:image/png;base64,...）
-     * - aspect_ratio: 宽高比
-     * - image_size: 图片大小（仅 gemini-3-pro-image-preview）
-     * - response_modalities: 响应模态
-     */
-    async edit(request) {
-        const requestBody = {
-            prompt: request.prompt,
-            image: request.image,
-            model: request.model || "gemini-2.5-flash-image",
-        };
-        // 添加可选参数
-        if (request.aspect_ratio) {
-            requestBody.aspect_ratio = request.aspect_ratio;
-        }
-        if (request.image_size) {
-            requestBody.image_size = request.image_size;
-        }
-        if (request.response_modalities) {
-            requestBody.response_modalities = request.response_modalities;
-        }
-        if (request.user) {
-            requestBody.user = request.user;
-        }
-        if (request.provider) {
-            requestBody.provider = request.provider;
-        }
-        const url = `${config_1.sdkConfig.getServerUrl()}/api/gemini-image-proxy/edit`;
-        (0, log_1.logRequest)("POST", url, this.headers, { ...requestBody, image: "[base64 data]" });
-        const response = await fetch(url, {
-            method: "POST",
-            headers: this.headers,
-            body: JSON.stringify(requestBody),
-        });
-        if (!response.ok) {
-            const errorText = await response.text();
-            (0, log_1.logResponse)(response.status, response.statusText, response.headers, errorText);
-            throw new Error(`Gemini image edit API error: ${response.status} ${errorText}`);
-        }
-        const data = (await response.json());
-        (0, log_1.logResponse)(response.status, response.statusText, response.headers, data);
-        return data;
-    }
     /**
      * Chat with images (multi-turn image editing)
      * 图像多轮对话（用于多轮图片修改）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-world-sdk",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "TypeScript SDK for AI World Platform - Chat Models, Image Generation, and Video Generation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",