核心用法
image_gen_coze 是一个封装了 Coze 图像生成能力的技能,通过调用 coze_workflow 执行底层工作流。用户只需提供自然语言 Prompt,即可调用 Seedream 4.5 模型生成图像,并自动完成下载与本地存储。
调用流程:
1. 读取 workflow_id 配置与 Coze API 凭证
2. 构建请求参数(支持 --ar 比例参数)
3. 通过 coze_workflow 发送流式请求
4. 解析响应提取图片 URL
5. 自动下载至 ./generated_images/ 目录,按 {时间戳}_{prompt前缀}.png 命名
显著优点
- 零配置即用:只需填写 workflow_id,无需关心 Coze API 细节
- 智能文件管理:自动生成规范文件名,多 Agent 隔离存储
- 风格比例可控:支持
--ar 1:1/16:9/9:16及多种风格关键词 - 结果可追踪:返回 execute_id 便于调试
潜在局限
- 强依赖外部服务:完全依赖 Coze 平台可用性与 Seedream 4.5 模型质量
- 速率限制严格:30秒/次,高频场景需自行实现队列或缓存
- 无图像编辑能力:仅支持文生图,不支持图生图、局部重绘等进阶功能
- Prompt 长度敏感:前缀截取仅 10 字符,复杂场景文件名信息不足
适合人群
- 需要快速集成图像生成到 Agent 工作流的开发者
- 追求"配置即运行"、不愿维护自建 Stable Diffusion 服务的团队
- 中文场景优先、接受 Coze 生态绑定的用户
常规风险
- API 密钥泄露风险:
coze_workflow/config.json存储敏感凭证,需确保文件权限(建议 600) - 依赖版本锁定:
coze_workflow v1.1.1+为硬性依赖,升级需同步验证 - 生成内容合规:Seedream 4.5 存在内容过滤机制,敏感 Prompt 可能返回空结果
- 存储占用累积:自动保存策略未配置自动清理,长期运行需监控磁盘