📦 img2-generate-only — 仅生成图像（img2）

IMG2 Generate Only Skill 定位 这是一个纯单图生图 Skill。 它只做一件事： prompt → 调用 IMG2 / gpt-image-2 → 本地落盘 → 返回结构化结果 它不依赖任何历史本地配置，也不包含你们之前环境里的私有 provider 配置。 使用时必须由用户或工作流显式提供入参。 它不负责： 飞书发送 云盘上传 批量并发 文章排版 公众号推送 执行脚本 python3 /home/ye/.openclaw/workspace/scripts/img2_generate_only.py 绝对必填参数 下面这些参数必须由用户显式提供： 1）prompt 最终图片提示词。 2）base_url 图片接口基础地址。 例如： https://your-api.example.com/v1 脚本会自动请求： {base_url}/images/generations 3）api_key 接口密钥。 例如： sk-xxxx 4）model 图片模型名称。 当前标准推荐： gpt-image-2 5）size 图片尺寸。 例如： 1024x1024 6）task_name 任务名，用于输出文件命名。 7）timeout_ms 单张图最长等待时间，单位毫秒。 推荐： 300000 可选参数 8）output_dir 图片输出目录。 默认： /tmp/generated-images 9）response_format 返回格式。 默认推荐： b64_json 10）n 生成数量。 当前这个 Skill 只支持单图，必须为： 1 11）return_base64 是否在结果中返回 base64。 默认： false 一般不建议开启，返回 image_path 更稳。 标准输入 JSON { "prompt": "一只毛茸茸的橘猫坐在窗边，真实摄影风格，阳光柔和，无文字，无水印", "base_url": "https://your-api.example.com/v1", "api_key": "sk-xxxx", "model": "gpt-image-2", "size": "1024x1024", "task_name": "orange-cat-window", "timeout_ms": 300000, "output_dir": "/tmp/generated-images", "response_format": "b64_json", "n": 1, "return_base64": false } 命令行调用示例 JSON 方式 python3 /home/ye/.openclaw/workspace/scripts/img2_generate_only.py '{ "prompt": "一只毛茸茸的橘猫坐在窗边，真实摄影风格，阳光柔和，无文字，无水印", "base_url": "https://your-api.example.com/v1", "api_key": "sk-xxxx", "model": "gpt-image-2", "size": "1024x1024", "task_name": "orange-cat-window", "timeout_ms": 300000, "output_dir": "/tmp/generated-images", "response_format": "b64_json", "n": 1, "return_base64": false }' CLI 参数方式 python3 /home/ye/.openclaw/workspace/scripts/img2_generate_only.py \ --prompt "一只毛茸茸的橘猫坐在窗边，真实摄影风格，阳光柔和，无文字，无水印" \ --base_url "https://your-api.example.com/v1" \ --api_key "sk-xxxx" \ --model gpt-image-2 \ --size 1024x1024 \ --task_name orange-cat-window \ --timeout_ms 300000 \ --output_dir /tmp/generated-images 成功输出 { "ok": true, "stage": "done", "image_path": "/tmp/generated-images/orange-cat-window-20260508-094000.png", "bytes": 1544093, "base_url": "https://your-api.example.com/v1", "model": "gpt-image-2", "size": "1024x1024" } 如果 return_base64=true，还会额外返回： { "b64": "..." } 失败输出 失败时返回结构化 JSON： { "ok": false, "stage": "request", "http_status": 502, "upstream_error_type": "upstream_error", "upstream_error_message": "Upstream request failed", "error": "脱敏后的错误信息", "diagnosis": { "category": "upstream_failure", "human_reason": "图片模型上游服务失败或临时不可用；不是本地脚本问题。", "retryable": true } } 失败诊断字段 工作流建议读取： ok stage http_status upstream_error_type upstream_error_message diagnosis.category diagnosis.human_reason diagnosis.retryable 这个 Skill 的边界 这个 Skill 只负责单张图生成。 如果用户需要： 多张图批量生成 受控并发 队列监控 state.json / batch_result.json 那么应该使用单独的批量调度器，而不是把这些逻辑塞进这个单图 Skill 里。 一句话定义 这是一个纯独立单图 IMG2 生图节点：用户必须显式提供 prompt + base_url + api_key + model + size + task_name + timeout_ms，脚本返回本地图片路径和结构化状态。