Image Generation

图像生成（image-generation） 通过单一的CLI网关，使用异步轮询和自动下载，可以从文本提示生成图像、创建图片、绘制图形或制作视觉效果。该技能遵循单一聚合网关后端模型。一个API密钥用于本地，而多个模型则在网关后面聚合。CLI包装了完整的异步流程：提交任务 -> 轮询任务状态 -> 获取数据图像。后端平台是一个固定的实现选择，而不是一个可配置的提供者开关。如果需要另一个平台，请发布一个单独的技能。设计目标是实现常见工作流程的平滑自动化，例如单图像生成、多文件提示、图像到图像的引用、批处理作业、EXTEND默认值和可重用的样式预设。完整的网关对齐说明请参阅references/weryai-platform.md。

安全和范围网络： 该技能通过HTTPS（https://api.weryai.com）调用WeryAI网关。 身份验证：使用IMAGE_GEN_API_KEY。密钥永远不会被打印，只有在显式运行npm run setup -- --persist-api-key时才会被持久化。 参考图像：必须是公共URL（推荐https://）。http://可能有效，但不安全。本地文件路径和数据URL将被拒绝。 不执行任意shell命令：生成运行时不执行任意shell命令。 写入文件：输出图像和可选的本地配置文件位于.image-skills/image-generation/（项目）和/或~/.image-skills/image-generation/（主目录）。

当前网关契约（WeryAI） 项目契约 基础URL https://api.weryai.com（在scripts/main.ts中硬编码） 身份验证 通过IMAGE_GEN_API_KEY的Bearer令牌（获取密钥） 文本到图像 POST /v1/generation/text-to-image；需要模型、提示、宽高比 图像到图像 POST /v1/generation/image-to-image；还需要图像[] 状态查找 GET /v1/generation/{taskId}/status；任务状态为等待、处理、成功或失败 业务成功 成功：true（或状态：200）；失败返回业务代码，例如1001、1002、1003 文本长度 脚本在请求提交之前验证提示和负面提示的长度 结果下载 在成功后，通过URL获取图像；脚本使用超时、重试、回退、可选的Bearer重试和最小有效负载验证 请参阅references/weryai-platform.md以获取字段映射、模型查找指南和故障排除流程。

步骤0：首次触发准备网关 当该技能在项目或环境中首次被触发时，代理不得直接跳转到模型选择或生成。它必须先执行以下操作： 使用npm run ensure-ready -- --project . --workflow 静默检查本地准备就绪 如果运行时依赖项缺失，建议在用户的 behalf 安装它们 如果IMAGE_GEN_API_KEY缺失，询问用户是否现在配置它 只有在准备就绪和API密钥得到解决后，才继续模型选择/提示澄清/生成 访问令牌：仅使用IMAGE_GEN_API_KEY。它也可以在.image-skills/image-generation/.env中作为IMAGE_GEN_API_KEY=...存在。 在用户批准后，代理可以通过运行npm run setup -- --project . --workflow --persist-api-key持久化它，当密钥已经在环境中时，或者通过在用户的 behalf 上写入文件来代替手动编辑文件。

首次使用准备检查： 在新OpenClaw或本地实例的第一次生成运行之前，代理必须运行： npm run ensure-ready -- --project . --workflow 此准备步骤不是可选的。它检查本地工具链，读取本地医生报告，并在本地脚本依赖项缺失时自动运行引导程序。 首次触发用户行为： 如果依赖项缺失：询问批准安装它们，然后静默安装 如果IMAGE_GEN_API_KEY缺失：告诉用户图像生成需要API密钥，并提供现在配置它的选项，通过在用户的 behalf 上写入.image-skills/image-generation/.env 在准备网关运行之前，不要询问用户调试环境 在准备就绪和API密钥得到解决之前，不要询问用户选择模型 将API密钥视为机密：更喜欢在用户的 behalf 上写入它们，永远不要回显它们，并且永远不要在正常进度消息中包含它们 EXTEND.md是可选的，可以包含默认模型、质量、宽高比和批处理工作者限制。 测试-f .image-skills/image-generation/EXTEND.md && echo 项目 测试-f "$HOME/.image-skills/image-generation/EXTEND.md" && echo 用户 默认模型初始化： 如果尚未配置模型，则使用Nano Banana 2（GEMINI_3_1_FLASH_IMAGE）初始化此技能，并告诉用户它现在是默认值。 还提醒他们可以随时更改模型。 模型选择： 在初始化后，以下提供了活动默认值： --model default_model在EXTEND.md中 IMAGE_GEN_DEFAULT_MODEL 如果它们都尚未设置，代理应初始化本地默认值。