// 通过 GPT Image API (gpt-image-2) 生成图片。当用户提到"生成图片"、"画一张图"、"GPT 图片"、"image generation"、或需要 AI 绘图时触发此 skill。使用环境变量 $IMAGE_GEN_API_KEY 作为 API Key，调用 OpenAI 兼容的图片生成接口。
| name | gpt-image-gen |
| description | 通过 GPT Image API (gpt-image-2) 生成图片。当用户提到"生成图片"、"画一张图"、"GPT 图片"、"image generation"、或需要 AI 绘图时触发此 skill。使用环境变量 $IMAGE_GEN_API_KEY 作为 API Key，调用 OpenAI 兼容的图片生成接口。 |
通过 GPT Image API 生成高质量图片。
$IMAGE_GEN_API_KEY 和 $IMAGE_GEN_API_URL 是否已设置scripts/gen.pyexport IMAGE_GEN_API_KEY="sk-xxx" # API Key
export IMAGE_GEN_API_URL="https://your-api.example.com/v1/images/generations" # API 端点
echo $IMAGE_GEN_API_KEY | head -c 10
如果为空，提示用户设置环境变量。
运行脚本（无额外依赖，仅用 Python 标准库）：
python3 <skill-path>/gpt-image-gen/scripts/gen.py "prompt" [output_path] [size] [quality] [count]
参数说明：
prompt — 图片描述（必填）output_path — 输出文件路径，默认 /workspace/generated_image.pngsize — 图片尺寸，可选 1024x1024 / 1536x1024 / 1024x1536 / 2048x2048，默认 1024x1024quality — 质量，可选 low / medium / high，默认 highcount — 生成数量 1-10，默认 1示例：
python3 <skill-path>/gpt-image-gen/scripts/gen.py "一位年轻漂亮的中国小红书女博主，时尚穿搭，精致妆容" /workspace/out.png 1024x1536 high 1
当用户请求生成图片时：
echo $IMAGE_GEN_API_KEY | head -c 10gen.py 展示/storage/emulated/0/Download/$IMAGE_GEN_API_URL 指定，需兼容 OpenAI Images API 格式Authorization: Bearer $IMAGE_GEN_API_KEYgpt-image-2data[0].b64_json (base64 encoded PNG)1024x1024, 1536x1024 (横屏), 1024x1536 (竖屏), 2048x2048low, medium, high部分 API 网关（如 New API）会拒绝 Python urllib 的默认 User-Agent，返回 403。脚本已内置 curl/8.14.1 的 UA 头来规避此问题。如仍有兼容性问题，可修改 scripts/gen.py 中的 User-Agent 头。
| Issue | Cause & Fix |
|---|---|
IMAGE_GEN_API_KEY 未设置 | 提示用户先 export IMAGE_GEN_API_KEY=sk-xxx |
IMAGE_GEN_API_URL 未设置 | 提示用户设置 API 端点 |
| HTTP 401/403 | Key 无效或过期，或 User-Agent 被网关拒绝 |
| HTTP 429 | 频率限制，稍等重试 |
| HTTP 502/524 | 上游服务不可用或超时，稍等重试 |
| 超时 | 图片生成较慢，timeout 设 300 秒 |
| 返回非图片内容 | API 返回异常 JSON，检查 error 字段 |