GPT 图像
通过此技能内建的辅助工具,使用OpenAI的gpt-image-2图像API生成图像。
设置
- 优先使用
uv;脚本已内联声明其openai依赖。 - 否则,请在此技能目录中运行
python3 -m pip install -r requirements.txt安装openai。 - 环境中需要设置
GPT_API_KEY或OPENAI_API_KEY。 - 将
GPT_IMAGE_SKILL_DIR解析为包含此SKILL.md的目录。将辅助脚本作为"$GPT_IMAGE_SKILL_DIR/scripts/generate_image.py"运行,以便它能从任何项目目录正常工作。
生成
"$GPT_IMAGE_SKILL_DIR/scripts/generate_image.py" "<详细提示>" \
--aspect-ratio 3:2 \
--quality high \
--background opaque \
--format webp \
--output "<目标路径>.webp"
选项:
--aspect-ratio:1:1,16:9,9:16,3:2,2:3,auto,或显式支持的尺寸。--quality:low,medium,high,或auto。--background:auto,transparent,或opaque。透明背景需要PNG或WebP格式。--format:png,jpeg,或webp。--reference PATH:基于现有图片进行条件生成;可重复使用多次以指定多张参考图。--sprite:优化提示词以生成居中的游戏素材,并默认使用透明背景。--model:默认使用gpt-image-2;除非用户请求其他兼容模型,否则请保持此默认值。
提示与输出检查
描述对主题、构图、视角、光照、材质、调色板以及需要排除的元素。对于特色图片,明确禁止文本、字母、数字、说明文字、水印、界面标签和Logo,除非它们是有意包含的。
在每次使用前,请以全尺寸检查生成的图像。检查请求的尺寸和格式、主题相关性、裁剪安全性、畸变对象、意外字形、非预期的品牌元素以及任何与参考图的不匹配。仅当发现具体可见缺陷时才重新生成,并通过修改提示词来修正该缺陷,而非重复相同的请求。
辅助工具会创建缺失的输出目录。它不会自动打开生成的图像文件。