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: ```bash 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 ```python 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: ```bash 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`.