用途
krea-api 是一个图像生成技能，用于通过 Krea.ai 的 API 生成图片。它支持多种图像模型，包括 Flux、Imagen 4、Ideogram 3.0、Seedream 等，适合需要在自动化流程或对话式交互中调用 Krea.ai 生成图像的用户。
主要能力
- 异步任务式生成：采用 POST 提交 → 轮询 → 获取结果的流程。
- 支持多种图像模型。
- 可配置参数，包括宽度、高度、步数、引导系数、随机种子等。
- 支持 Webhook，在后台任务完成时进行通知。
- 仅依赖标准库，无需 requests。
使用方式
配置
先从 https://docs.krea.ai/developers/api-keys-and-billing 获取 Krea.ai API 凭据，然后通过以下命令配置：
clawdbot config set skill.krea_api.key_id YOUR_KEY_ID
clawdbot config set skill.krea_api.secret YOUR_SECRET
也可以直接将凭据作为参数传入。
交互模式
用户输入类似“Generate a sunset over the ocean with Flux”的指令，系统会创建图像并返回 URL。
Python 脚本
from krea_api import KreaAPI
api = KreaAPI(
key_id="your-key-id",
secret="your-secret"
)
# Generate and wait
urls = api.generate_and_wait(
prompt="A serene Japanese garden",
model="flux",
width=1024,
height=1024
)
print(urls)
可用模型（示例）
| 模型 | 端点 |
|---|---|
| flux | /generate/image/bfl/flux-1-dev |
| flux-kontext | /generate/image/bfl/flux-1-dev-kontext |
| flux-1.1-pro | /generate/image/bfl/flux-1-1-pro |
| imagen-3 | /generate/image/google/imagen-3 |
| imagen-4 | /generate/image/google/imagen-4 |
| ideogram-3.0 | /generate/image/ideogram/ideogram-3-0 |
| seedream-4 | /generate/image/seedream/seedream-4 |
查看完整列表可运行：
python3 krea_api.py --list-models
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 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 | 用于可复现的随机种子 |
| webhook_url | str | None | 完成通知的 URL |
适用场景
- 在对话式交互中按提示词生成图像并获取 URL。
- 在 Python 脚本中批量或程序化调用 Krea.ai 生成图像。
- 需要异步生成并通过 Webhook 接收完成通知的后台任务。
限制
- 需要 Krea.ai API 凭据，且需从指定文档页面获取。
- 提示词长度上限为 1800 字符。
- 宽度和高度范围为 512-2368，步数范围为 1-100，引导系数范围为 0-24。
- 关于收费、价格、具体平台支持情况等，资料暂未提供。