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:

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

Config

KREA_API_TOKEN from https://krea.ai/settings/api-tokens