名称： krea-api
描述： 通过 Krea.ai API 生成图像（支持 Flux、Imagen、Ideogram、Seedream 等模型）
版本： 0.2.4
元数据：
credentials:
- id: krea
description: Krea.ai API 密钥（格式：KEY_ID:SECRET）
envVar: null
file: ~/.openclaw/credentials/krea.json
required: true

Krea.ai 图像生成技能

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

功能特性

• ✅ 基于异步任务的生成流程（提交 → 轮询 → 获取结果）
• ✅ 支持多种图像生成模型
• ✅ 可配置参数（宽度、高度、步数、引导系数、种子）
• ✅ 仅依赖标准库（无需 requests）
• ✅ 安全的凭据处理与文件权限管理

安全性

本技能高度重视安全性：

• 不支持 Webhook - 已移除，以防止 SSRF 风险
• 仅使用标准库 - 最小化攻击面（仅使用 urllib）
• 基于文件的凭据 - 主要凭据来源，并设置安全权限
• 输入验证 - 所有参数在调用 API 前均经过验证

凭据来源（优先级从高到低）

1. 命令行参数：--key-id 和 --secret（适用于一次性使用）
2. 文件：~/.openclaw/credentials/krea.json

关于子进程的说明

--usage 标志使用 webbrowser.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

使用方法

命令行

# 生成图像
python3 krea_api.py --prompt "海上日落"

# 指定模型
python3 krea_api.py --prompt "赛博朋克城市" --model imagen-4

# 自定义尺寸
python3 krea_api.py --prompt "肖像" --width 1024 --height 1280

# 列出可用模型
python3 krea_api.py --list-models

# 查看近期任务
python3 krea_api.py --jobs 10

Python 脚本

from krea_api import KreaAPI

api = KreaAPI()  # 从 ~/.openclaw/credentials/krea.json 读取凭据

# 生成并等待结果
urls = api.generate_and_wait(
    prompt="宁静的日式庭院",
    model="flux",
    width=1024,
    height=1024
)
print(urls)

参数说明

可用模型

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

查看使用情况

Krea.ai 未提供公开的使用情况 API。请访问以下链接查看：

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

或列出近期任务：

python3 krea_api.py --jobs 10

文件位置

故障排除

错误："API credentials required"

1. 检查凭据文件是否存在：
   bash ls -la ~/.openclaw/credentials/krea.json # 应显示：-rw-------
2. 验证文件格式（必须包含冒号）：
   json {"apiKey": "KEY_ID:SECRET"}
   ⚠️ 安全提示：请勿使用 cat 命令查看凭据文件内容，其中包含密钥。

错误："Model not found"

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

致谢

感谢 Claude Opus 4.5 协助研究正确的 API 结构。官方文档错误地建议使用 /v1/images/flux，但实际有效的端点是 /generate/image/bfl/flux-1-dev。