ImagegenSAFE

The agent-native LLM router for autonomous agents. Every frontier model behind one wallet, <1ms local routing, USDC payments on Base & Solana via x402.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: imagegen
description: Generate or edit images via BlockRun's image API. Trigger when the user asks to generate, create, draw, make an image — or to edit, modify, change, or retouch an existing image.
triggers:
  - "blockrun image"
  - "blockrun image generation"
  - "clawrouter image"
  - "generate image via blockrun"
  - "blockrun ai art"
  - "blockrun seedream"
  - "blockrun nano banana"
  - "blockrun cogview"
  - "blockrun grok imagine"
  - "edit image via blockrun"
  - "inpainting via blockrun"
  - "x402 image generation"
  - "usdc image generation"
metadata: { "openclaw": { "emoji": "🖼️", "requires": { "config": ["models.providers.blockrun"] } } }
---

# Image Generation & Editing

Generate or edit images through ClawRouter. Payment is automatic via x402.

**Shortcuts:**

- Slash: `/cr-imagegen <prompt> [--model=<alias>] [--size=1024x1024] [--n=1]` (`/imagegen` still accepted in chat for backward compatibility)
- Partner tool: `blockrun_image_generation` (LLM-callable) / `blockrun_image_edit` (inpainting)

---

## Generate an Image

POST to `http://localhost:8402/v1/images/generations`:

```json
{
  "model": "google/nano-banana",
  "prompt": "a golden retriever surfing on a wave",
  "size": "1024x1024",
  "n": 1
}
```

Response:

```json
{
  "created": 1741460000,
  "data": [{ "url": "http://localhost:8402/images/abc123.png" }]
}
```

Display inline: `![generated image](http://localhost:8402/images/abc123.png)`

### Model Selection

| Alias              | Full ID                         | Price        | Sizes                           | Best for                                                                                                           |
| ------------------ | ------------------------------- | ------------ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `nano-banana`      | `google/nano-banana`            | $0.05        | 1024×1024                       | Default — fast, cheap, good quality                                                                                |
| `banana-2`         | `google/nano-banana-2`          | $0.09        | 1024×1024                       | Gemini 3.1 Flash imagegen — sharper than nano-banana at 1K                                                         |
| `banana-pro`       | `google/nano-banana-pro`        | $0.10–$0.15  | 1024×1024, 2048×2048, 4096×4096 | High-res, large format                                                                                             |
| `gpt-image`        | `openai/gpt-image-1`            | $0.02–$0.04  | 1024×1024, 1536×1024, 1024×1536 | Budget option; supports editing                                                                                    |
| `gpt-image-2`      | `openai/gpt-image-2`            | $0.06–$0.12  | 1024×1024, 1536×1024, 1024×1536 | Photorealistic, reasoning-driven, text rendering (slow — proxy polls up to 5min); legacy `dalle` alias routes here |
| `flare`            | `openai/gpt-image-2.5-flare`    | $0.28–$0.56  | 1024×1024, 1536×1024, 1024×1536 | GPT Image 2.5, fast — top OpenAI quality, caller can pick `quality` at a flat price                                |
| `sunburst`         | `openai/gpt-image-2.5-sunburst` | $0.28–$0.56  | 1024×1024, 1536×1024, 1024×1536 | GPT Image 2.5, precision — best for high-fidelity edits                                                            |
| `seedream`         | `bytedance/seedream-5-pro`      | $0.045–$0.09 | up to 2848×1600 / 2304×1728     | Flagship quality, reference-image support                                                                          |
| `grok-imagine`     | `xai/grok-imagine-image`        | $0.02        | 1024×1024                       | xAI Grok image style                                                                                               |
| `grok-imagine-2`   | `xai/grok-imagine-image-2.0`    | $0.04        | 1024×1024                       | Grok Imagine 2.0 — between grok-imagine and pro                                                                    |
| `grok-imagine-pro` | `xai/grok-imagine-image-pro`    | $0.07        | 1024×1024                       | Grok high-quality                                                                                                  |
| `cogview`          | `zai/cogview-4`                 | $0.015–$0.02 | 512×512 to 1440×1440            | Cheapest — Zhipu CogView                                                                                           |

**Choosing a model:**

- Default → `nano-banana`
- "high res" / "large" → `banana-pro`
- "photorealistic" / complex scenes → `gpt-image-2`
- "flagship quality" / reference image → `seedream`
- "budget" / "cheap" → `cogview`
- "top quality" / "best OpenAI" → `flare` (fast) or `sunburst` (precision)
- "editable" / "inpainting" → `gpt-image` (cheapest), `gpt-image-2`, or `sunburst` (most precise)
- "artistic" / flexible content → `grok-imagine`
- "grok style" → `grok-imagine` or `grok-imagine-pro`

**Choosing a size:**

- Default: `1024x1024` (the only size every model accepts)
- Portrait: `1024x1536` (gpt-image / gpt-image-2 / flare / sunburst) or `1728x2304` (seedream)
- Landscape: `1536x1024` (gpt-image / gpt-image-2 / flare / sunburst), `1344x768` (cogview), or `2048x1024` / `1280x720` (seedream)
- High-res: `2048x2048` / `4096x4096` with `banana-pro`; `2848x1600` with `seedream`
- The gateway validates size per model BEFORE payment and rejects unknown ones — do not invent sizes outside each model's list above

---

## Edit an Existing Image

POST to `http://localhost:8402/v1/images/image2image`:

```json
{
  "model": "openai/gpt-image-1",
  "prompt": "make the background a snowy mountain landscape",
  "image": "https://example.com/photo.jpg",
  "size": "1024x1024",
  "n": 1
}
```

ClawRouter automatically downloads URLs and reads local file paths — pass them directly, no manual ba

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.