Krea.ai API

# Krea.ai Image Generation Skill

使用 Krea.ai 的 API 生成图像，支持包括 Flux、Imagen 4、Ideogram 3.0 在内的多种模型。

## 功能

- ✅ 基于异步作业的生成 (POST → 轮询 → 结果) - ✅ 支持多种图像模型 - ✅ 可配置参数 (宽度、高度、步数、引导系数、随机种子) - ✅ 仅依赖标准库 (不需要 `requests`) - ✅ 通过文件权限安全处理凭据

## 安全性

此技能优先考虑安全性：

- **无 Webhook 支持** - 已移除以防止 SSRF 风险 - **标准库依赖** - 最小的攻击面 (仅使用 `urllib`) - **基于文件的凭据** - 具有安全权限的主要凭据来源

### 凭据来源 (按优先级顺序)

1. **CLI 参数**：`--key-id` 和 `--secret` (用于一次性使用) 2. **文件**：`~/.openclaw/credentials/krea.json`

### 关于子进程的说明

`--usage` 标志使用 `subprocess.run(["open", ...])` 在浏览器中打开使用情况仪表板。这是该技能中唯一的子进程调用。

## 设置

1. 从 https://docs.krea.ai/developers/api-keys-and-billing 获取你的 Krea.ai API 凭据 2. 创建凭据文件： ```bash mkdir -p ~/.openclaw/credentials ```

3. 添加你的凭据： ```bash echo '{"apiKey": "YOUR_KEY_ID:YOUR_SECRET"}' > ~/.openclaw/credentials/krea.json ```

4. 设置安全权限： ```bash chmod 600 ~/.openclaw/credentials/krea.json ```

## 使用方法

### 命令行

```bash # 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 脚本

```python 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) ```

### 参数

| 参数 | 类型 | 默认值 | 描述 | |-----------|------|---------|-------------| | prompt | str | 必填 | 图像描述 (最多 1800 个字符) | | model | str | "flux" | 下表中的模型名称 | | width | int | 1024 | 图像宽度 (512-2368) | | height | int | 1024 | 图像高度 (512-2368) | | steps | int | 25 | 生成步数 (1-100) | | guidance_scale | float | 3.0 | 引导系数 (0-24) | | seed | str | None | 用于重现结果的随机种子 |

### 可用模型

| 模型 | 最适用于 | |-------|----------| | flux | 通用，高质量 | | imagen-4 | 最新的 Google 模型 | | ideogram-3.0 | 图像中的文字 | | seedream-4 | 快速生成 | | nano-banana | 快速预览 |

运行 `python3 krea_api.py --list-models` 查看完整列表。

## 检查使用情况

Krea.ai 不提供公开的使用情况 API。请在以下位置检查你的使用情况：

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

或列出最近的作业： ```bash python3 krea_api.py --jobs 10 ```

## 文件位置

| 用途 | 路径 | |---------|------| | 凭据 | `~/.openclaw/credentials/krea.json` | | 脚本 | `{skill}/krea_api.py` | | 技能文档 | `{skill}/SKILL.md` |

## 故障排除

### "需要 API 凭据"

1. 检查凭据文件是否存在： ```bash cat ~/.openclaw/credentials/krea.json ```

2. 验证权限： ```bash ls -la ~/.openclaw/credentials/krea.json # Should show: -rw------- ```

3. 检查格式 (必须有冒号)： ```json {"apiKey": "KEY_ID:SECRET"} ```

### 未找到模型

运行 `python3 krea_api.py --list-models` 查看可用模型。

## 致谢

感谢 Claude Opus 4.5 研究正确的 API 结构。文档错误地建议使用 `/v1/images/flux`，但可用的端点是 `/generate/image/bfl/flux-1-dev`。