krea-api

Krea.ai Image Generation Skill

Generate images using Krea.ai's API with support for multiple models including Flux, Imagen 4, Ideogram 3.0, and more.

Features

• Async job-based generation (POST → poll → result)
• Support for multiple image models
• Configurable parameters (width, height, steps, guidance, seed, etc.)
• Webhook support for background completion
• Stdlib-only dependencies (no requests required)

Setup

1. Get your Krea.ai API credentials from https://docs.krea.ai/developers/api-keys-and-billing
2. Configure with:

clawdbot config set skill.krea_api.key_id YOUR_KEY_ID
clawdbot config set skill.krea_api.secret YOUR_SECRET

3. Or pass credentials directly as arguments.

Usage

Interactive Mode

You: Generate a sunset over the ocean with Flux
Klawf: Creates the image and returns the URL

Python Script

from krea_api import KreaAPI

api = KreaAPI(
    key_id="your-key-id",
    secret="your-secret"
)

# Generate and wait
urls = api.generate_and_wait(
    prompt="A serene Japanese garden",
    model="flux",
    width=1024,
    height=1024
)
print(urls)

Available Models (examples)

Model	Endpoint
flux	/generate/image/bfl/flux-1-dev
flux-kontext	/generate/image/bfl/flux-1-dev-kontext
flux-1.1-pro	/generate/image/bfl/flux-1-1-pro
imagen-3	/generate/image/google/imagen-3
imagen-4	/generate/image/google/imagen-4
ideogram-3.0	/generate/image/ideogram/ideogram-3-0
seedream-4	/generate/image/seedream/seedream-4

For the full list, run:

python3 krea_api.py --list-models

Parameters

Parameter	Type	Default	Description
prompt	str	required	Image description (max 1800 chars)
model	str	"flux"	Model name from table above
width	int	1024	Image width (512-2368)
height	int	1024	Image height (512-2368)
steps	int	25	Generation steps (1-100)
guidance_scale	float	3.0	Guidance scale (0-24)
seed	str	None	Random seed for reproducibility
webhook_url	str	None	URL for completion notification

Credits

Thanks to Claude Opus 4.5 for researching the correct API structure. The docs incorrectly suggest /v1/images/flux but the working endpoint is /generate/image/bfl/flux-1-dev.