@aigne/aigne-hub 0.10.5-beta.1 → 0.10.5-beta.2

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [0.10.5-beta.2](https://github.com/AIGNE-io/aigne-framework/compare/aigne-hub-v0.10.5-beta.1...aigne-hub-v0.10.5-beta.2) (2025-11-04)
+
+
+### Bug Fixes
+
+* **cli:** optimize app startup by restructuring CLI application loading ([#698](https://github.com/AIGNE-io/aigne-framework/issues/698)) ([20c5059](https://github.com/AIGNE-io/aigne-framework/commit/20c50591bbd9a958b29409eca3ede5e341db2b7d))
+* **docs:** update video mode docs ([#695](https://github.com/AIGNE-io/aigne-framework/issues/695)) ([d691001](https://github.com/AIGNE-io/aigne-framework/commit/d69100169457c16c14f2f3e2f7fcd6b2a99330f3))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/anthropic bumped to 0.14.5-beta.2
+    * @aigne/bedrock bumped to 0.10.10-beta.2
+    * @aigne/core bumped to 1.65.1-beta.2
+    * @aigne/deepseek bumped to 0.7.51-beta.2
+    * @aigne/doubao bumped to 1.1.5-beta.2
+    * @aigne/gemini bumped to 0.14.5-beta.2
+    * @aigne/ideogram bumped to 0.4.5-beta.2
+    * @aigne/ollama bumped to 0.7.51-beta.2
+    * @aigne/open-router bumped to 0.7.51-beta.2
+    * @aigne/openai bumped to 0.16.5-beta.2
+    * @aigne/poe bumped to 1.0.31-beta.2
+    * @aigne/transport bumped to 0.15.14-beta.2
+    * @aigne/xai bumped to 0.7.51-beta.2
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.58-beta.2
+
 ## [0.10.5-beta.1](https://github.com/AIGNE-io/aigne-framework/compare/aigne-hub-v0.10.5-beta...aigne-hub-v0.10.5-beta.1) (2025-11-04)
 
 

package/README.md

@@ -228,6 +228,110 @@ console.log(result);
 
 **Reference:** [Ideogram API Documentation](https://developer.ideogram.ai/api-reference/api-reference/generate-v3)
 
+## Video Generation
+
+AIGNE Hub supports AI-powered video generation models from multiple providers. Here are examples for each supported platform:
+
+### OpenAI Sora Model
+
+```typescript
+import { AIGNEHubVideoModel } from "@aigne/aigne-hub";
+
+const model = new AIGNEHubVideoModel({
+  baseUrl: "https://your-aigne-hub-instance/ai-kit",
+  apiKey: "your-access-key-secret",
+  model: "openai/sora-2",
+});
+
+const result = await model.invoke({
+  prompt: "A serene beach scene with gentle waves at sunset",
+  size: "1280x720",
+  seconds: "8",
+  outputFileType: "url",
+});
+
+console.log(result);
+/* Example Output:
+  {
+    videos: [{ url: "https://...", type: "url" }],
+    usage: {
+      inputTokens: 0,
+      outputTokens: 0,
+      aigneHubCredits: 200
+    },
+    model: "openai/sora-2",
+    seconds: 8
+  }
+*/
+```
+
+**Available Parameters:**
+- `prompt` (required): Text description of the video to generate
+- `model`: Video model - `"openai/sora-2"` (standard) or `"openai/sora-2-pro"` (higher quality)
+- `size`: Video resolution - `"720x1280"` (9:16 vertical), `"1280x720"` (16:9 horizontal), `"1024x1792"` (9:16 higher), `"1792x1024"` (16:9 higher)
+- `seconds`: Video duration - `"4"`, `"8"`, or `"12"` seconds
+- `image`: Optional input image for image-to-video generation
+- `outputFileType`: Output format - `"url"`, `"file"`, or `"base64"`
+
+**Reference:** [OpenAI Video API Documentation](https://platform.openai.com/docs/api-reference/videos)
+
+### Google Gemini Veo Model
+
+```typescript
+import { AIGNEHubVideoModel } from "@aigne/aigne-hub";
+
+const model = new AIGNEHubVideoModel({
+  baseUrl: "https://your-aigne-hub-instance/ai-kit",
+  apiKey: "your-access-key-secret",
+  model: "google/veo-3.1-generate-preview",
+});
+
+const result = await model.invoke({
+  prompt: "A majestic eagle soaring through mountain valleys",
+  aspectRatio: "16:9",
+  size: "1080p",
+  seconds: "6",
+  negativePrompt: "blur, low quality",
+  personGeneration: "allow_adult",
+  outputFileType: "url",
+});
+
+console.log(result);
+/* Example Output:
+  {
+    videos: [{ url: "https://...", type: "url" }],
+    usage: {
+      inputTokens: 0,
+      outputTokens: 0,
+      aigneHubCredits: 150
+    },
+    model: "google/veo-3.1-generate-preview",
+    seconds: 6
+  }
+*/
+```
+
+**Available Parameters:**
+- `prompt` (required): Text description of the video to generate
+- `model`: Video model - `"google/veo-3.1-generate-preview"` (latest), `"google/veo-3-generate"`, or `"google/veo-2-generate"`
+- `aspectRatio`: Video aspect ratio - `"16:9"` (default, horizontal) or `"9:16"` (vertical)
+- `size`: Video resolution - `"720p"` (default) or `"1080p"` (note: 1080p only supports 8 seconds for Veo 3.1)
+- `seconds`: Video duration - `"4"`, `"6"`, or `"8"` seconds
+- `negativePrompt`: Text describing content to avoid in the video
+- `personGeneration`: Control person generation - `"allow_adult"` (text-to-video), `"allow_all"` (image-to-video for Veo 3.1)
+- `image`: Optional input image for image-to-video generation
+- `lastFrame`: Optional last frame for frame interpolation (Veo 3.1)
+- `referenceImages`: Optional reference images array (only supported in Veo 3.1)
+- `outputFileType`: Output format - `"url"`, `"file"`, or `"base64"`
+
+**Reference:** [Google Gemini Video API Documentation](https://ai.google.dev/api/generate-videos)
+
+### General Notes
+
+Video generation may take longer than image or text generation. The `outputFileType` parameter determines how the generated video is returned:
+- `url`: Returns a URL to the generated video (recommended for web applications)
+- `file`: Returns the video file data directly
+- `base64`: Returns base64-encoded video data
 
 ## Streaming Usage
 

package/lib/cjs/utils/model.js

@@ -194,7 +194,7 @@ function findVideoModel(provider) {
 }
 const parseModel = (model) => {
     // replace first ':' with '/' to compatible with `provider:model-name` format
-    model = model.replace(/^(\w+)(:)/, "$1/");
+    model = model.replace(/^([\w-]+)(:)/, "$1/");
     const { provider, name } = model.match(/(?<provider>[^/]*)(\/(?<name>.*))?/)?.groups ?? {};
     return { provider: provider?.replace(/-/g, ""), model: name };
 };

package/lib/esm/utils/model.js

@@ -185,7 +185,7 @@ export function findVideoModel(provider) {
 }
 export const parseModel = (model) => {
     // replace first ':' with '/' to compatible with `provider:model-name` format
-    model = model.replace(/^(\w+)(:)/, "$1/");
+    model = model.replace(/^([\w-]+)(:)/, "$1/");
     const { provider, name } = model.match(/(?<provider>[^/]*)(\/(?<name>.*))?/)?.groups ?? {};
     return { provider: provider?.replace(/-/g, ""), model: name };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/aigne-hub",
-  "version": "0.10.5-beta.1",
+  "version": "0.10.5-beta.2",
   "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/anthropic": "^0.14.5-beta.1",
-    "@aigne/bedrock": "^0.10.10-beta.1",
-    "@aigne/core": "^1.65.1-beta.1",
-    "@aigne/deepseek": "^0.7.51-beta.1",
-    "@aigne/doubao": "^1.1.5-beta.1",
-    "@aigne/gemini": "^0.14.5-beta.1",
-    "@aigne/ideogram": "^0.4.5-beta.1",
-    "@aigne/open-router": "^0.7.51-beta.1",
-    "@aigne/ollama": "^0.7.51-beta.1",
-    "@aigne/openai": "^0.16.5-beta.1",
+    "@aigne/anthropic": "^0.14.5-beta.2",
+    "@aigne/bedrock": "^0.10.10-beta.2",
+    "@aigne/deepseek": "^0.7.51-beta.2",
+    "@aigne/core": "^1.65.1-beta.2",
+    "@aigne/doubao": "^1.1.5-beta.2",
+    "@aigne/gemini": "^0.14.5-beta.2",
+    "@aigne/ollama": "^0.7.51-beta.2",
+    "@aigne/ideogram": "^0.4.5-beta.2",
+    "@aigne/openai": "^0.16.5-beta.2",
+    "@aigne/open-router": "^0.7.51-beta.2",
     "@aigne/platform-helpers": "^0.6.3",
-    "@aigne/poe": "^1.0.31-beta.1",
-    "@aigne/transport": "^0.15.14-beta.1",
-    "@aigne/xai": "^0.7.51-beta.1"
+    "@aigne/transport": "^0.15.14-beta.2",
+    "@aigne/xai": "^0.7.51-beta.2",
+    "@aigne/poe": "^1.0.31-beta.2"
   },
   "devDependencies": {
     "@types/bun": "^1.2.22",
@@ -61,7 +61,7 @@
     "npm-run-all": "^4.1.5",
     "rimraf": "^6.0.1",
     "typescript": "^5.9.2",
-    "@aigne/test-utils": "^0.5.58-beta.1"
+    "@aigne/test-utils": "^0.5.58-beta.2"
   },
   "scripts": {
     "lint": "tsc --noEmit",