用途：通过第三方 OpenAI 兼容接口调用 gpt-image-2 生成或编辑图像，适用于创建图片、编辑参考图、制作视觉素材、插画或图像变体。
配置：API 设置优先级为环境变量高于 .env。需配置 OPENAI_API_KEY 与 OPENAI_BASE_URL（如 http://127.0.0.1:3688/v1）。可选变量包括 OPENAI_IMAGE_MODEL（默认 gpt-image-2）、OPENAI_IMAGE_PROTOCOL（openai_images 或 openai_chat，默认 openai_images）、OPENAI_IMAGE_SIZE（默认 1024x1024）、OPENAI_IMAGE_QUALITY、OPENAI_IMAGE_N（1-10，默认 1）、OPENAI_IMAGE_OUTPUT_FORMAT、OPENAI_IMAGE_RESPONSE_FORMAT、OPENAI_IMAGE_BACKGROUND、OPENAI_IMAGE_MODERATION、OPENAI_IMAGE_OUTPUT_COMPRESSION、OPENAI_IMAGE_PARTIAL_IMAGES、OPENAI_IMAGE_INPUT_FIDELITY、OPENAI_IMAGE_STYLE、OPENAI_IMAGE_STREAM、OPENAI_IMAGE_USER、OPENAI_IMAGE_EXTRA_JSON。若缺少必要变量应停止并告知用户。
用法：使用 scripts/gpt-image-2-api.mjs。生成示例：node scripts/gpt-image-2-api.mjs --prompt "a concise image prompt" --output ./generated-images --size 1024x1024 --n 1 --output-format png。编辑时用 --image <path> 传入参考图，可重复；--input 为其别名。蒙版仅用于 openai_images 编辑：--mask <path> 或 --mask auto。当端点不支持 /images/* 时可用 OPENAI_IMAGE_PROTOCOL=openai_chat 回退，但不支持 --mask、--background、--output-format 与流式图像事件。生成文件保存到指定输出目录，未指定则保存到当前工作目录，并如实报告路径与 API 错误。
限制：脚本不硬校验尺寸，直接透传由上游决定；尺寸需满足最长边≤3840px、两边为16的倍数、宽高比≤3:1、总像素 655360 至 8294400。不同端点支持范围可能不同，具体以实际接口为准。