krea-api 是一个用于调用 Krea.ai 图像生成 API 的技能,基于 Python 实现,可借助 Krea.ai 的多款图像模型生成图片。
用途方面,该技能面向需要通过 API 程序化生成图像的任务,支持包括 Flux、Imagen 4、Ideogram 3.0、Seedream 等在内的多个模型,模型示例及对应端点如下: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 查看。
主要能力包括:采用异步任务式生成流程(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 进行配置,也可直接将凭据作为参数传入。在交互模式下,用户提出生成需求后即创建图像并返回 URL。在 Python 脚本中,可导入 KreaAPI 类并使用 generate_and_wait 方法,例如传入 prompt、model、width、height 等参数,打印返回的 URL 列表。可用参数包括:prompt(字符串,必填,图像描述,最大 1800 字符)、model(字符串,默认 "flux")、width(整数,默认 1024,范围 512-2368)、height(整数,默认 1024,范围 512-2368)、steps(整数,默认 25,范围 1-100)、guidance_scale(浮点数,默认 3.0,范围 0-24)、seed(字符串,默认 None,用于可复现性)、webhook_url(字符串,默认 None,用于完成通知)。
适用场景为需要在自动化流程、脚本或对话式工具中调用 Krea.ai 生成图像的场合。限制方面,资料未提供价格、计费方式、速率限制、并发能力或生成质量的明确说明,暂未提供相关信息。