fix(image): stop advertising dall-e-3 and flux-1.1-pro in the OpenClaw image picker

src/index.image-provider.test.ts

@@ -0,0 +1,50 @@
+import { describe, expect, it } from "vitest";
+
+import { buildImageGenerationProvider } from "./index.js";
+import { IMAGE_MODEL_IDS } from "./proxy.js";
+
+/**
+ * The OpenClaw image UI sends the picked entry from `provider.models` straight
+ * through to `POST /v1/images/generations`, and that handler forwards the body
+ * to the gateway verbatim — no `resolveModelAlias()` pass. So every id we
+ * advertise here has to be a live gateway model id, not an alias and not a
+ * retired one, or the user's pick 400s upstream.
+ *
+ * `IMAGE_PRICING` in proxy.ts is the list that v0.12.227 kept in sync with
+ * blockrun's IMAGE_MODELS, so it is the local source of truth for "the gateway
+ * can serve this". Anything advertised but unpriced is drift.
+ */
+describe("image generation provider model list", () => {
+  const provider = buildImageGenerationProvider();
+
+  // `models` is optional on ImageGenerationProviderPlugin, so pin that we
+  // actually advertise something before asserting on its contents.
+  const models = provider.models ?? [];
+
+  it("advertises a model list", () => {
+    expect(models.length).toBeGreaterThan(0);
+  });
+
+  it("only advertises models the gateway can still serve", () => {
+    const unservable = models.filter((id) => !IMAGE_MODEL_IDS.includes(id));
+    expect(unservable).toEqual([]);
+  });
+
+  it("does not advertise models delisted upstream", () => {
+    // dall-e-3: gateway 400s ("Delisted 2026-05-25: OpenAI removed dall-e-3
+    // from the API"). flux-1.1-pro: no gateway entry at all. Both were dropped
+    // from IMAGE_PRICING and MODEL_ALIASES in v0.12.227.
+    expect(models).not.toContain("openai/dall-e-3");
+    expect(models).not.toContain("black-forest/flux-1.1-pro");
+  });
+
+  it("advertises the live successors", () => {
+    expect(models).toContain("openai/gpt-image-2");
+    expect(models).toContain("google/nano-banana-2");
+    expect(models).toContain("bytedance/seedream-5-pro");
+  });
+
+  it("advertises a default model that is itself advertised", () => {
+    expect(models).toContain(provider.defaultModel);
+  });
+});

src/index.ts

@@ -1172,17 +1172,24 @@ function parseGenArgs(raw: string): {
  * with OpenClaw's native image generation UI.
  * Delegates to the local proxy (which handles x402 payment).
  */
-function buildImageGenerationProvider(): ImageGenerationProviderPlugin {
+export function buildImageGenerationProvider(): ImageGenerationProviderPlugin {
   return {
     id: "blockrun",
     label: "BlockRun",
     defaultModel: "google/nano-banana",
+    // Must stay in sync with IMAGE_PRICING (proxy.ts). OpenClaw sends the
+    // picked id straight to /v1/images/generations, which forwards the body
+    // verbatim with no alias resolution, so a retired id here is a guaranteed
+    // upstream 400. dall-e-3 (delisted 2026-05-25) and flux-1.1-pro (no
+    // gateway entry) were dropped in v0.12.227 and had lingered here.
+    // src/index.image-provider.test.ts pins the two lists together.
     models: [
       "google/nano-banana",
+      "google/nano-banana-2",
       "google/nano-banana-pro",
       "openai/gpt-image-1",
-      "openai/dall-e-3",
-      "black-forest/flux-1.1-pro",
+      "openai/gpt-image-2",
+      "bytedance/seedream-5-pro",
       "xai/grok-imagine-image",
       "xai/grok-imagine-image-pro",
       "zai/cogview-4",

src/partners/registry.ts

@@ -636,12 +636,13 @@ export const PARTNER_SERVICES: PartnerServiceDefinition[] = [
     name: "Image Generation",
     partner: "BlockRun",
     category: "Image & Video",
-    shortDescription: "8 image models (DALL-E, Flux, Grok, ...)",
+    shortDescription: "9 image models (Nano Banana, GPT Image, ...)",
     description:
       "Generate an image from a text prompt. Models available: google/nano-banana (default), " +
-      "google/nano-banana-pro (up to 4K), openai/gpt-image-1, openai/dall-e-3, " +
-      "black-forest/flux-1.1-pro, xai/grok-imagine-image, xai/grok-imagine-image-pro, " +
-      "zai/cogview-4. Returns a local http://localhost:8402/images/<file>.png URL.",
+      "google/nano-banana-2, google/nano-banana-pro (up to 4K), openai/gpt-image-1, " +
+      "openai/gpt-image-2, bytedance/seedream-5-pro, xai/grok-imagine-image, " +
+      "xai/grok-imagine-image-pro, zai/cogview-4. " +
+      "Returns a local http://localhost:8402/images/<file>.png URL.",
     proxyPath: "/images/generations",
     method: "POST",
     params: [
@@ -655,7 +656,7 @@ export const PARTNER_SERVICES: PartnerServiceDefinition[] = [
         name: "model",
         type: "string",
         description:
-          "Full model ID (e.g. 'google/nano-banana', 'openai/dall-e-3'). Default: google/nano-banana.",
+          "Full model ID (e.g. 'google/nano-banana', 'openai/gpt-image-2'). Default: google/nano-banana.",
         required: false,
       },
       {

src/proxy.ts

@@ -1609,6 +1609,17 @@ const IMAGE_PRICING: Record<string, { default: number; sizes?: Record<string, nu
   },
 };
 
+/**
+ * Image model ids the gateway can actually serve, in picker order.
+ *
+ * Derived from IMAGE_PRICING, which v0.12.227 re-synced against blockrun's
+ * IMAGE_MODELS — so an id missing here is an id the gateway will reject.
+ * Exported so the image picker advertised by buildImageGenerationProvider
+ * (index.ts) can be pinned against it: the picked id is forwarded to
+ * /v1/images/generations verbatim, with no alias resolution in between.
+ */
+export const IMAGE_MODEL_IDS: readonly string[] = Object.freeze(Object.keys(IMAGE_PRICING));
+
 // Video pricing (must match server's VIDEO_MODELS in blockrun/src/lib/models.ts).
 // pricePerSecond is the BASE rate (no margin). estimateVideoCost applies the
 // same 5% margin server-side uses, so values land on blockrun's quote.
@@ -3869,7 +3880,7 @@ async function proxyRequest(
       if (imagegenMatch) {
         const imageArgs = lastContent.slice(imagegenMatch.length).trim();
 
-        // Parse optional flags: /cr-imagegen --model dall-e-3 --size 1792x1024 a cute cat
+        // Parse optional flags: /cr-imagegen --model gpt-image-2 --size 1536x1024 a cute cat
         let imageModel = "google/nano-banana";
         let imageSize = "1024x1024";
         let imagePrompt = imageArgs;
@@ -4022,7 +4033,7 @@ async function proxyRequest(
                         `[ClawRouter] /imagegen: failed to upload data URI: ${uploadErr instanceof Error ? uploadErr.message : String(uploadErr)}`,
                       );
                       lines.push(
-                        "Image generated but upload failed. Try again or use --model dall-e-3.",
+                        "Image generated but upload failed. Try again or use --model gpt-image-2.",
                       );
                     }
                   } else {