# Krea Image API

> Generate images via Krea.ai API — Nano Banana 2 (default), Flux, Imagen 4, Seedream 3, Ideogram 3.0, Nano Pro/base. Returns direct URLs.

- Skill: `dvcrn/krea-image-api` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dvcrn/krea-image-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/krea-image-api/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/krea-image-api

---


# 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_TOKEN
```

If 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