@blockrun/llm 2.8.0 → 2.10.0

package/README.md

@@ -299,7 +299,8 @@ Released 2026-04-23 — first fully retrained base since GPT-4.5. 1M context, 12
 ### Anthropic Claude
 | Model | Input Price | Output Price | Context | Notes |
 |-------|-------------|--------------|---------|-------|
-| `anthropic/claude-opus-4.7` | $5.00/M | $25.00/M | **1M** | Flagship — agentic coding + adaptive thinking, 128K output |
+| `anthropic/claude-opus-4.8` | $5.00/M | $25.00/M | **1M** | Flagship — agentic coding + adaptive thinking, 128K output |
+| `anthropic/claude-opus-4.7` | $5.00/M | $25.00/M | **1M** | Agentic coding + adaptive thinking, 128K output |
 | `anthropic/claude-opus-4.6` | $5.00/M | $25.00/M | 200K | Hidden but still callable — kept as in-family hot-swap fallback |
 | `anthropic/claude-opus-4.5` | $5.00/M | $25.00/M | 200K | |
 | `anthropic/claude-opus-4` | $15.00/M | $75.00/M | 200K | |
@@ -311,6 +312,7 @@ Released 2026-04-23 — first fully retrained base since GPT-4.5. 1M context, 12
 | Model | Input Price | Output Price |
 |-------|-------------|--------------|
 | `google/gemini-3.1-pro` | $2.00/M | $12.00/M |
+| `google/gemini-3.5-flash` | $0.50/M | $3.00/M |
 | `google/gemini-3.1-flash-lite` | $0.25/M | $1.50/M |
 | `google/gemini-3-flash-preview` | $0.50/M | $3.00/M |
 | `google/gemini-2.5-pro` | $1.25/M | $10.00/M |
@@ -406,7 +408,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.10.0",
   "type": "module",
   "description": "BlockRun SDK - Pay-per-request AI (LLM, Image, Video, Music, Voice) via x402 on Base and Solana",
   "main": "dist/index.cjs",