用途:批量调用 OpenAI Images API 生成图片,内置随机但结构化的提示词采样器,方便快速产出多张图像并附带可浏览的画廊页面。
主要能力:支持 GPT 图像模型(gpt-image-1、gpt-image-1-mini、gpt-image-1.5)及 dall-e-3、dall-e-2,可通过参数指定数量、提示词、尺寸、质量、风格、背景与输出格式。脚本会按模型自动选择合适默认值:dall-e-3 因 n=1 限制自动把 count 限制为 1;GPT 图像模型额外支持 --background(transparent/opaque/auto)与 --output-format(png/jpeg/webp);dall-e-3 支持 --style(vivid/natural)。stream 与 moderation 在 API 可用但脚本尚未实现。
使用方式:运行 python3 {baseDir}/scripts/gen.py,然后打开输出目录中的 index.html(如 ~/Projects/tmp/openai-image-gen-*/index.html,若该路径不存在则为 ./tmp/...)。常用示例:python3 {baseDir}/scripts/gen.py --count 16 --model gpt-image-1;python3 {baseDir}/scripts/gen.py --prompt "ultra-detailed studio photo of a lobster astronaut" --count 4;python3 {baseDir}/scripts/gen.py --size 1536x1024 --quality high --out-dir ./out/images;python3 {baseDir}/scripts/gen.py --model gpt-image-1.5 --background transparent --output-format webp;python3 {baseDir}/scripts/gen.py --model dall-e-3 --quality hd --size 1792x1024 --style vivid;python3 {baseDir}/scripts/gen.py --model dall-e-2 --size 512x512 --count 4。
输出:图片文件(png/jpeg/webp,取决于模型与 --output-format)、prompts.json(提示词到文件映射)与 index.html 画廊。
限制:图像生成可能超过常见执行超时,通过 OpenClaw 的 exec 工具调用时建议调高 timeout(例如 exec timeout=300)以避免中断或重试;未提供 API 密钥配置、计费与平台信息。