Image Generation
When the user asks to generate, create, draw, or make an image, generate it by calling ClawRouter's image API directly — no extra setup needed.
How to Generate
POST to http://localhost:8402/v1/images/generations:
{
"model": "google/nano-banana",
"prompt": "<user's prompt>",
"size": "1024x1024",
"n": 1
}
The response contains a public image URL:
{
"created": 1741460000,
"data": [{ "url": "https://files.catbox.moe/abc123.png" }]
}
Display the image inline in your response:
Model Selection
Pick the model based on what the user asks for (or default to nano-banana):
| Model shorthand | Full ID | Price | Best for |
|---|---|---|---|
nano-banana | google/nano-banana | $0.05 | Default — fast, cheap, good quality |
banana-pro | google/nano-banana-pro | $0.10 | High-res up to 4096×4096 |
dall-e-3 | openai/dall-e-3 | $0.04 | Photorealistic, complex scenes |
gpt-image | openai/gpt-image-1 | $0.02 | Budget option |
flux | black-forest/flux-1.1-pro | $0.04 | Artistic styles, fewer restrictions |
If the user mentions "high res" or "large", use banana-pro. If they want "photorealistic" or "dall-e", use dall-e-3. Otherwise default to nano-banana.
Size Options
Default is 1024x1024. Adjust based on user request:
- Portrait:
1024x1792 - Landscape:
1792x1024(dall-e-3) or1216x832(nano-banana / flux) - High-res: up to
4096x4096withbanana-proonly
Example Interactions
User: Draw me a golden retriever surfing on a wave
→ Call nano-banana with prompt "a golden retriever surfing on a wave", display the image.
User: Generate a high-res mountain landscape, landscape format
→ Call banana-pro with size 1024x1024 (max varies by model), prompt "mountain landscape".
User: Make a cyberpunk city with dall-e
→ Call dall-e-3 with prompt "a futuristic cyberpunk city".
Notes
- Payment is automatic via x402 — deducted from the user's BlockRun wallet
- If the call fails with a payment error, tell the user to fund their wallet at blockrun.ai
- DALL-E 3 applies OpenAI content policy; use
fluxornano-bananafor more flexibility - Google models may return base64 — ClawRouter handles uploading automatically, you'll get a URL back