GPT - image2:在 Agent 中接入 gpt-image-2 文生图与图生图

前言

在 Cursor、Claude Code 等 Agent 里做配图时,常见做法是临时写脚本或手动打开独立绘图站点:上下文要来回切换,图生图还要自己管参考图上传与参数。若希望把「按描述出图」和「按参考图改图」收进同一次对话,需要一个按 Agent Skill 规范封装、并标明依赖 API Key 的图片生成 Skill。

下面介绍 SkillHub 社区 Skill GPT - image2(坐标 @user_e942ebfc/gpt-image2-pro):基于 gpt-image-2 模型,支持文生图与图生图,页面描述为开箱即用。

这是什么

GPT - image2 是 SkillHub 上的 design-media 类社区 Skill,当前版本 v1.0.9,发布者为 user_e942ebfc,来源标注为 community。

一句话定位:在 Agent 侧提供 AI 图片生成能力,底层模型为 gpt-image-2,支持 文生图 与 图生图。Skill 标签包含 requires_api_key=true,使用前需自行准备并配置模型服务所需的 API Key(具体变量名与配置步骤以安装包内 SKILL.md 为准,本文不臆造字段名)。

官方页面:

  • SkillHub 展示页:https://www.skillhub.cn/skills/user_e942ebfc/gpt-image2-pro
  • API 入口(资料中的官方地址):https://api.skillhub.cn/user_e942ebfc/gpt-image2-pro

截至资料抓取时,页面侧统计为评分 100000、下载 34893 次(SkillHub 统计会随时间变化,以官网为准)。

核心功能

以下能力均来自 SkillHub 简介与元数据,未做扩展:

  1. 文生图:根据自然语言描述生成图片。
  2. 图生图:在已有参考图基础上,按提示进行生成或改写(具体交互方式由 Skill 内说明定义)。
  3. 模型:统一使用 gpt-image-2。
  4. 集成形态:标准 Agent Skill(SKILL.md 格式),安装到当前 Agent 的 skills 目录后,由 Agent 在合适任务中读取并执行。

安装与启用

SkillHub 官方给出的安装指引分两种:交给 AI 按文档安装,或使用 skillhub CLI。

方式一:提示词交给 AI

将下面意图发给当前 Agent(与 SkillHub 页面文案一致):

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_e942ebfc/gpt-image2-pro`。

Agent 会按 SkillHub 安装说明 检查 CLI、选择 skills 目录并执行安装。

方式二:skillhub CLI

若本机已有 skillhub,安装时必须用 --dir 指向当前 Agent 实际使用的 skills 目录,否则默认装到 ./skills/ 可能不会被识别;安装后通常需要重启或刷新 Agent。

先确认 CLI:

command -v skillhub && skillhub --version

未安装时可按 SkillHub 文档执行(完整安装示例):

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

安装本 Skill 时,将 <skills 目录> 换成你的环境路径。SkillHub 文档中常见路径包括:

环境 skills 目录(文档列举)
Cursor ~/.cursor/skills/
Claude Code ~/.claude/skills/
Codex ~/.codex/skills/ 或项目下 .agents/skills/

示例(Cursor):

skillhub install user_e942ebfc/gpt-image2-pro --dir ~/.cursor/skills/

坐标在页面上写作 @user_e942ebfc/gpt-image2-pro;CLI 搜索与安装时使用 user_e942ebfc/gpt-image2-pro 这一形式即可(与 SkillHub 第三节示例一致)。

API Key

元数据标签 requires_api_key=true 表示本 Skill 依赖外部 API。安装完成后,请打开技能目录下的 SKILL.md 及附带说明,按发布者要求配置 Key;未配置时,生成请求无法正常完成。

典型用法

公开页面未附带独立的长篇教程,可复现的流程如下。

  1. 按上一节完成安装,并配置 API Key。
  2. 重启或重新加载 Agent,确认 GPT - image2 出现在可用 Skill 列表中。
  3. 在对话中直接说明任务类型:
    - 文生图:描述画面主体、风格、构图等期望;
    - 图生图:提供参考图(或说明已有路径/附件),并写清希望保留或修改的部分。
  4. Agent 读取 SKILL.md 中的步骤调用 gpt-image-2;输出一般为生成图片或保存路径,以 Skill 内定义为准。

若需核对参数上限、尺寸、格式等细节,请以安装包内 SKILL.md 为唯一依据,本文不列出未在官方摘要中出现的接口字段。

适用场景与注意

适合谁

  • 已在 Cursor、Claude Code、Codex 等环境使用 Agent,希望把配图、改图留在同一对话里完成的开发者或创作者。
  • 已具备 gpt-image-2 对应 API 访问权限与 Key,并愿意按 Skill 文档做一次性配置的用户。

限制与注意

  • 社区来源(community):行为与维护节奏取决于发布者,升级前可在 SkillHub 查看版本 v1.0.9 是否有更新。
  • API 费用与合规:图片生成走第三方模型 API,用量与计费由 Key 所属服务决定。
  • 安装目录:务必 --dir 指向当前 Agent 的 skills 路径,避免「已安装但 Agent 不加载」。
  • 资料范围:本文功能描述仅对应 SkillHub 简介;更细的脚本、环境变量、示例命令以安装后的 SKILL.md 为准。

结尾

GPT - image2 把 gpt-image-2 的文生图、图生图能力封装成 Agent Skill,适合在 IDE 或 CLI Agent 里做轻量配图流程;记得处理 requires_api_key 并完成 skills 目录安装。

官方入口:https://www.skillhub.cn/skills/user_e942ebfc/gpt-image2-pro

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye