用途:通过命令行脚本调用 OpenAI 图像能力,完成生成、编辑、分析、风格迁移、修复、缩略图与批量处理等图像任务。
主要能力:generate 文生图,支持质量、尺寸、格式、透明背景、多图与压缩参数;edit 基于提示词修改图片,可用遮罩约束区域、合并多图、用 --input-fidelity 控制是否保留原图布局;describe 借助 GPT-4o 视觉输出 alt 文本、说明、详细描述、标签或结构化 JSON,也可自定义分析;bg-remove 去背景;style-transfer 提供水彩、油画、像素画、铅笔素描、动漫、波普、装饰艺术、极简、赛博朋克、彩绘玻璃等内置风格及自定义风格;restore 修复受损褪色照片;thumbnail 生成网页缩略图;batch 依据 JSON 清单批量生成或编辑,并输出索引画廊与结果摘要 JSON。
用法:先确认 OPENAI_API_KEY 已设置,必要时执行 pip install openai。基础命令如 python3 scripts/openai_image.py generate "your prompt" --output result.png;编辑用 edit 子命令加 -i 输入图;批量用 batch 加清单文件路径与 --output-dir。全局参数 --retries、--prefix、--preset(draft/balanced/final)、--dry-run 需放在子命令前。--dry-run 可在不调用 API 的情况下估算美元成本。
限制:需自备 OpenAI API Key 并联网;使用产生 API 费用,具体单价以 OpenAI 官方定价为准。DALL-E 2 与 DALL-E 3 已弃用,2026-05-12 停止服务,新工作建议用 gpt-image-1.5;透明背景需 PNG 或 WebP 格式;--input-fidelity 仅用于编辑。相关凭据配置、网络代理、错误处理与配额限制等细节暂未提供。