Krea.ai 图像生成技能

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

功能特性

• ✅ 异步任务式生成（POST → 轮询 → 获取结果）
• ✅ 支持多种图像生成模型
• ✅ 可配置参数（宽度、高度、采样步数、引导尺度、随机种子）
• ✅ 仅依赖标准库（无需 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. 创建凭据目录：

mkdir -p ~/.openclaw/credentials

3. 写入凭据内容：

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

4. 设置安全的文件权限：

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

# 查看最近的 10 个生成任务
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”（需要 API 凭据）

1. 检查凭据文件是否存在：

ls -la ~/.openclaw/credentials/krea.json
# 应显示：-rw-------

2. 确认 JSON 格式正确（必须包含冒号分隔的 key:secret）：

{"apiKey": "KEY_ID:SECRET"}

⚠️ 安全提示：请勿使用 cat 命令查看凭据文件 —— 其中包含敏感信息。

模型未找到

运行 python3 krea_api.py --list-models 查看当前支持的模型列表。

致谢

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