@blockrun/llm 2.8.0 → 2.9.1

package/README.md

@@ -406,7 +406,17 @@ All models below have been tested end-to-end via the TypeScript SDK (Feb 2026):
 | `xai/grok-imagine-image-pro` | $0.07/image |
 | `zai/cogview-4` | $0.015/image |
 
-Image editing (`client.edit`): `openai/gpt-image-1` and `openai/gpt-image-2` both support the `/v1/images/image2image` endpoint.
+Image editing (`client.edit`) via `/v1/images/image2image`: `openai/gpt-image-1`, `openai/gpt-image-2`, `google/nano-banana`, and `google/nano-banana-pro`. Pass a single base64 `data:image/...` URI to edit one image, or an array of 2–4 URIs to **fuse** them (e.g. a subject + a brand logo). Fusion caps: `openai/*` up to 4 source images, `google/*` up to 3. A `mask` cannot be combined with multiple source images.
+
+```ts
+// Multi-image fusion with Nano Banana
+const fused = await client.edit(
+  "Place the logo on the t-shirt",
+  [subjectDataUri, logoDataUri],
+  { model: "google/nano-banana" }
+);
+console.log(fused.data[0].url);
+```
 
 ### Video Generation
 | Model | Price |

package/dist/index.cjs

@@ -1463,16 +1463,18 @@ var LLMClient = class _LLMClient {
     return data.data || [];
   }
   /**
-   * Edit an image using img2img.
+   * Edit an image using img2img, optionally fusing multiple source images.
    *
    * @param prompt - Text description of the desired edit
-   * @param image - Base64-encoded image or URL of the source image
+   * @param image - A base64 `data:image/...` URI, or an array of 2–4 such URIs
+   *   to fuse (image fusion). Caps: `openai/*` up to 4, `google/*` up to 3.
+   *   A `mask` cannot be combined with multiple source images.
    * @param options - Optional edit parameters
    * @returns ImageResponse with edited image URLs
    */
   async imageEdit(prompt, image, options) {
     const body = {
-      model: options?.model || "openai/gpt-image-1",
+      model: options?.model || "openai/gpt-image-2",
       prompt,
       image,
       size: options?.size || "1024x1024",
@@ -1972,20 +1974,37 @@ var ImageClient = class {
     return this.requestWithPayment("/v1/images/generations", body);
   }
   /**
-   * Edit an image using img2img.
+   * Edit an image using img2img, optionally fusing multiple source images.
+   *
+   * Pass a single `data:image/...` base64 data URI to edit one image, or an
+   * array of 2–4 data URIs to fuse them (image fusion) — e.g. a reference photo
+   * plus a brand logo. The server caps fusion per provider: `openai/*` accepts
+   * up to 4 source images, `google/*` (Nano Banana) up to 3. A `mask` cannot be
+   * combined with multiple source images.
+   *
+   * Edit-capable models: `openai/gpt-image-1`, `openai/gpt-image-2`,
+   * `google/nano-banana`, `google/nano-banana-pro`.
    *
    * @param prompt - Text description of the desired edit
-   * @param image - Base64-encoded image or URL of the source image
+   * @param image - A base64 `data:image/...` URI, or an array of 2–4 such URIs to fuse
    * @param options - Optional edit parameters
    * @returns ImageResponse with edited image URLs
    *
    * @example
-   * const result = await client.edit('Make it a painting', imageBase64);
-   * console.log(result.data[0].url);
+   * // Single-image edit
+   * const result = await client.edit('Make it a painting', imageDataUri);
+   *
+   * @example
+   * // Multi-image fusion (Nano Banana): blend a subject with a brand logo
+   * const fused = await client.edit(
+   *   'Place the logo on the t-shirt',
+   *   [subjectDataUri, logoDataUri],
+   *   { model: 'google/nano-banana' }
+   * );
    */
   async edit(prompt, image, options) {
     const body = {
-      model: options?.model || "openai/gpt-image-1",
+      model: options?.model || "openai/gpt-image-2",
       prompt,
       image,
       size: options?.size || "1024x1024",
@@ -4632,7 +4651,7 @@ var SolanaLLMClient = class {
   /** Edit an image using img2img (Solana payment). */
   async imageEdit(prompt, image, options) {
     const body = {
-      model: options?.model || "openai/gpt-image-1",
+      model: options?.model || "openai/gpt-image-2",
       prompt,
       image,
       size: options?.size || "1024x1024",

package/dist/index.d.cts

@@ -335,7 +335,7 @@ interface SearchResult {
     model?: string;
 }
 interface ImageEditOptions {
-    /** Model ID (default: "openai/gpt-image-1") */
+    /** Model ID (default: "openai/gpt-image-2") */
     model?: string;
     /** Optional base64-encoded mask image */
     mask?: string;
@@ -1158,14 +1158,16 @@ declare class LLMClient {
      */
     private fetchRawModels;
     /**
-     * Edit an image using img2img.
+     * Edit an image using img2img, optionally fusing multiple source images.
      *
      * @param prompt - Text description of the desired edit
-     * @param image - Base64-encoded image or URL of the source image
+     * @param image - A base64 `data:image/...` URI, or an array of 2–4 such URIs
+     *   to fuse (image fusion). Caps: `openai/*` up to 4, `google/*` up to 3.
+     *   A `mask` cannot be combined with multiple source images.
      * @param options - Optional edit parameters
      * @returns ImageResponse with edited image URLs
      */
-    imageEdit(prompt: string, image: string, options?: ImageEditOptions): Promise<ImageResponse>;
+    imageEdit(prompt: string, image: string | string[], options?: ImageEditOptions): Promise<ImageResponse>;
     /**
      * Standalone search (web, X/Twitter, news).
      *
@@ -1478,18 +1480,35 @@ declare class ImageClient {
      */
     generate(prompt: string, options?: ImageGenerateOptions): Promise<ImageResponse>;
     /**
-     * Edit an image using img2img.
+     * Edit an image using img2img, optionally fusing multiple source images.
+     *
+     * Pass a single `data:image/...` base64 data URI to edit one image, or an
+     * array of 2–4 data URIs to fuse them (image fusion) — e.g. a reference photo
+     * plus a brand logo. The server caps fusion per provider: `openai/*` accepts
+     * up to 4 source images, `google/*` (Nano Banana) up to 3. A `mask` cannot be
+     * combined with multiple source images.
+     *
+     * Edit-capable models: `openai/gpt-image-1`, `openai/gpt-image-2`,
+     * `google/nano-banana`, `google/nano-banana-pro`.
      *
      * @param prompt - Text description of the desired edit
-     * @param image - Base64-encoded image or URL of the source image
+     * @param image - A base64 `data:image/...` URI, or an array of 2–4 such URIs to fuse
      * @param options - Optional edit parameters
      * @returns ImageResponse with edited image URLs
      *
      * @example
-     * const result = await client.edit('Make it a painting', imageBase64);
-     * console.log(result.data[0].url);
+     * // Single-image edit
+     * const result = await client.edit('Make it a painting', imageDataUri);
+     *
+     * @example
+     * // Multi-image fusion (Nano Banana): blend a subject with a brand logo
+     * const fused = await client.edit(
+     *   'Place the logo on the t-shirt',
+     *   [subjectDataUri, logoDataUri],
+     *   { model: 'google/nano-banana' }
+     * );
      */
-    edit(prompt: string, image: string, options?: ImageEditOptions): Promise<ImageResponse>;
+    edit(prompt: string, image: string | string[], options?: ImageEditOptions): Promise<ImageResponse>;
     /**
      * List available image generation models with pricing.
      *
@@ -2504,7 +2523,7 @@ declare class SolanaLLMClient {
      */
     getBalance(): Promise<number>;
     /** Edit an image using img2img (Solana payment). */
-    imageEdit(prompt: string, image: string, options?: ImageEditOptions): Promise<ImageResponse>;
+    imageEdit(prompt: string, image: string | string[], options?: ImageEditOptions): Promise<ImageResponse>;
     /** Standalone search (Solana payment). */
     search(query: string, options?: SearchOptions): Promise<SearchResult>;
     xUserLookup(usernames: string | string[]): Promise<XUserLookupResponse>;

package/dist/index.d.ts

@@ -335,7 +335,7 @@ interface SearchResult {
     model?: string;
 }
 interface ImageEditOptions {
-    /** Model ID (default: "openai/gpt-image-1") */
+    /** Model ID (default: "openai/gpt-image-2") */
     model?: string;
     /** Optional base64-encoded mask image */
     mask?: string;
@@ -1158,14 +1158,16 @@ declare class LLMClient {
      */
     private fetchRawModels;
     /**
-     * Edit an image using img2img.
+     * Edit an image using img2img, optionally fusing multiple source images.
      *
      * @param prompt - Text description of the desired edit
-     * @param image - Base64-encoded image or URL of the source image
+     * @param image - A base64 `data:image/...` URI, or an array of 2–4 such URIs
+     *   to fuse (image fusion). Caps: `openai/*` up to 4, `google/*` up to 3.
+     *   A `mask` cannot be combined with multiple source images.
      * @param options - Optional edit parameters
      * @returns ImageResponse with edited image URLs
      */
-    imageEdit(prompt: string, image: string, options?: ImageEditOptions): Promise<ImageResponse>;
+    imageEdit(prompt: string, image: string | string[], options?: ImageEditOptions): Promise<ImageResponse>;
     /**
      * Standalone search (web, X/Twitter, news).
      *
@@ -1478,18 +1480,35 @@ declare class ImageClient {
      */
     generate(prompt: string, options?: ImageGenerateOptions): Promise<ImageResponse>;
     /**
-     * Edit an image using img2img.
+     * Edit an image using img2img, optionally fusing multiple source images.
+     *
+     * Pass a single `data:image/...` base64 data URI to edit one image, or an
+     * array of 2–4 data URIs to fuse them (image fusion) — e.g. a reference photo
+     * plus a brand logo. The server caps fusion per provider: `openai/*` accepts
+     * up to 4 source images, `google/*` (Nano Banana) up to 3. A `mask` cannot be
+     * combined with multiple source images.
+     *
+     * Edit-capable models: `openai/gpt-image-1`, `openai/gpt-image-2`,
+     * `google/nano-banana`, `google/nano-banana-pro`.
      *
      * @param prompt - Text description of the desired edit
-     * @param image - Base64-encoded image or URL of the source image
+     * @param image - A base64 `data:image/...` URI, or an array of 2–4 such URIs to fuse
      * @param options - Optional edit parameters
      * @returns ImageResponse with edited image URLs
      *
      * @example
-     * const result = await client.edit('Make it a painting', imageBase64);
-     * console.log(result.data[0].url);
+     * // Single-image edit
+     * const result = await client.edit('Make it a painting', imageDataUri);
+     *
+     * @example
+     * // Multi-image fusion (Nano Banana): blend a subject with a brand logo
+     * const fused = await client.edit(
+     *   'Place the logo on the t-shirt',
+     *   [subjectDataUri, logoDataUri],
+     *   { model: 'google/nano-banana' }
+     * );
      */
-    edit(prompt: string, image: string, options?: ImageEditOptions): Promise<ImageResponse>;
+    edit(prompt: string, image: string | string[], options?: ImageEditOptions): Promise<ImageResponse>;
     /**
      * List available image generation models with pricing.
      *
@@ -2504,7 +2523,7 @@ declare class SolanaLLMClient {
      */
     getBalance(): Promise<number>;
     /** Edit an image using img2img (Solana payment). */
-    imageEdit(prompt: string, image: string, options?: ImageEditOptions): Promise<ImageResponse>;
+    imageEdit(prompt: string, image: string | string[], options?: ImageEditOptions): Promise<ImageResponse>;
     /** Standalone search (Solana payment). */
     search(query: string, options?: SearchOptions): Promise<SearchResult>;
     xUserLookup(usernames: string | string[]): Promise<XUserLookupResponse>;

package/dist/index.js

@@ -1360,16 +1360,18 @@ var LLMClient = class _LLMClient {
     return data.data || [];
   }
   /**
-   * Edit an image using img2img.
+   * Edit an image using img2img, optionally fusing multiple source images.
    *
    * @param prompt - Text description of the desired edit
-   * @param image - Base64-encoded image or URL of the source image
+   * @param image - A base64 `data:image/...` URI, or an array of 2–4 such URIs
+   *   to fuse (image fusion). Caps: `openai/*` up to 4, `google/*` up to 3.
+   *   A `mask` cannot be combined with multiple source images.
    * @param options - Optional edit parameters
    * @returns ImageResponse with edited image URLs
    */
   async imageEdit(prompt, image, options) {
     const body = {
-      model: options?.model || "openai/gpt-image-1",
+      model: options?.model || "openai/gpt-image-2",
       prompt,
       image,
       size: options?.size || "1024x1024",
@@ -1869,20 +1871,37 @@ var ImageClient = class {
     return this.requestWithPayment("/v1/images/generations", body);
   }
   /**
-   * Edit an image using img2img.
+   * Edit an image using img2img, optionally fusing multiple source images.
+   *
+   * Pass a single `data:image/...` base64 data URI to edit one image, or an
+   * array of 2–4 data URIs to fuse them (image fusion) — e.g. a reference photo
+   * plus a brand logo. The server caps fusion per provider: `openai/*` accepts
+   * up to 4 source images, `google/*` (Nano Banana) up to 3. A `mask` cannot be
+   * combined with multiple source images.
+   *
+   * Edit-capable models: `openai/gpt-image-1`, `openai/gpt-image-2`,
+   * `google/nano-banana`, `google/nano-banana-pro`.
    *
    * @param prompt - Text description of the desired edit
-   * @param image - Base64-encoded image or URL of the source image
+   * @param image - A base64 `data:image/...` URI, or an array of 2–4 such URIs to fuse
    * @param options - Optional edit parameters
    * @returns ImageResponse with edited image URLs
    *
    * @example
-   * const result = await client.edit('Make it a painting', imageBase64);
-   * console.log(result.data[0].url);
+   * // Single-image edit
+   * const result = await client.edit('Make it a painting', imageDataUri);
+   *
+   * @example
+   * // Multi-image fusion (Nano Banana): blend a subject with a brand logo
+   * const fused = await client.edit(
+   *   'Place the logo on the t-shirt',
+   *   [subjectDataUri, logoDataUri],
+   *   { model: 'google/nano-banana' }
+   * );
    */
   async edit(prompt, image, options) {
     const body = {
-      model: options?.model || "openai/gpt-image-1",
+      model: options?.model || "openai/gpt-image-2",
       prompt,
       image,
       size: options?.size || "1024x1024",
@@ -4529,7 +4548,7 @@ var SolanaLLMClient = class {
   /** Edit an image using img2img (Solana payment). */
   async imageEdit(prompt, image, options) {
     const body = {
-      model: options?.model || "openai/gpt-image-1",
+      model: options?.model || "openai/gpt-image-2",
       prompt,
       image,
       size: options?.size || "1024x1024",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "2.8.0",
+  "version": "2.9.1",
   "type": "module",
   "description": "BlockRun SDK - Pay-per-request AI (LLM, Image, Video, Music, Voice) via x402 on Base and Solana",
   "main": "dist/index.cjs",