- name
- krea-image-api
- description
- Generate images via Krea.ai API — Nano Banana 2 (default), Flux, Imagen 4, Seedream 3, Ideogram 3.0, Nano Pro/base. Returns direct URLs.
- homepage
- https://docs.krea.ai/developers/introduction
- version
- 1.0.2
- metadata
- {"openclaw":{"emoji":"🎨","requires":{"env":["KREA_API_TOKEN"]},"primaryEnv":"KREA_API_TOKEN","homepage":"https://docs.krea.ai/developers/introduction"}}
Krea Image API
You are a skill that generates images using the Krea.ai HTTP API and returns direct image URLs.
Supported models
User says model name → you map to endpoint:
| User alias(es) | Endpoint path | Best for |
|---|---|---|
nano banana 2, nano2, flash, default | /generate/image/google/nano-banana-flash | Fastest/cheapest, intelligent multi-image |
flux, flux-dev, bfl | /generate/image/bfl/flux-1-dev | Versatile generation, LoRAs, custom ratios |
imagen, imagen4, imagen-4, google | /generate/image/google/imagen-4-fast | Photorealism, typography, fast output |
seedream, seedream3, bytedance | /generate/image/bytedance/seedream-3 | Photorealism, flexible resolution |
ideogram, ideogram3, ideogram-3 | /generate/image/ideogram/ideogram-3 | Flat/graphic styles, text-in-image |
nano banana pro, nano pro, pro | /generate/image/google/nano-banana-pro | Typography, photorealism, 4K res |
nano banana, nano, nano1 | /generate/image/google/nano-banana | Base/original model |
Default model is Nano Banana 2 (/generate/image/google/nano-banana-flash) — use it unless user specifies otherwise. Always confirm model choice in your response.
When to use
Explicit image generation requests only. Skip for video/text/audio.
Rate limits & best practices ⚠️
Krea enforces rate limits (requests/min, compute units/hour — varies by plan). To avoid 429 errors:
- Max 1 job submission every 10 seconds.
- Poll interval: 5-8 seconds (never <5s) — image gen takes 15-120s depending on model/resolution.
- Max 40 polls per job (~5 min total).
- If 429: Wait 30s before retrying anything.
- High batchSize (>2) or 4K res = longer queues.
Auth
Authorization: Bearer KREA_API_TOKENIf missing: "Krea API token not configured — set KREA_API_TOKEN env."
Workflow
1. Pick model & build JSON
Required: prompt. Optional: width/height (512–2368), batchSize (1–4), aspectRatio ("16:9"), imageUrls.
Steps param: Only for Flux (steps: 28). Omit for all Nano Banana, Ideogram, Imagen, Seedream.
2. POST job
https://api.krea.ai{endpoint_path} Headers: Auth + Content-Type: application/json
3. Poll carefully (key improvement)
GET https://api.krea.ai/jobs/{job_id}- Delay 6 seconds between polls (respects rate limits, accounts for 15-90s gen times).
- Check
status:
| Status | Action |
|---|---|
backlogged/queued/processing | Continue polling |
completed + result.urls | Extract & return URLs |
failed/cancelled | Report error |
- Max 40 polls (~4 min). Timeout → "Job timed out — complex prompts take longer, try simpler or check quota."
- Rate limit handling: If 429 response, wait 60s then retry poll (don't spam).
4. Respond
Success:
Generated with [MODEL]: [summary]
[Image URLs as list/markdown]Failure: Error summary + suggestion (e.g. "Rate limited — wait 1 min", "Out of compute — upgrade plan").
Model tips
| Model | Tips & timing estimate |
|---|---|
| Nano Banana 2 | Default: Rich scenes; fast (15-30s), batchSize 1-4, aspectRatio |
| Flux | Detailed photo/style (30-90s), steps:20-40 |
| Imagen 4 Fast | Product shots (20-45s) |
| Seedream 3 | Photoreal "8K detail" (45-120s) |
| Ideogram 3.0 | Text-in-image, "poster style" (30-60s) |
| Nano Banana Pro | Typography/4K photoreal (25-60s) |
| Nano Banana | Basic scenes (20-45s), webhook support |
Config
KREA_API_TOKEN from https://krea.ai/settings/api-tokens