核心用法
Krea API 技能提供完整的图像生成能力,采用异步作业模式(POST 提交 → 轮询状态 → 获取结果)。支持通过命令行或 Python 脚本调用,可配置模型、尺寸、步数、引导强度等参数。
命令行示例:
- 基础生成:
python3 krea_api.py --prompt "描述文本" - 指定模型:
--model imagen-4或--model ideogram-3.0 - 自定义尺寸:
--width 1024 --height 1280
Python API:
from krea_api import KreaAPI api = KreaAPI() urls = api.generate_and_wait(prompt="...", model="flux")
显著优点
1. 模型多样性:覆盖 Flux(通用)、Imagen 4(Google 最新)、Ideogram 3.0(文本渲染)、Seedream 4(快速生成)等
2. 安全设计:移除 webhook 支持消除 SSRF 风险,仅使用标准库(urllib)减少依赖攻击面
3. 凭证管理:文件优先策略,支持 ~/.openclaw/credentials/krea.json 安全存储,权限强制 600
4. 无外部依赖:纯标准库实现,避免 requests 等第三方包的安全隐患
潜在局限
- 无原生用量 API:需手动访问网页仪表板查看配额
- 异步轮询开销:相比同步 API 有额外延迟
- 凭证格式严格:必须包含冒号分隔的
KEY_ID:SECRET格式 - 单一次进程调用:
--usage标志使用open命令启动浏览器(非安全敏感操作)
适合人群
- 需要多模型图像生成的开发者与设计师
- 注重供应链安全、希望最小化依赖的用户
- 已有 Krea.ai 账户并获取 API 凭证的创作者
常规风险
- 凭证泄露:JSON 文件需严格设置 600 权限,避免多用户系统暴露
- API 端点变更:官方文档与实际端点存在差异(如
/v1/images/fluxvs/generate/image/bfl/flux-1-dev),需关注上游更新 - 速率限制:高频调用可能触发平台限流,建议合理控制并发