Krea.ai API

核心功能

Krea.ai Image Generation Skill 是一个面向开发者的异步图像生成接口封装，支持调用 Krea.ai 平台的多款前沿 AI 图像模型。

显著优点：

• 模型覆盖全面：集成 Flux 系列（含 1.1 Pro、Kontext 变体）、Google Imagen 3/4、Ideogram 3.0、Seedream 4 等业界领先模型
• 异步架构设计：采用 POST → 轮询 → 结果的标准异步流程，配合 webhook 支持后台任务完成通知，适合生产环境
• 零外部依赖：仅使用 Python 标准库实现 HTTP 通信，避免 requests 等第三方库的依赖管理问题
• 灵活参数配置：支持尺寸（512-2368px）、步数（1-100）、引导尺度（0-24）、随机种子等精细化控制

潜在局限：

• 需自行处理轮询逻辑，无内置自动重试或退避机制
• API 文档与实际端点存在偏差（如 /v1/images/flux 实际无效），需依赖社区勘误
• 字符限制严格（prompt 上限 1800 字符），长文本场景需预处理
• 商业 API 需付费，无免费额度说明

适合人群：

• 需要批量/自动化图像生成的开发者与创意团队
• 追求多模型对比、A/B 测试的视觉设计师
• 构建 AI 工作流（如与 LLM 联动）的技术用户

常规风险：

• API 密钥需妥善保管，避免硬编码提交至版本控制
• 异步任务可能因队列拥堵导致延迟，生产环境需设置超时兜底
• 生成内容需遵守 Krea.ai 平台的内容政策与版权规范

核心功能与用法

Krea-api 是一个轻量级的 Krea.ai 图像生成服务封装，采用纯 Python 标准库实现，无需额外依赖。核心功能包括：

• 多模型支持：覆盖 Flux 系列（flux-1-dev、flux-1.1-pro、flux-kontext）、Google Imagen 3/4、Ideogram 3.0、Seedream 4 等主流文生图模型
• 异步任务模式：采用 POST 提交任务 → 轮询状态 → 获取结果的流程，避免长连接阻塞
• 灵活参数配置：支持分辨率（512-2368px）、生成步数（1-100）、引导系数（0-24）、随机种子等细粒度控制
• Webhook 回调：可选配置结果通知地址，适合后台自动化场景

使用示例

from krea_api import KreaAPI
api = KreaAPI(key_id="xxx", secret="yyy")
urls = api.generate_and_wait(
    prompt="A serene Japanese garden",
    model="flux",
    width=1024, height=1024
)

显著优点

1. 零依赖设计：仅使用 urllib、json、subprocess 等标准库，彻底规避供应链攻击风险
2. 代码精简：仅 223 行/4 文件，结构清晰易于审计
3. 安全编码规范：无硬编码密钥、无危险函数调用、输入参数有边界验证
4. GDPR 合规：遵循数据最小化原则，仅传输必要的生成参数

局限性与风险

| 方面 | 说明 |

|------|------|

| **T3 来源** | 开发者 fossilizedcarlos 为个人账号，无企业背书，建议代码审查后使用 |

| **数据出境** | 所有 prompt 和生成参数需发送至 Krea.ai 服务器（美国/海外节点），涉及数据跨境 |

| **Webhook 风险** | 用户自定义回调 URL 若配置不当，可能导致生成结果泄露至第三方 |

| **功能依赖** | 完全依赖 Krea.ai 服务可用性，无本地降级方案 |

适合人群

• 需要快速接入多模型图像生成的自动化脚本开发者
• 注重依赖安全、希望避免臃肿依赖链的技术团队
• 已通过 Krea.ai 企业合规审查的国际化业务场景

常规风险提示

• API 凭证保管：通过 clawdbot config 存储的密钥需确保文件权限安全（推荐 600）
• Prompt 内容审查：避免发送含敏感个人数据（PII）或商业机密的提示词
• Webhook 端点验证：仅使用 HTTPS 且已验证身份的服务端点，防止中间人窃取生成结果