@coreviz/sdk 1.0.12 → 1.0.14

package/README.md

@@ -1,11 +1,39 @@
+[![The World's Most Powerful Visual Copilot](./demo/banner.png)](https://coreviz.io)
+
+<div align="center">
+    <h1>CoreViz</h1>
+    <a href="https://coreviz.io/">Home</a>
+    <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+    <a href="https://lab.coreviz.io/">Studio</a>
+    <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+    <a href="https://github.com/coreviz/cli">CLI</a>
+    <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+    <a href="https://github.com/coreviz/sdk">SDK</a>
+    <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+    <a href="https://docs.coreviz.io/">Docs</a>
+    <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+    <a href="https://x.com/withcoreviz">X</a>
+    <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+    <a href="https://www.linkedin.com/company/coreviz/">LinkedIn</a>
+    <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+    <a href="mailto:team@coreviz.io">Contact</a>
+  <br />
+  <br />
+
+CoreViz is a Vision AI platform for teams and individuals working with thousands of visual assets.
+
+  <p align="center">
+    <a href="https://coreviz.io"><img alt="CoreViz" src="./demo/demo.gif"></a>
+  </p>
+</div>
+
+
 # @coreviz/sdk
 
 Easily integrate powerful image analysis and manipulation features into your applications with CoreViz (https://coreviz.io/) 's Vision SDK.
 
 ## Introduction
 
-[![CoreViz Demo Screenshot](./demo/demo.gif)](https://coreviz.io/)
-
 The CoreViz SDK powers the [coreviz.io](https://coreviz.io/) platform and the [CoreViz CLI](https://github.com/coreviz/cli), providing fast, consistent AI image analysis and manipulation capabilities across environments.
 
 You can try out the live demos and tools built with this SDK at [coreviz.io/tools](https://coreviz.io/tools), including:
@@ -105,6 +133,30 @@ const editedImage = await coreviz.edit('https://example.com/photo.jpg', {
 });
 ```
 
+### `coreviz.batchGenerate(prompt, options)`
+
+Generates multiple images based on a text prompt, optionally using reference images for style/structure guidance.
+
+**Parameters:**
+- `prompt` (string): The text description of the image(s) to generate.
+- `options` (object, optional):
+  - `referenceImages` (string[], optional): Array of reference images (URL/base64) to guide generation.
+  - `count` (number, optional): Number of images to generate (default: 1).
+  - `aspectRatio` (string, optional): Target aspect ratio (e.g., `'1:1'`, `'16:9'`, `'4:3'`).
+  - `model` (string, optional): The model to use (default: `'google/nano-banana-pro'`).
+
+**Returns:**
+- `Promise<string[]>`: An array of generated images as URLs.
+
+**Example:**
+
+```typescript
+const images = await coreviz.batchGenerate("A futuristic city skyline", {
+  count: 4,
+  aspectRatio: "16:9"
+});
+```
+
 ### `coreviz.embed(input, options?)`
 
 Generates embeddings for image or text inputs, enabling semantic search and similarity comparison. Use with `coreviz.similarity(embeddingA, embeddingB)` to compare two images or an image and a text.
@@ -159,4 +211,4 @@ Utility function to resize images client-side or server-side before processing.
 ```typescript
 const resized = await coreviz.resize(myFileObject, 800, 600);
 // or import { resize } from '@coreviz/sdk';
-```
+```

package/dist/coreviz.d.ts

@@ -27,6 +27,12 @@ export interface EmbedOptions {
 export interface EmbedResponse {
     embedding: number[];
 }
+export interface BatchGenerateOptions {
+    referenceImages?: string[];
+    count?: number;
+    aspectRatio?: '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9' | '21:9';
+    model?: 'google/nano-banana' | 'google/nano-banana-pro';
+}
 export declare class CoreViz {
     private apiKey?;
     private token?;
@@ -35,6 +41,7 @@ export declare class CoreViz {
     private handleResponse;
     describe(image: string, options?: DescribeOptions): Promise<string>;
     edit(image: string, options: EditOptions): Promise<string>;
+    batchGenerate(prompt: string, options?: BatchGenerateOptions): Promise<string[]>;
     tag(image: string, options: TagOptions): Promise<TagResponse>;
     private tagLocal;
     embed(input: string, options?: EmbedOptions): Promise<EmbedResponse>;

package/dist/coreviz.js

@@ -103,6 +103,31 @@ class CoreViz {
             throw err instanceof Error ? err : new Error("An unexpected error occurred.");
         }
     }
+    async batchGenerate(prompt, options = {}) {
+        try {
+            const headers = this.getHeaders();
+            let resizedImages = [];
+            if (options.referenceImages && options.referenceImages.length > 0) {
+                resizedImages = await Promise.all(options.referenceImages.map(img => (0, resize_1.resize)(img, 1024, 1024)));
+            }
+            const response = await fetch(`https://lab.coreviz.io/api/ai/batch-generate`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({
+                    prompt,
+                    image: resizedImages.length > 0 ? resizedImages : undefined,
+                    count: options.count || 1,
+                    aspectRatio: options.aspectRatio,
+                    model: options.model || 'google/nano-banana-pro',
+                }),
+            });
+            const data = await this.handleResponse(response);
+            return data.results || [];
+        }
+        catch (err) {
+            throw err instanceof Error ? err : new Error("An unexpected error occurred.");
+        }
+    }
     async tag(image, options) {
         const mode = options?.mode || 'api';
         if (mode === 'local') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coreviz/sdk",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "CoreViz SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",