前言¶

在 Cursor、Claude Code 等环境里做配图，常见做法是手写 curl 调 Images API，再自己处理 base64、落盘和校验。prompt 往往只有用户原话，尺寸和负面约束也容易漏。下面介绍 SkillHub 社区 Skill「gpt Image 2 图片生成工具」（坐标 @user_8ba598a6/jiema-gpt-image），它把 Jiema GPT Image 服务（兼容 OpenAI Images API）接到 Agent 工作流里，并约定从 prompt 扩展、密钥处理到保存验证的完整步骤。

这是什么¶

一句话定位：面向「需要生成新图片」任务的 Agent Skill，通过 https://gpt.justnow.uk/v1 的 /images/generations 调用模型 gpt-image-2 出图。

维护与分发：社区来源（community），发布者 user_8ba598a6，当前版本 1.0.1，分类 design-media，标签 requires_api_key=true。SkillHub 页面显示评分 100000、下载 643（以 SkillHub 公示为准）。

它解决的是：在对话里触发生图时，Agent 有统一规则去扩展 prompt、选用尺寸、保护 API key、调用接口、解码 b64_json 或下载 url，并用 file、ls -lh 等做结果验证。裁剪、压缩、改格式等纯后处理不在本 Skill 范围内，应交给图像处理工具；生成后再后处理可以接续调用。

核心功能¶

依据 Skill 包内 SKILL.md 与脚本说明，已核实能力包括：

1. 场景触发：用户要插画、海报、封面、产品视觉、概念图、社交媒体图、文章配图等「生成新图」需求时启用；也覆盖「用 gpt-image-2 生图」「调用 gpt.justnow.uk 生图接口」等表述。
2. 输入整理：从对话推断 prompt、size（默认 1024x1024）、n（默认 1）、output_dir、filename；简单需求先扩展为结构化 prompt，仅在缺失会导致明显错误时再追问。
3. Prompt 与尺寸：内置推荐尺寸表（如横版 1536x1024、竖版 1024x1536）；可参考包内 references/style-library.md、references/templates.md、references/gallery-part-1.md 等（gallery-part-2 在完整工作流说明中提及，以安装包为准）。
4. API key 安全：密钥不写进 Skill 文档或共享产物；优先环境变量 JIEMA_GPT_IMAGE_API_KEY；首次无 key 时引导至 https://gpt.justnow.uk 注册获取。
5. 生成与落盘：兼容 OpenAI 式请求体；处理 data[].b64_json 或 data[].url；多图时使用 image.png、image-2.png 等命名。
6. 失败与重试：检查 key、base URL（JIEMA_GPT_IMAGE_BASE_URL，默认 https://gpt.justnow.uk/v1）；尺寸被拒时改用常见尺寸；中文文字不准时可缩短文案或改为无字背景再后处理加字。

安装与启用¶

SkillHub 官方页面建议：按 SkillHub 安装说明 安装坐标 @user_8ba598a6/jiema-gpt-image。

1、安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装本 Skill 到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认装到 ./skills/ 可能不会被加载。

skillhub install @user_8ba598a6/jiema-gpt-image --dir <skills 目录>

常用路径（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后，按你所用客户端要求刷新或重启 Agent，使 Skill 生效。

3、配置 API key¶

在 shell 或运行环境中设置（不要把 key 写进仓库或 Skill 文件）：

export JIEMA_GPT_IMAGE_API_KEY='YOUR_KEY_HERE'

可选覆盖服务地址：

export JIEMA_GPT_IMAGE_BASE_URL='https://gpt.justnow.uk/v1'

典型用法¶

在对话里使用¶

用户提出生图需求后，Agent 按 Skill 工作流：理解用途 → 扩展 prompt → 选尺寸与保存路径 → 确认 key → 调用 API → 解码或下载 → 验证文件 → 回复路径与说明。Skill 内给出了从「帮我生成一张 AI 写作工具的宣传图」到完整横版宣传 prompt 的扩写示例，可直接对照 SKILL.md 中的「简单需求扩展」一节。

使用包内脚本（推荐）¶

Skill 建议优先使用安装目录下的 scripts/generate_image.py。将路径替换为你本机安装位置，例如 Cursor 下约为：

python3 ~/.cursor/skills/@user_8ba598a6/jiema-gpt-image/scripts/generate_image.py \
  --prompt "一张现代科技风格的 AI 写作工具宣传图，主体是智能写作界面和知识网络元素" \
  --output-dir ./generated-images \
  --filename ai-writing-promo.png \
  --size 1024x1024 \
  --n 1

脚本依赖环境变量 JIEMA_GPT_IMAGE_API_KEY（或通过 --api-key 传入，注意勿泄露）；默认模型 gpt-image-2，默认 Base URL https://gpt.justnow.uk/v1。

使用 curl 直接调用¶

与 OpenAI Images API 兼容的请求示例：

curl -sS "${JIEMA_GPT_IMAGE_BASE_URL:-https://gpt.justnow.uk/v1}/images/generations" \
  -H "Authorization: Bearer ${JIEMA_GPT_IMAGE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "...",
    "size": "1024x1024",
    "n": 1
  }'

返回含 b64_json 时需解码为 PNG；含 url 时需下载到目标路径。原始响应中的大段 base64 不宜写入日志或对外分享。

适用场景与注意¶

适合谁：需要在 Agent 会话里稳定出图、又不想每次手写 API 与落盘逻辑的开发者；已有 Jiema GPT Image 账号、能接受自备 API key 的团队。

限制与注意：

• 必须自备 API key（requires_api_key=true）；无 key 时按 Skill 引导至 https://gpt.justnow.uk 获取。
• 只负责「生成新图」，不负责裁剪、压缩、去背景等后处理。
• 画内文字准确性有限；要求高时 Skill 建议无字背景生成后再用图像工具排版。
• API 若拒绝非常规尺寸，按 Skill 建议回退到 1024x1024、1536x1024、1024x1536。
• SkillHub 统计（评分、下载量）会更新，以页面公示为准。

结尾¶

「gpt Image 2 图片生成工具」把 Jiema 的 OpenAI 兼容生图接口和一套可执行的 Agent 工作流绑在一起：prompt 扩展、密钥约束、调用、解码保存和验证都有据可依。若你经常在 IDE 里要配图或视觉稿，可以按上文安装到对应 skills 目录并配置 JIEMA_GPT_IMAGE_API_KEY 后试用。

• SkillHub 页面：https://www.skillhub.cn/skills/user_8ba598a6/jiema-gpt-image
• 安装坐标引用：https://api.skillhub.cn/user_8ba598a6/jiema-gpt-image