Krea.ai 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

Security

This skill prioritizes security:

Credential Sources (in order of precedence)

1. CLI arguments: --key-id and --secret (for one-off use) 2. File: ~/.openclaw/credentials/krea.json

Note on Subprocess

The --usage flag uses webbrowser.open() (stdlib) to open the usage dashboard in a browser. No subprocess calls.

Setup

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

mkdir -p ~/.openclaw/credentials

3. Add your credentials:

echo '{"apiKey": "YOUR_KEY_ID:YOUR_SECRET"}' > ~/.openclaw/credentials/krea.json

4. Set secure permissions:

chmod 600 ~/.openclaw/credentials/krea.json

Usage

Command Line

# Generate an image
python3 krea_api.py --prompt "A sunset over the ocean"
With specific model
python3 krea_api.py --prompt "Cyberpunk city" --model imagen-4
Custom size
python3 krea_api.py --prompt "Portrait" --width 1024 --height 1280
List available models
python3 krea_api.py --list-models
Check recent jobs
python3 krea_api.py --jobs 10

Python Script

from krea_api import KreaAPI
api = KreaAPI()  # Reads from ~/.openclaw/credentials/krea.json
Generate and wait
urls = api.generate_and_wait(
    prompt="A serene Japanese garden",
    model="flux",
    width=1024,
    height=1024
)
print(urls)

Parameters

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | prompt | str | required | Image description (max 1800 chars) | | model | str | "flux" | Model name from table below | | 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 |

Available Models

| Model | Best For | |-------|----------| | flux | General purpose, high quality | | imagen-4 | Latest Google model | | ideogram-3.0 | Text in images | | seedream-4 | Fast generations | | nano-banana | Quick previews |

Run python3 krea_api.py --list-models for full list.

Check Usage

Krea.ai doesn't provide a public usage API. Check your usage at:

https://www.krea.ai/settings/usage-statistics

Or list recent jobs:

python3 krea_api.py --jobs 10

File Locations

| Purpose | Path | |---------|------| | Credentials | ~/.openclaw/credentials/krea.json | | Script | {skill}/krea_api.py | | Skill docs | {skill}/SKILL.md |

Troubleshooting

"API credentials required"

1. Check credentials file exists:

ls -la ~/.openclaw/credentials/krea.json
Should show: -rw-------

2. Verify format (must have colon):

{"apiKey": "KEY_ID:SECRET"}

⚠️ Security: Do NOT use cat to view the credentials file — it contains secrets.

Model not found

Run python3 krea_api.py --list-models to see available models.

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.

Command Line

# Generate an image
python3 krea_api.py --prompt "A sunset over the ocean"
With specific model
python3 krea_api.py --prompt "Cyberpunk city" --model imagen-4
Custom size
python3 krea_api.py --prompt "Portrait" --width 1024 --height 1280
List available models
python3 krea_api.py --list-models
Check recent jobs
python3 krea_api.py --jobs 10

Python Script

from krea_api import KreaAPI
api = KreaAPI()  # Reads from ~/.openclaw/credentials/krea.json
Generate and wait
urls = api.generate_and_wait(
    prompt="A serene Japanese garden",
    model="flux",
    width=1024,
    height=1024
)
print(urls)

Parameters

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | prompt | str | required | Image description (max 1800 chars) | | model | str | "flux" | Model name from table below | | 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 |

Available Models

| Model | Best For | |-------|----------| | flux | General purpose, high quality | | imagen-4 | Latest Google model | | ideogram-3.0 | Text in images | | seedream-4 | Fast generations | | nano-banana | Quick previews |

Run python3 krea_api.py --list-models for full list.

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

mkdir -p ~/.openclaw/credentials

3. Add your credentials:

echo '{"apiKey": "YOUR_KEY_ID:YOUR_SECRET"}' > ~/.openclaw/credentials/krea.json

4. Set secure permissions:

chmod 600 ~/.openclaw/credentials/krea.json

"API credentials required"

1. Check credentials file exists:

ls -la ~/.openclaw/credentials/krea.json
Should show: -rw-------

2. Verify format (must have colon):

{"apiKey": "KEY_ID:SECRET"}

⚠️ Security: Do NOT use cat to view the credentials file — it contains secrets.

Model not found

Run python3 krea_api.py --list-models to see available models.