@aigne/aigne-hub 0.8.4 → 0.8.6

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # Changelog
 
+## [0.8.6](https://github.com/AIGNE-io/aigne-framework/compare/aigne-hub-v0.8.5...aigne-hub-v0.8.6) (2025-09-01)
+
+
+### Bug Fixes
+
+* **transport:** improve HTTP client option handling and error serialization ([#445](https://github.com/AIGNE-io/aigne-framework/issues/445)) ([d3bcdd2](https://github.com/AIGNE-io/aigne-framework/commit/d3bcdd23ab8011a7d40fc157fd61eb240494c7a5))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/anthropic bumped to 0.11.17
+    * @aigne/bedrock bumped to 0.9.17
+    * @aigne/core bumped to 1.57.5
+    * @aigne/deepseek bumped to 0.7.36
+    * @aigne/doubao bumped to 1.0.30
+    * @aigne/gemini bumped to 0.11.6
+    * @aigne/ideogram bumped to 0.3.6
+    * @aigne/ollama bumped to 0.7.36
+    * @aigne/open-router bumped to 0.7.36
+    * @aigne/openai bumped to 0.13.7
+    * @aigne/poe bumped to 1.0.16
+    * @aigne/transport bumped to 0.14.16
+    * @aigne/xai bumped to 0.7.36
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.43
+
+## [0.8.5](https://github.com/AIGNE-io/aigne-framework/compare/aigne-hub-v0.8.4...aigne-hub-v0.8.5) (2025-08-30)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/anthropic bumped to 0.11.16
+    * @aigne/bedrock bumped to 0.9.16
+    * @aigne/core bumped to 1.57.4
+    * @aigne/deepseek bumped to 0.7.35
+    * @aigne/doubao bumped to 1.0.29
+    * @aigne/gemini bumped to 0.11.5
+    * @aigne/ideogram bumped to 0.3.5
+    * @aigne/ollama bumped to 0.7.35
+    * @aigne/open-router bumped to 0.7.35
+    * @aigne/openai bumped to 0.13.6
+    * @aigne/poe bumped to 1.0.15
+    * @aigne/transport bumped to 0.14.15
+    * @aigne/xai bumped to 0.7.35
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.42
+
 ## [0.8.4](https://github.com/AIGNE-io/aigne-framework/compare/aigne-hub-v0.8.3...aigne-hub-v0.8.4) (2025-08-30)
 
 

package/README.md

@@ -14,7 +14,7 @@
 [![NPM Version](https://img.shields.io/npm/v/@aigne/aigne-hub)](https://www.npmjs.com/package/@aigne/aigne-hub)
 [![Elastic-2.0 licensed](https://img.shields.io/npm/l/@aigne/aigne-hub)](https://github.com/AIGNE-io/aigne-framework/blob/main/LICENSE.md)
 
-AIGNE SDK for accessing AI chat models via [AIGNE Hub](https://github.com/AIGNE-io/aigne-framework), a unified proxy layer for multiple LLM providers.
+AIGNE SDK for accessing AI chat models and image generation via [AIGNE Hub](https://github.com/AIGNE-io/aigne-framework), a unified proxy layer for multiple LLM providers.
 
 # Introduction
 
@@ -25,7 +25,7 @@ It enables you to switch providers without changing your client-side logic.
 <picture>
   <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/assets/aigne-hub-dark.png" media="(prefers-color-scheme: dark)">
   <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/assets/aigne-hub.png" media="(prefers-color-scheme: light)">
-  <img src="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/aigne-hub.png" alt="AIGNE Arch" />
+  <img src="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/assets/aigne-hub.png" alt="AIGNE Arch" />
 </picture>
 
 ## Supported Providers
@@ -60,6 +60,7 @@ type AIProvider =
 * 🧠 Multi-provider Support: Choose from any supported vendor via the model name
 * 🔐 API Key Security: Use accessKey to manage authentication and authorization
 * 💬 Chat Completions: Works with standard messages format ({ role, content })
+* 🎨 Image Generation: Generate images using OpenAI DALL-E, Google Gemini Imagen, and Ideogram models
 * 🌊 Streaming Support: Enable streaming: true for real-time token-level responses
 * 🧱 Framework Compatible: Seamless integration with the AIGNE Framework
 
@@ -111,6 +112,123 @@ console.log(result);
 */
 ```
 
+## Image Generation
+
+AIGNE Hub supports multiple image generation models from different providers. Here are examples for each supported platform with their available parameters:
+
+### OpenAI DALL-E Models
+
+```typescript
+import { AIGNEHubImageModel } from "@aigne/aigne-hub";
+
+const model = new AIGNEHubImageModel({
+  url: "https://your-aigne-hub-instance/ai-kit",
+  accessKey: "your-access-key-secret",
+  model: "openai/dall-e-3",
+});
+
+const result = await model.invoke({
+  prompt: "A futuristic cityscape with flying cars and neon lights",
+  n: 1,
+  size: "1024x1024",
+  quality: "standard",
+  style: "natural",
+});
+
+console.log(result);
+/* Example Output:
+  {
+    images: [{ url: "https://..." }],
+    usage: { inputTokens: 0, outputTokens: 0 },
+    model: "openai/dall-e-3"
+  }
+*/
+```
+
+**Available Parameters:**
+- **DALL-E 2**: `prompt`, `size`, `n`
+- **DALL-E 3**: `prompt`, `size`, `n`, `quality`, `style`, `user`
+- **GPT-Image-1**: `prompt`, `size`, `background`, `moderation`, `outputCompression`, `outputFormat`, `quality`, `user`, `stream`
+
+**Reference:** [OpenAI Images API Documentation](https://platform.openai.com/docs/guides/images)
+
+### Google Gemini Imagen Models
+
+```typescript
+import { AIGNEHubImageModel } from "@aigne/aigne-hub";
+
+const model = new AIGNEHubImageModel({
+  url: "https://your-aigne-hub-instance/ai-kit",
+  accessKey: "your-access-key-secret",
+  model: "google/imagen-4.0-generate-001",
+});
+
+const result = await model.invoke({
+  prompt: "A serene mountain landscape at sunset",
+  n: 1,
+  imageSize: "1024x1024",
+  aspectRatio: "1:1",
+  guidanceScale: 7.5,
+});
+
+console.log(result);
+/* Example Output:
+  {
+    images: [{ base64: "..." }],
+    usage: { inputTokens: 0, outputTokens: 0 },
+    model: "google/imagen-4.0-generate-001"
+  }
+*/
+```
+
+**Available Parameters:**
+- **Imagen Models**: `seed`, `safetyFilterLevel`, `personGeneration`, `outputMimeType`, `outputGcsUri`, `outputCompressionQuality`, `negativePrompt`, `language`, `includeSafetyAttributes`, `includeRaiReason`, `imageSize`, `guidanceScale`, `aspectRatio`, `addWatermark`
+- **Gemini Models**: `seed`, `safetySettings`, `temperature`, `topP`, `topK`, `maxOutputTokens`, `stopSequences`, `systemInstruction`, `tools`, `toolConfig`, `safetySettings`, `responseSchema`, `responseJsonSchema`
+
+**Note:** Gemini image models currently only support base64 format output.
+
+**Reference:** 
+- **Imagen Models**: Refer to [Google GenAI Models.generateImages()](https://googleapis.github.io/js-genai/release_docs/classes/models.Models.html#generateimages)
+- **Gemini Models**: Refer to [Google GenAI Models.generateContent()](https://googleapis.github.io/js-genai/release_docs/classes/models.Models.html#generatecontent)
+
+### Ideogram Models
+
+```typescript
+import { AIGNEHubImageModel } from "@aigne/aigne-hub";
+
+const model = new AIGNEHubImageModel({
+  url: "https://your-aigne-hub-instance/ai-kit",
+  accessKey: "your-access-key-secret",
+  model: "ideogram/ideogram-v3",
+});
+
+const result = await model.invoke({
+  prompt: "A cyberpunk character with glowing blue eyes",
+  n: 1,
+  resolution: "1024x1024",
+  aspectRatio: "1:1",
+  renderingSpeed: "fast",
+  styleType: "cinematic",
+});
+
+console.log(result);
+/* Example Output:
+  {
+    images: [{ url: "https://..." }],
+    usage: { inputTokens: 0, outputTokens: 0 },
+    model: "ideogram/ideogram-v3"
+  }
+*/
+```
+
+**Available Parameters:**
+- `prompt`, `seed`, `resolution`, `aspectRatio`, `renderingSpeed`, `magicPrompt`, `negativePrompt`, `colorPalette`, `styleCodes`, `styleType`
+
+**Note:** Currently only supports `ideogram-v3` model.
+
+**Reference:** [Ideogram API Documentation](https://developer.ideogram.ai/api-reference/api-reference/generate-v3)
+
+
 ## Streaming Usage
 
 ```typescript
@@ -153,6 +271,13 @@ interface ClientChatModelOptions {
   model: string; // Model name with provider prefix (e.g. openai/gpt-4o-mini)
   modelOptions?: object; // Optional model-specific parameters
 }
+
+interface ClientImageModelOptions {
+  url: string; // Your AIGNE Hub endpoint
+  accessKey: string; // API access key
+  model: string; // Model name with provider prefix (e.g. openai/dall-e-3)
+  modelOptions?: object; // Optional model-specific parameters
+}
 ```
 
 ## License

package/lib/cjs/aigne-hub-model.js

@@ -56,7 +56,14 @@ class AIGNEHubChatModel extends core_1.ChatModel {
             BLOCKLET_APP_PID ||
             ABT_NODE_DID ||
             `@aigne/aigne-hub:${typeof process !== "undefined" ? index_js_1.nodejs.os.hostname() : "unknown"}`;
-        return (await this.client).__invoke(undefined, input, {
+        return (await this.client).__invoke(undefined, {
+            ...input,
+            modelOptions: {
+                ...this.options.modelOptions,
+                ...input.modelOptions,
+                model: input.modelOptions?.model || (await this.credential).model,
+            },
+        }, {
             ...options,
             fetchOptions: {
                 ...options.fetchOptions,

package/lib/esm/aigne-hub-model.js

@@ -53,7 +53,14 @@ export class AIGNEHubChatModel extends ChatModel {
             BLOCKLET_APP_PID ||
             ABT_NODE_DID ||
             `@aigne/aigne-hub:${typeof process !== "undefined" ? nodejs.os.hostname() : "unknown"}`;
-        return (await this.client).__invoke(undefined, input, {
+        return (await this.client).__invoke(undefined, {
+            ...input,
+            modelOptions: {
+                ...this.options.modelOptions,
+                ...input.modelOptions,
+                model: input.modelOptions?.model || (await this.credential).model,
+            },
+        }, {
             ...options,
             fetchOptions: {
                 ...options.fetchOptions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/aigne-hub",
-  "version": "0.8.4",
+  "version": "0.8.6",
   "description": "AIGNE Hub SDK for integrating with Hub AI models",
   "publishConfig": {
     "access": "public"
@@ -39,20 +39,20 @@
     "https-proxy-agent": "^7.0.6",
     "ufo": "^1.6.1",
     "zod": "^3.25.67",
-    "@aigne/bedrock": "^0.9.15",
-    "@aigne/deepseek": "^0.7.34",
-    "@aigne/doubao": "^1.0.28",
-    "@aigne/gemini": "^0.11.4",
-    "@aigne/ideogram": "^0.3.4",
-    "@aigne/open-router": "^0.7.34",
-    "@aigne/ollama": "^0.7.34",
-    "@aigne/openai": "^0.13.5",
+    "@aigne/anthropic": "^0.11.17",
+    "@aigne/bedrock": "^0.9.17",
+    "@aigne/deepseek": "^0.7.36",
+    "@aigne/core": "^1.57.5",
+    "@aigne/gemini": "^0.11.6",
+    "@aigne/ideogram": "^0.3.6",
+    "@aigne/ollama": "^0.7.36",
+    "@aigne/open-router": "^0.7.36",
+    "@aigne/doubao": "^1.0.30",
+    "@aigne/openai": "^0.13.7",
     "@aigne/platform-helpers": "^0.6.2",
-    "@aigne/core": "^1.57.3",
-    "@aigne/anthropic": "^0.11.15",
-    "@aigne/transport": "^0.14.14",
-    "@aigne/xai": "^0.7.34",
-    "@aigne/poe": "^1.0.14"
+    "@aigne/poe": "^1.0.16",
+    "@aigne/transport": "^0.14.16",
+    "@aigne/xai": "^0.7.36"
   },
   "devDependencies": {
     "@types/bun": "^1.2.18",
@@ -61,7 +61,7 @@
     "npm-run-all": "^4.1.5",
     "rimraf": "^6.0.1",
     "typescript": "^5.8.3",
-    "@aigne/test-utils": "^0.5.41"
+    "@aigne/test-utils": "^0.5.43"
   },
   "scripts": {
     "lint": "tsc --noEmit",