前言¶

在自己的项目里接入图像生成，常见两条路：一是把模型厂商的私有 SDK 和一套 prompt 参数自己封一遍，二是找一个标准协议的入口，让代码只依赖 images API 的形状，不绑定某一家实现。agnes-图像生成属于后一种。下面介绍这个 Skill 是什么、能做什么、以及目前资料里能核实到的接入信息。

这是什么¶

agnes-图像生成（坐标 @user_69c32a7b/agnes-image）是一个社区来源的 Skill，发布者为 user_69c32a7b，版本 1.0.0，分类 design-media，在 SkillHub 上的标签为 requires_api_key=true。

它解决的问题很具体：用户提出”生成图片 / AI 绘画 / 文生图 / 图生图 / 编辑图片”这类需求时，由 Skill 把这些意图映射到 Agnes Image 2.1 Flash 模型上，调用方式遵循 OpenAI 兼容的 images API。也就是说，接入方拿到的是一个协议上熟悉的接口，而不是一套需要重新学习的参数体系。

需要说明的是，SkillHub 页面显示该 Skill 来源为 community，不是官方模型方直接维护，使用前建议自行确认发布者与模型服务方的关系。

核心功能¶

以下能力均来自官方简介，未做额外推断。

1、文生图（text-to-image）：根据文本描述生成图像。
2、图生图（image-to-image / img2img）：以已有图片为起点做生成或编辑。
3、图像编辑：简介中明确列出”edit an image with AI”，属于对已有图像的修改而非重画。

模型为 Agnes Image 2.1 Flash，调用层是 OpenAI 兼容的 images API。

触发词覆盖中英文：生成图片、AI绘画、文生图、图生图、Agnes图片、agnes-image、generate image、create picture。这意味着用户在对话里用自然语言提需求即可，不需要记命令。

安装与启用¶

已抓取资料里没有给出官方安装命令、目录规范或具体配置字段，因此本节只列出能核实到的信息，不提供未经核实的命令。

1、访问地址：https://api.skillhub.cn/user_69c32a7b/agnes-image（该地址在抓取时返回失败，建议直接打开 SkillHub 页面确认）。
2、SkillHub 页面地址：https://www.skillhub.cn/skills/user_69c32a7b/agnes-image
3、凭据要求：标签 requires_api_key=true，说明调用需要 API Key，密钥的具体获取位置资料未写明，需按发布者指引确认。
4、Cursor、Codex CLI、Claude Code 等不同宿主的启用方式差异，资料中没有分别说明，这里不做推测。

如果要接入，建议先把上一节的调用协议验证通，再决定是否把这个 Skill 装进自己的环境。

典型用法¶

资料中没有官方给出的可复现调用示例，下面这个示意只依据简介里”OpenAI-compatible images API”这一描述，用于说明调用形状，具体字段名需要以实际服务返回为准。

curl -X POST https://<服务地址>/v1/images/generations \
  -H "Authorization: Bearer $AGNES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "agnes-image-2.1-flash", "prompt": "一只在雨天屋顶上的猫", "n": 1}'

这是文生图的常规形状：POST 到 images/generations，带 Bearer 令牌，prompt 传描述。图生图在这类接口里通常额外传 image 字段，具体是否支持、字段名为何，资料没有写，使用前需要向服务方确认。

适用场景与注意¶

适合的场景：

1、已经在用 OpenAI 兼容 images API 的代码库，想换一个生成后端而不改写协议层。
2、对话式应用里希望用自然语言触发图像生成或编辑，不想自己维护意图识别。
3、需要文生图与图生图共用同一个入口。

需要注意的点：

1、来源为 community，评分与下载量来自 SkillHub 页面（抓取时为 100000 分、1373 次下载、0 次安装），安装数为 0 说明实际使用者很少，稳定性需要自行验证。
2、必须提供 API Key，密钥来源和计费方式资料未说明。
3、模型名”Agnes Image 2.1 Flash”中的 Flash 一般对应较快、成本较低的档位，但在图像生成场景下画质是否满足业务要求需要实测。
4、简介同时提到 generation 和 editing，两者对提示词的要求差异较大，建议分开测试。

结尾¶

这个 Skill 的价值在于把”生成或编辑图像”这类需求收敛到一个 OpenAI 兼容的 images API 上，文生图和图生图都能覆盖，接入方不必为每个模型厂商重写一遍协议。它的短板也同样清楚：社区来源、安装量低、安装与配置信息在现有资料里不完整。适合先拿一个调用做验证，再决定是否长期依赖。

官方地址：https://api.skillhub.cn/user_69c32a7b/agnes-image
SkillHub 页面：https://www.skillhub.cn/skills/user_69c32a7b/agnes-image